/cs-customer-research

name: cs-customer-research
description: Pesquisa multi-fonte sobre pergunta ou tópico de cliente com atribuição de fontes. Use quando um cliente pergunta algo que precisa ser verificado, investigando se um bug foi reportado antes, verificando o que foi dito anteriormente a uma conta específica, ou coletando contexto antes de redigir uma resposta. / Multi-source research on a customer question or topic with source attribution. Use when a customer asks something you need to look up, investigating whether a bug has been reported before, checking what was previously told to a specific account, or gathering background before drafting a response.
argument-hint: "<pergunta ou tópico>"

/cs-customer-research

> Se encontrar integrações não configuradas, verifique [CONNECTORS.md](../../CONNECTORS.md).

Pesquisa multi-fonte sobre uma pergunta de cliente, tópico de produto ou consulta relacionada à conta. Sintetiza achados de todas as fontes disponíveis com atribuição clara e pontuação de confiança.

Usage

/cs-customer-research <pergunta ou tópico>

Workflow

1. Parse da Solicitação de Pesquisa

Identificar que tipo de pesquisa é necessária:

• **Pergunta do cliente**: Algo que um cliente perguntou que precisa de resposta (ex: "Nosso produto suporta SSO com Okta?")
• **Investigação de problema**: Background sobre um problema reportado (ex: "Esse bug foi reportado antes? Qual é o workaround conhecido?")
• **Contexto de conta**: Histórico com um cliente específico (ex: "O que dissemos à Acme Corp da última vez que perguntaram sobre isso?")
• **Pesquisa de tópico**: Tópico geral relevante para trabalho de suporte (ex: "Boas práticas para lógica de retry de webhook")

Antes de buscar, esclarecer o que realmente precisa ser encontrado:

• É uma pergunta factual com resposta definitiva?
• É uma pergunta contextual que requer múltiplas perspectivas?
• É uma pergunta exploratória onde o escopo ainda está sendo definido?
• Quem é o público para a resposta (time interno, cliente, liderança)?

2. Buscar nas Fontes Disponíveis

Buscar sistematicamente pelos níveis de fonte abaixo, adaptando ao que está conectado. Não parar no primeiro resultado — cruzar referências entre fontes.

**Tier 1 — Fontes Internas Oficiais (maior confiança):**

• **Notion MCP**: docs de produto, runbooks, FAQs, documentos de política
• Roadmap de produto (interno): timelines de features, prioridades

**Tier 2 — Contexto Organizacional:**

• **int-evo-crm** (`/int-evo-crm`): notas de conta, histórico de atividades, respostas anteriores, detalhes de oportunidade
• **int-evo-crm** (tickets): resoluções anteriores, problemas conhecidos, workarounds
• Notas de reuniões: discussões, decisões, compromissos anteriores

**Tier 3 — Comunicações do Time:**

• **discord-get-messages** (`/discord-get-messages`): buscar o tópico em canais relevantes; verificar se membros do time discutiram ou responderam isso antes
• **int-whatsapp** (`/int-whatsapp`): buscar discussões sobre o tópico em grupos relevantes
• **Gmail MCP**: buscar correspondência anterior sobre esse tópico

**Tier 4 — Fontes Externas:**

• Busca na web: documentação oficial, posts de blog, fóruns da comunidade
• Bases de conhecimento públicas, help centers, release notes
• Documentação de terceiros: parceiros de integração, ferramentas complementares

**Tier 5 — Inferido ou Analógico (usar quando fontes diretas não trazem respostas):**

• Situações similares: como perguntas similares foram tratadas antes
• Clientes análogos: o que funcionou para contas comparáveis
• Boas práticas gerais: padrões e normas da indústria

3. Sintetizar Achados

Compilar resultados em um briefing de pesquisa estruturado:

## Pesquisa: [Pergunta/Tópico]

### Resposta
[Resposta clara e direta à pergunta — começar com a conclusão]

**Confiança:** [Alta / Média / Baixa]
[Explicar o que determina o nível de confiança]

### Achados Chave

**De [Fonte 1]:**
- [Achado com detalhe específico]
- [Achado com detalhe específico]

**De [Fonte 2]:**
- [Achado com detalhe específico]

### Contexto e Nuances
[Ressalvas, casos extremos, ou contexto adicional que importa]

### Fontes
1. [Nome/link da fonte] — [o que contribuiu]
2. [Nome/link da fonte] — [o que contribuiu]
3. [Nome/link da fonte] — [o que contribuiu]

### Lacunas e Incógnitas
- [O que não pôde ser confirmado]
- [O que pode precisar de verificação por um especialista]

### Próximos Passos Recomendados
- [Ação se a resposta precisa ir para um cliente]
- [Ação se pesquisa adicional é necessária]
- [Quem consultar para verificação se necessário]

4. Lidar com Fontes Insuficientes

Se nenhuma fonte conectada traz resultados:

• Realizar pesquisa na web sobre o tópico
• Pedir ao usuário por contexto interno:
• "Não encontrei isso nas fontes conectadas. Você tem docs internos ou artigos da base de conhecimento sobre isso?"
• "O time discutiu esse tópico antes? Há canais do Discord que eu deveria verificar?"
• "Há um especialista no assunto que saberia a resposta?"
• Ser transparente sobre as limitações:
• "Esta resposta é baseada apenas em pesquisa na web — verifique com sua documentação interna antes de compartilhar com o cliente."
• "Encontrei uma possível resposta mas não pude confirmar de uma fonte interna autorizada."

5. Considerações para o Cliente

Se a pesquisa é para responder uma pergunta do cliente:

• Sinalizar se a resposta envolve roadmap de produto, preços, legal ou tópicos de segurança que podem precisar de revisão
• Anotar se a resposta difere do que pode ter sido comunicado anteriormente
• Sugerir ressalvas apropriadas para a resposta voltada ao cliente
• Oferecer para redigir a resposta ao cliente: "Quer que eu redija uma resposta para o cliente com base nesses achados?"

6. Captura de Conhecimento

Após a pesquisa ser concluída, sugerir capturar o conhecimento:

• "Devo salvar esses achados no Notion para referência futura?"
• "Quer que eu crie uma entrada de FAQ com base nessa pesqui