| name | account-pesquisa-profunda-cliente |
| description | Pesquisa profunda de cliente para KB acionavel. PREMISSA OBRIGATORIA - dados do cliente ja na pasta (no minimo formulario de kickoff + transcricao de reuniao de vendas). Sem isso a skill nao roda. Usa esses dados pra preencher 4 prompts sequenciais pro Deep Research do Gemini (cliente+digital+regiao; produto+setor; consumidor; concorrencia). Opcional Perplexity. Nao usa Gem nem deep research no agente. Use antes de copy, conteudo, campanha ou LP. |
| area | account |
| author | guilhermelippert |
| version | 1.5.0 |
REGRA CRITICA — paths absolutos sempre
Toda operacao de filesystem (mkdir, rm, cp, mv, ls, find, Write, Edit) DEVE usar caminho absoluto comecando em /Users/... ou na raiz do repo. Nunca path relativo.
NUNCA use cd em comandos Bash. O cwd persiste entre Bash calls e cria desastres tipo clientes/X/calls/squads/squad-exemplo/clientes/X/docs/pesquisa-profunda/... (estrutura aninhada duplicada porque um cd anterior mudou o cwd e um mkdir -p posterior com path relativo herdou esse cwd).
Forma correta:
mkdir -p "/Users/.../builders-hub/squads/{squad}/clientes/{cliente}/docs/pesquisa-profunda/prompts" ✅mkdir -p "squads/{squad}/clientes/{cliente}/docs/pesquisa-profunda/prompts" ❌ (vai falhar se cwd mudou)cd ".../calls" && wc -l *.md ❌ (polui cwd da sessao)wc -l "/Users/.../calls"/*.md ✅
Antes de qualquer mkdir ou Write: se voce rodou Bash antes, valide que esta no cwd certo com pwd OU simplesmente use path absoluto (preferido). Quando em duvida, sempre absoluto.
Apos criar a estrutura, faca find <raiz-cliente> -type d e confira que nao ha pastas duplicadas aninhadas. Se aparecer .../calls/squads/... ou similar, remova e recrie com path absoluto.
/account-pesquisa-profunda-cliente
Conduza o usuario a montar Knowledge Base do cliente para gerar resultado em copy, conteudo, campanha, LP/funil e decisoes.
O agente normal nao faz deep research. Nao use Gem nem orquestrador externo. O fluxo e:
- Verificar que a pasta do cliente ja tem dados internos (gate obrigatorio).
- Ler e consolidar esses dados num resumo
[DADOS INTERNOS CONSOLIDADOS].
- Entregar quatro prompts prontos pro usuario colar no Deep Research do Gemini — uma rodada por vez, na ordem. Entre rodadas, o usuario anexa/cola o relatorio anterior junto com o proximo prompt.
- Opcional: prompt pro Perplexity com foco social/reviews (no fim).
Premissa (gate obrigatorio)
A skill so roda se a pasta do cliente ja tiver dados internos. Os prompts de Deep Research dependem desses dados pra serem especificos — sem isso, viram pesquisa generica e perdem valor.
Minimo absoluto pra rodar:
- Formulario de kickoff preenchido (brief inicial do cliente).
- Transcricao da reuniao de vendas (ou comercial/discovery — o que tiver).
Ideal (se tiver, melhor ainda): transcricoes de outras calls, proposta comercial, export de CRM, materiais que o cliente mandou (catalogo, deck, site interno), notas do gestor.
Principios
- Nao invente fatos. Separe evidencias, hipoteses e lacunas.
- Material interno (kickoff, vendas, CRM) tem prioridade sobre inferencia da web.
- Nao crie pasta de cliente aqui. Cliente inexistente →
/novo-cliente.
- Gemini Deep Research: quatro execucoes sequenciais conforme templates abaixo.
- Perplexity: complemento social com links (opcional).
- Ad libraries e scraping manual:
references/fontes-pesquisa-social.md.
Passo 1 — Identificar cliente e pasta
- Pergunte squad e nome/slug do cliente; se ambiguo, liste
squads/{squad}/clientes/ (ignore _template) e pergunte.
- Se nao existir pasta → mensagem fixa pra
/novo-cliente.
- Trabalhe em
squads/{squad}/clientes/<cliente>/docs/pesquisa-profunda/.
Estrutura a criar ou completar:
squads/{squad}/clientes/<cliente>/docs/pesquisa-profunda/
├── 00-briefing-pesquisa.md
├── 01-cliente-posicionamento-digital.md # sintese pos DR-1
├── 02-mercado-setor-modelo-negocio.md # sintese pos DR-2 (parte setor)
├── 03-produto-servico.md # sintese pos DR-2 (parte produto)
├── 04-concorrentes.md # sintese pos DR-4
├── 05-panorama-ads.md # checklist manual / pos DRs
├── 06-consumidor.md # sintese pos DR-3
├── 07-fontes-e-evidencias.md
├── prompts/
│ ├── dr-1-cliente-posicionamento-regiao.md
│ ├── dr-2-produto-setor.md
│ ├── dr-3-consumidor.md
│ └── dr-4-concorrencia.md
├── prompt-perplexity-social-opcional.md
└── bruto/
├── gemini/
│ ├── dr-01-output.md
│ ├── dr-02-output.md
│ ├── dr-03-output.md
│ └── dr-04-output.md
└── perplexity/
Se docs/ nao existir, crie.
Passo 2 — Gate de dados internos (BLOQUEANTE)
Antes de gerar qualquer prompt, faca uma varredura na pasta do cliente atras de dados internos. Lugares pra olhar:
squads/{squad}/clientes/<cliente>/calls/ — transcricoes de kickoff, vendas, comerciaissquads/{squad}/clientes/<cliente>/docs/ — formulario de kickoff, brief, propostasquads/{squad}/clientes/<cliente>/campanhas/ — material de campanha existentesquads/{squad}/clientes/<cliente>/links.md — links uteis (NotebookLM, Drive, site)- Qualquer outro arquivo na raiz do cliente
Checklist do minimo:
Se faltar qualquer um dos dois, PARE e mande a mensagem abaixo. Nao gere prompts. Nao prossiga.
Pra rodar a pesquisa profunda eu preciso, no minimo, de dois materiais ja na pasta do cliente:
- Formulario de kickoff — o brief inicial preenchido com o cliente.
- Transcricao da reuniao de vendas (ou comercial/discovery — o que voce tiver).
Sem isso os prompts de Deep Research saem genericos e a KB nao serve. Faltando: [X, Y].
Como destravar:
- Cola/salva o formulario de kickoff em
squads/{squad}/clientes/<cliente>/docs/.
- Cola/salva a transcricao em
squads/{squad}/clientes/<cliente>/calls/.
- Se tiver mais (outras calls, proposta, export CRM, deck, catalogo), joga junto — quanto mais, melhor.
Quando estiver na pasta, roda /account-pesquisa-profunda-cliente de novo.
Se tiver os dois (ou mais), prossiga. Nao roda parcialmente "com o que tem" — o gate e duro de proposito.
Passo 3 — Consolidar [DADOS INTERNOS CONSOLIDADOS]
Le tudo que achou na varredura e produz um bloco de resumo fiel com:
| Campo | Origem |
|---|
| Identidade (nome fantasia, razao, cidade/UF, abrangencia) | Kickoff + vendas |
| Digital (site, IG, TikTok, YouTube, LinkedIn, GMN, marketplaces) | Kickoff + links.md |
| Oferta (produtos/servicos, pacotes, B2B/B2C, ticket/faixa) | Kickoff + vendas |
| Mercado (concorrentes citados, restricoes — verba, compliance, canais) | Vendas + kickoff |
| Dores/objetivos do cliente (o que ele quer destravar) | Vendas |
| Historico (tentativas anteriores, o que funcionou/falhou) | Vendas |
| Citacoes literais relevantes do cliente | Transcricao (entre aspas) |
| Objetivo da KB (copy / campanha / LP / diagnostico) | Pergunta direta se nao tiver |
Salve esse resumo em 00-briefing-pesquisa.md — vira a fonte unica que vai dentro de cada prompt como <<<DADOS INTERNOS CONSOLIDADOS>>>.
Se o cliente afirmou algo critico mas duvidoso na call, marque VALIDAR. Se uma area ficou vazia mesmo com kickoff+vendas, marque LACUNA — entra como pergunta pro DR.
Passo 4 — Entregar os prompts AO USUARIO (no chat E em arquivo)
REGRA: os 4 prompts do Gemini + o prompt do Perplexity tem que aparecer direto na conversa, dentro de blocos code copiaveis, com o <<<DADOS INTERNOS CONSOLIDADOS>>> ja substituido pelo bloco real do Passo 3. Salvar nos arquivos NAO basta — o usuario precisa copiar e colar no Gemini sem abrir nada.
Como entregar:
- Imprime os 5 prompts no chat, um abaixo do outro, cada um num bloco ```text fechado, na ordem DR-1 → DR-2 → DR-3 → DR-4 → Perplexity.
- Antes de cada bloco, uma linha curta dizendo o que e e onde salvar o output bruto (ex: "DR-1 — cole no Gemini Deep Research, salve a saida em
bruto/gemini/dr-01-output.md").
- Em paralelo, salva o mesmo conteudo nos arquivos
prompts/dr-N-*.md e prompt-perplexity-social-opcional.md (com path absoluto).
- Fecha com a instrucao operacional:
Rode quatro Deep Researches no Gemini, um de cada vez, na ordem acima. Em cada rodada apos a primeira, anexe ou cole o relatorio da rodada anterior no contexto do Deep Research junto com o novo prompt. Salve cada saida em bruto/gemini/dr-0N-output.md. Opcional no fim: rode o prompt do Perplexity.
Nao resumir os prompts no chat. O bloco copiavel e o entregavel — se voce truncar, o usuario tem que abrir arquivo, e o ponto da skill e zero atrito.
Templates dos 4 prompts (entregar SEMPRE preenchidos com [DADOS INTERNOS CONSOLIDADOS])
O agente deve substituir o placeholder <<<DADOS INTERNOS CONSOLIDADOS>>> pelo bloco real consolidado no Passo 3. Em DR-2+, deixe espaco pro usuario colar <<<OUTPUT DR-ANTERIOR OU RESUMO>>> quando rodar.
DR-1 — Cliente, posicionamento digital e regiao
Salvar como prompts/dr-1-cliente-posicionamento-regiao.md. Objetivo: entender o cliente; mapear tudo que der pra achar e inferir do posicionamento digital (fato vs inferencia); regiao de atuacao (Brasil, estadual, local, multi-regiao) e pormenores uteis do territorio pra marketing (com fonte ou como inferencia explicita).
Deep Research — Rodada 1 de 4: Cliente, presenca digital e regiao de atuacao.
DADOS INTERNOS (nao contradizer sem apontar inconsistencia):
<<<DADOS INTERNOS CONSOLIDADOS>>>
TAREFA:
1) Quem e o cliente e o que parece vender (cruzar digital + dados internos).
2) Posicionamento digital: site, redes, SEO aparente, tom, promessas, provas sociais, gaps.
3) Separar rigorosamente: FATO (fonte publica ou dado interno) / INFERENCIA / HIPOTESE / LACUNA.
4) Regiao de atuacao: escala (Brasil vs regional vs local); evidencias; nuances do territorio **uteis para marketing** (economia, consumo, concorrencia local quando houver fonte — evitar cliches sem fonte).
5) Perguntas obrigatorias para validar com o cliente.
6) Riscos: homonimia de marca, dados desatualizados.
REGRAS: Portugues BR; cite links; nao invente faturamento, precos internos nem performance de anuncios.
DR-2 — Produto, oferta e como funciona o setor
Salvar como prompts/dr-2-produto-setor.md. Incluir contexto da DR-1 (usuario cola output ou resumo).
Deep Research — Rodada 2 de 4: Produtos/servicos e dinamica do setor.
CONTEXTO DA RODADA 1 (cole aqui o relatorio completo ou resumo fiel):
<<<OUTPUT DR-1 OU RESUMO>>>
DADOS INTERNOS (repetir o essencial):
<<<DADOS INTERNOS CONSOLIDADOS>>>
TAREFA:
1) Detalhar produtos/servicos que o cliente oferece.
2) Como o SETOR funciona: modelo de negocio tipico, fontes de receita, recorrencia, sazonalidade.
3) O que **normalmente** da margem vs volume no setor (separar padrao de mercado vs especulacao sobre ESTE cliente).
4) Como empresas desse tipo **costumam vender** (canais, bundles, argumentos, servicos anexos).
5) Indicadores e linguagem do ramo.
6) Lacunas so o dono fecha.
REGRAS: PT-BR; separar "padrao do setor" vs "esta marca"; FATO/INFERENCIA/LACUNA; links.
DR-3 — Consumidor (foco total na demanda)
Deep Research — Rodada 3 de 4: Consumidor — panorama completo.
CONTEXTO DAS RODADAS 1 E 2 (cole resumos ou relatorios):
<<<OUTPUT DR-1 E DR-2 OU RESUMOS>>>
DADOS INTERNOS:
<<<DADOS INTERNOS CONSOLIDADOS>>>
TAREFA (prioridade maxima = quem COMPRA):
1) Segmentos, gatilhos de compra, contexto.
2) O que querem; como falam (aspas so com citacao real; senao SINTETIZADO).
3) Reclamacoes, medos, friccoes (com fontes quando possivel).
4) Criterios de escolha e alternativas.
5) Confianca vs rejeicao na categoria.
6) Mapa acionavel de dores/desejos para copy e criativo.
7) Lacunas de voz do consumidor online.
REGRAS: PT-BR; nao confundir persona inventada com evidencia.
DR-4 — Concorrencia
Deep Research — Rodada 4 de 4: Panorama competitivo geral.
CONTEXTO DAS RODADAS ANTERIORES (cole resumos ou relatorios 1–3):
<<<OUTPUT DR-1 A DR-3 OU RESUMOS>>>
DADOS INTERNOS (incluir concorrentes citados pelo cliente):
<<<DADOS INTERNOS CONSOLIDADOS>>>
TAREFA:
1) Concorrentes diretos, indiretos, substitutos relevantes (regiao do cliente; declarar limite se regiao incerta).
2) Promessas, posicionamento, precos publicos quando houver fonte.
3) Presenca digital comparativa (sem afirmar ROAS/CPA).
4) Gaps e oportunidades.
5) O que validar com o cliente sobre concorrencia.
REGRAS: PT-BR; links; FATO/INFERENCIA/LACUNA; homonimia.
Opcional — Perplexity (busca social)
Salvar prompt-perplexity-social-opcional.md e dizer ao usuario que e recomendado depois da DR-3 ou DR-4 pra cruzar reviews/comentarios com links.
Pesquisa com FONTES e LINKS — foco em voz social do consumidor.
Marca/categoria: [NOME / CATEGORIA]
Regiao: [REGIAO ou Brasil]
Concorrentes: [LISTA ou LACUNA]
Quero: reviews, RA, comentarios, foruns em PT-BR; padroes de elogio/raiva; citacoes reais entre aspas ou FRASE SINTETIZADA; hesitacoes ("quase comprei"); concorrentes citados por usuarios; LACUNAS.
Separe FATO COM LINK vs INFERENCIA. Nao invente citacoes.
Apos os quatro DRs — sintese nos markdowns
Quando o usuario voltar com outputs, ajude a distribuir:
| Output | Arquivo de sintese sugerido |
|---|
| DR-1 | 01-cliente-posicionamento-digital.md (+ trechos de regiao se quiser no briefing) |
| DR-2 | 02-mercado-setor-modelo-negocio.md e 03-produto-servico.md |
| DR-3 | 06-consumidor.md |
| DR-4 | 04-concorrentes.md |
| Perplexity | 06-consumidor.md (complemento) e 07-fontes-e-evidencias.md |
Preencha 07-fontes-e-evidencias.md com links, data, ferramenta, fato vs inferencia vs validar com cliente.
Panorama de ads (05): nao exige novo DR; checklist em references/fontes-pesquisa-social.md (Meta Ad Library, Google Transparency, TikTok Creative Center) — observacao vs inferencia; sem performance sem dado.
Consumidor sintetico
Isso nao e pesquisa real final; e hipotese para testar copy. Basear sempre em evidencias dos DRs.
Fechamento
Entregue ao usuario, na conversa, nesta ordem:
- Os 5 prompts em blocos
code copiaveis (DR-1, DR-2, DR-3, DR-4, Perplexity), preenchidos com os dados internos reais — ver Passo 4. Isso e obrigatorio: o usuario precisa colar no Gemini sem abrir arquivo.
- Link pro
00-briefing-pesquisa.md atualizado com o [DADOS INTERNOS CONSOLIDADOS].
- Link pros 4 arquivos em
prompts/ e pro prompt-perplexity-social-opcional.md salvos.
- Onde salvar cada output bruto (
bruto/gemini/dr-0N-output.md, bruto/perplexity/).
- Lacunas criticas pro cliente validar.
Nao entregue plano de campanha final aqui — isso vem depois da KB consolidada.
