| name | account-handoff |
| description | Primeira skill que o account roda quando recebe um cliente novo de vendas. Le form de kickoff + transcript da reuniao de vendas (+ proposta comercial opcional) e gera a primeira versao da KB do cliente: resumo de vendas, form estruturado, perguntas pro kickoff, promessas e riscos, CLAUDE.md/AGENTS.md preliminares, Mission Control preliminar e um deck HTML interativo com modo Account/Cliente pra conduzir a reuniao de kickoff. Use quando o usuario rodar /account-handoff, disser que recebeu um cliente novo de vendas, ou que precisa transformar form+reuniao de vendas em KB pra preparar a primeira reuniao da operacao. |
| area | account |
| author | guilhermelippert |
| version | 1.0.0 |
/account-handoff
Transforme form de kickoff + transcript da reuniao de vendas na primeira versao da Knowledge Base e do Mission Control de um cliente que acabou de sair de vendas. O entregavel estrela e um deck HTML interativo com dois modos:
- Modo Account (default) — account abre antes da reuniao, ve toda a analise interna (chips de factibilidade + alertas internos com red flags).
- Modo Cliente — account aperta antes de compartilhar tela. Esconde analise interna. Cliente so ve linguagem diplomatica e neutra.
Diferente de /contexto (continua, atualiza KB ao longo da operacao), /account-handoff e a primeira skill que roda na transicao vendas → operacao. Diferente de /account-pesquisa-profunda-cliente (pesquisa externa via Deep Research), /account-handoff consome material interno (form, reuniao, proposta).
Posicionamento no fluxo
/novo-cliente — cria a pasta (pre-requisito)./account-handoff — esta skill (consome inputs de vendas)./account-pesquisa-profunda-cliente — sugerida no fim (pesquisa externa).- Reuniao de kickoff com o cliente (account abre o deck HTML em modo Cliente, marca confirmado/ajustar/lacuna ao vivo).
/contexto — consolida tudo (incluindo o JSON exportado do deck) num CLAUDE.md/AGENTS.md final e atualiza mission-control/.
Principios
- Nao inventar fatos. Separar EVIDENCIA (do form/transcript/proposta) vs INFERENCIA vs LACUNA.
- Material interno tem prioridade absoluta sobre suposicao.
- Roda com o que tem. Lacuna nao bloqueia — vira pergunta no
03-perguntas-kickoff.md e item ❓ no deck.
- Nao criar pasta de cliente aqui. Cliente inexistente → manda pra
/novo-cliente e para.
- Nao transcrever audio. Se vier so link de gravacao, oriente o usuario a rodar Read.ai/Fireflies primeiro.
- Linguagem cliente-facing por padrao. O deck vai ser compartilhado com o cliente — analise critica fica em
alertaInterno (so visivel em Modo Account) e nos markdowns internos.
- Portugues brasileiro em tudo.
Passo 1 — Identificar e validar a pasta do cliente
- Pergunte qual o cliente (ou detecte da pasta corrente, se ja estiver dentro de
squads/{squad}/clientes/{cliente}/).
- Se a pasta nao existir, pare e mande:
"Cliente ainda nao existe. Roda /novo-cliente primeiro pra criar a pasta dentro do squad. Depois volta aqui."
- Trabalhe em
squads/{squad}/clientes/{cliente}/docs/handoff/. Crie docs/handoff/inputs/ se nao existir.
Passo 2 — Coletar inputs
Verifique o que ja tem em docs/handoff/inputs/:
ls "squads/{squad}/clientes/{cliente}/docs/handoff/inputs/" 2>/dev/null
Se a pasta tem arquivos, liste o que encontrou e pergunte se pode prosseguir.
Se a pasta esta vazia, peca (uma vez, em bloco):
Joga em docs/handoff/inputs/:
- Form de kickoff em markdown (exportado do Google Forms ou similar). Esperado.
- Transcript da reuniao de vendas em markdown (Anotacoes do Gemini, Read.ai, Otter, Fireflies, etc). Esperado.
- Proposta comercial (PDF, markdown, qualquer formato). Opcional — se nao tiver, sigo sem.
Se voce so tem link de gravacao (Drive/Meet) sem transcript, roda no Read.ai ou Fireflies antes — eu nao transcrevo audio.
Aperta enter quando os arquivos estiverem la.
Filosofia: se vier so um dos dois (form OU transcript), prossiga mesmo assim. Cada lacuna vira pergunta a mais no kickoff. Nao trave.
Passo 3 — Ler todos os inputs por completo
Leia todos os arquivos em docs/handoff/inputs/ integralmente. Nao pule. Para cada arquivo, identifique:
- O que e (form? transcript? proposta?)
- Quem disse o que (no transcript: vendedor V4 vs cliente)
- Datas, valores, prazos, KPIs mencionados
- Links uteis (Drive de vendas, gravacao, deck da proposta, site, redes do cliente)
- Inconsistencias entre fontes (form diz X, reuniao diz Y) — viram alertas internos
Passo 4 — Gerar os 4 markdowns em docs/handoff/
Em todos os markdowns: marque cada afirmacao como EVIDENCIA (cita fonte: form/transcript/proposta + trecho), INFERENCIA (deduzido do conjunto), ou LACUNA (nao tem).
00-resumo-vendas.md — Resumo executivo
Estrutura: o que foi vendido (servico, escopo, prazo, valor, inicio), contatos do cliente, expectativas em ordem de prioridade, time V4 envolvido, dados da reuniao de vendas.
02-form-kickoff.md — Form estruturado
Reorganize o form bruto em secoes claras: identidade, oferta, mercado, digital, objetivo de marketing, KPIs, restricoes, preferencias. Mantenha respostas literais entre aspas quando o cliente respondeu algo importante. Marque campos vazios como LACUNA.
(Pulo dos numeros 01 e 05: reservados pra possivel expansao.)
03-perguntas-kickoff.md — Perguntas pro kickoff
A lista que o account vai usar pra conduzir a primeira reuniao com o cliente. Tres categorias:
# Perguntas pro kickoff
## 1. Confirmar (validar com o cliente o que vendas anotou)
- [ ] Confirmar que escopo combinado foi [X].
- [ ] Confirmar contato principal e [Nome].
## 2. Aprofundar (informacao parcial nos inputs)
- [ ] Qual o ticket medio real do produto X? (form diz "varia").
## 3. Cobrir lacunas (dados que nao apareceram em lugar nenhum)
- [ ] Qual o budget mensal de midia disponivel? (LACUNA total).
- [ ] Tem conta de Meta/Google Ads ja criada? Acesso?
- [ ] Quem aprova criativo final?
04-promessas-e-riscos.md — Promessas de vendas e analise de risco
Esta e a parte mais importante. Liste cada promessa que vendas fez (escopo, prazo, KPI, entrega) e classifique:
# Promessas de vendas e riscos
## Promessas explicitas (o que cliente espera)
| # | Promessa | Fonte | Factibilidade | Justificativa |
|---|----------|-------|---------------|---------------|
| 1 | "Vamos entregar 50 leads/mes em 30 dias" | Reuniao 12:34 | 🟡 Otimista | Setor X tipicamente faz CPL R$80; com R$3k/mes da 37 leads, nao 50 |
| 2 | LP no ar em 2 semanas | Form | 🟢 Factivel | Escopo simples, sem integracao |
| 3 | ROAS 4 garantido | Reuniao 28:10 | 🔴 Perigoso | Setor faz ROAS 2-3 medio; cliente nunca rodou antes |
## KPIs prometidos
- [Lista do que vendas falou que ia entregar]
## Red flags
- [Coisas que vao virar problema]
## Compromissos da V4 (alem do escopo)
- [Coisas que vendas falou que faria fora do contrato]
Padroes de factibilidade: 🟢 Factivel · 🟡 Otimista (precisa validar) · 🔴 Perigoso (alta chance de bola fora).
Passo 5 — Popular CLAUDE.md e AGENTS.md preliminares
Na raiz da pasta do cliente, escreva CLAUDE.md e AGENTS.md com o mesmo conteudo preliminar. Marque claramente que e preliminar:
# [Nome do Cliente] (KB preliminar pos-handoff)
> ⚠️ **Esta KB e preliminar.** Foi gerada por `/account-handoff` antes do kickoff com o cliente. Apos a primeira reuniao, rode `/contexto` pra consolidar (vai puxar o `kickoff-resultado.json` exportado do deck).
## Recursos
Veja `links.md` na raiz pra todos os links uteis.
## Negocio (do form + reuniao de vendas)
- **Segmento:** [...]
- **Produto/Servico:** [...]
- **Publico-alvo:** [...]
- **Diferenciais:** [...]
## Operacao prevista
- **Servico vendido:** [...]
- **Investimento:** [...]
- **KPIs combinados:** [veja `04-promessas-e-riscos.md` pra detalhe e factibilidade]
## Relacionamento
- **Contatos do cliente:** [...]
- **Time V4:** [...]
- **Combinados:** [veja `00-resumo-vendas.md`]
## Pendencias pro kickoff
Veja `03-perguntas-kickoff.md` — sao [N] perguntas pra fazer ao cliente na primeira reuniao.
## Riscos identificados no handoff
[Lista breve dos red flags do `04-promessas-e-riscos.md`]
## Quando trabalhar com este cliente
- Le `links.md` antes de qualquer coisa.
- Antes do kickoff, rode tambem `/account-pesquisa-profunda-cliente` pra ter pesquisa externa.
- Apos o kickoff com o cliente, rode `/contexto` pra atualizar esta KB.
Passo 6 — Criar mission-control/ preliminar
Crie mission-control/ na raiz do cliente com os arquivos abaixo. E a primeira versao do estado vivo da conta, antes do kickoff.
mission-control/
|-- okr-quarter.md
|-- apostas-vivas.md
|-- combinados.md
|-- personas-call.md
|-- historico-checkins.md
`-- historico-preparacoes.md
okr-quarter.md
Extraia dos inputs qualquer objetivo/KPI vendido ou esperado. Se ainda nao houver OKR real, marque como preliminar:
# OKRs do Quarter
> Status: preliminar pos-handoff. Confirmar no kickoff e consolidar via `/contexto`.
## Objetivo
[EVIDENCIA/INFERENCIA/LACUNA]
## Key Results
- [ ] KR 1 - [fonte ou LACUNA]
## A confirmar no kickoff
- [...]
apostas-vivas.md
Crie 1 a 3 apostas iniciais, sempre marcadas como preliminares. Se nao houver informacao suficiente, deixe a tabela vazia com lacunas claras.
| Aposta (o que cremos) | Por que apostamos | Como mata (sinal + prazo) | Plano B se morrer |
|---|---|---|---|
| [INFERIDO - confirmar no kickoff] ... | ... | [A CONFIRMAR] | [A CONFIRMAR] |
combinados.md
Registre promessas de vendas e pendencias do kickoff como combinados preliminares:
# Combinados
## Pendentes para kickoff
- [ ] Account confirmar {ponto} no kickoff [fonte]
## Feitos
- [x] Handoff de vendas processado em {data}
personas-call.md
Crie perfis iniciais dos stakeholders citados na venda. Use arquétipos com baixa confianca se ainda nao houver check-in:
# Personas das Calls
> Preliminar pos-handoff. Refinar com `account-checkin-review` apos calls reais.
## {Nome} - {papel}
- **Arquétipo inicial:** [decisor agressivo / operacional cetico / estrategista / passivo] [INFERIDO]
- **Voz:** [A CONFIRMAR]
- **Gatilhos:** [...]
historico-checkins.md
Crie vazio, deixando claro que so recebe calls reais:
# Histórico de Check-ins e Calls
> Apenas calls reais/transcripts. Preparacoes ficam em `historico-preparacoes.md`.
historico-preparacoes.md
Registre a preparacao inicial:
# Histórico de Preparações de Check-in
## {YYYY-MM-DD} - handoff inicial
**Resumo:** Mission Control preliminar criado a partir de vendas/form/proposta.
**Pontos fracos a treinar:** [lacunas principais]
Passo 7 — Atualizar links.md
Abra links.md na raiz do cliente. Adicione na secao "Outros" qualquer link que apareceu nos inputs e ainda nao esta listado:
- Gravacao da reuniao de vendas (Meet/Drive)
- Pasta de vendas no Drive
- Deck da proposta comercial
- Site/redes do cliente
- LinkedIn do contato principal
- Qualquer ferramenta que cliente mencionou usar
Passo 8 — Gerar docs/handoff/kickoff-deck.html
Este e o entregavel estrela. Single-page HTML interativo, sem CDN, com auto-save em localStorage e toggle Modo Account/Cliente.
Como gerar
- Leia o template
assets/template-kickoff.html (espelhado nesta skill).
- Substitua o conteudo do
<script id="dados-handoff" type="application/json">...</script> pelo JSON real do cliente.
- Salve o resultado em
docs/handoff/kickoff-deck.html.
Schema do JSON
{
"capa": {
"cliente": "Nome do Cliente",
"squad": "squad-x",
"account": "Nome do Account",
"dataGeracao": "2026-05-01",
"vendedor": "Nome do Vendedor"
},
"resumoVendas": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ],
"empresa": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ],
"promessas": [ { "titulo": "...", "conteudo": "...", "factibilidade": "factivel|otimista|perigoso", "alertaInterno": "..." } ],
"acessos": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ],
"combinados": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ],
"perguntas": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ],
"proximosPassos": [ { "titulo": "...", "conteudo": "...", "alertaInterno": "..." } ]
}
Cada bloco tem ate 4 campos:
titulo (obrigatorio) — frase curta, cliente-facing (vai aparecer na tela compartilhada).conteudo (obrigatorio) — explicacao do bloco, cliente-facing. Suporta negrito com **texto**.factibilidade (so na secao promessas, opcional) — "factivel", "otimista" ou "perigoso". Vira chip colorido so visivel em Modo Account.alertaInterno (opcional, so visivel em Modo Account) — analise critica, red flags, dados sensiveis. Aqui mora "RECONCILIAR numeros", "INCONSISTENCIA grave", "verba insuficiente — preparar cliente". O account ve antes da reuniao pra saber o que cobrar com diplomacia.
Regras de linguagem
Em titulo e conteudo (visiveis ao cliente):
- Primeira pessoa do plural: "vamos alinhar", "vamos confirmar", "nossa estrategia".
- Tom diplomatico: "vamos confirmar volume mensal" ❌ "RECONCILIAR numeros".
- Sem jargao interno V4: nada de "lacuna", "perigoso", "promessa de vendas".
- Sem expor erros do cliente: nao escreva "form contradiz reuniao" — vira pergunta neutra.
- Sem expor falhas internas: nao escreva "vendedor prometeu X mas escopo nao tem".
Em alertaInterno (so account ve):
- Pode ser direto e tecnico: "🔴 INCONSISTENCIA grave", "Verba insuficiente pro setor", "Forcar definicao agora".
- Inclui a razao da preocupacao + o que o account deve fazer ao chegar nesse bloco na reuniao.
Exemplo de bom contraste
{
"titulo": "Volume e faturamento",
"conteudo": "Pra dimensionar bem nossa estrategia, queria entender melhor: dos numeros que conversamos, qual e a fotografia mais real da operacao hoje?",
"alertaInterno": "🔴 Form diz R$ 150k/ano de faturamento mas 50 acoes × R$ 10k = R$ 500k/mes potencial. Pergunta diplomatica pra reconciliar sem expor o erro de preenchimento."
}
Passo 9 — Resumo final pro usuario
Mostre:
Handoff pronto. O que foi gerado em squads/{squad}/clientes/{cliente}/:
docs/handoff/
├── inputs/ (seus arquivos originais)
├── 00-resumo-vendas.md (X paragrafos)
├── 02-form-kickoff.md (N campos, X lacunas)
├── 03-perguntas-kickoff.md (N perguntas: A confirmar, B aprofundar, C cobrir lacunas)
├── 04-promessas-e-riscos.md (N promessas: X factivel, Y otimista, Z perigoso)
└── kickoff-deck.html ← ESTE e o que voce abre na reuniao
CLAUDE.md / AGENTS.md (raiz) — preliminares, serao atualizados pos-kickoff via /contexto
mission-control/ — OKRs, apostas, combinados, personas e historicos preliminares
links.md (raiz) — atualizado com [N] novos links
⚠️ Lacunas criticas que precisam virar pergunta no kickoff:
- [...]
- [...]
📊 Promessas perigosas pra atencao redobrada:
- [...]
→ Pra abrir o deck antes da reuniao:
open "squads/{squad}/clientes/{cliente}/docs/handoff/kickoff-deck.html"
⚠️ Antes de compartilhar tela com o cliente, troque pra "Modo Cliente" no botao do topo.
Em Modo Account voce ve a analise interna; em Modo Cliente ela some — fica so a linguagem
diplomatica que o cliente pode ler.
→ Antes do kickoff, considera rodar /account-pesquisa-profunda-cliente
pra chegar ainda mais preparado (pesquisa externa de mercado/concorrencia/consumidor).
Os dados internos que essa skill pede ja estao consolidados em docs/handoff/.
→ Apos o kickoff, rode /contexto pra consolidar a KB final.
Como o deck funciona na reuniao (so pra contextualizar o usuario)
- Account abre o HTML em Modo Account (default), revisa todos os blocos vendo a analise interna.
- Antes de compartilhar tela com o cliente, clica no botao "Modo: Account" no topo — ele vira "Modo: Cliente". Chips de factibilidade somem. Caixas amarelas de alerta interno somem.
- Compartilha tela. Conduz a conversa rolando pra baixo.
- Cada bloco tem 3 botoes: ✅ confirmado · ✏️ ajustar · ❓ lacuna.
- Cliques sao salvos automaticamente no localStorage do navegador (chave
handoff-{slug-cliente}).
- Botao "Ajustar" abre textarea pra anotacao livre.
- No fim da reuniao, account aperta Exportar JSON e baixa
kickoff-resultado.json.
- Esse JSON deve ser salvo em
docs/handoff/. O /contexto (ou skill futura) le ele pra consolidar a KB.
Atalhos de teclado (no deck)
1 · 2 · 3 — marca o bloco em foco como confirmado / ajustar / lacuna.e — exporta JSON.↓ (na capa) — rola pra primeira secao.
Estados visuais do bloco
- Sem acao: borda transparente, fundo branco.
- Confirmado: borda esquerda verde + tint verde no fundo + botao ✅ preenchido.
- Ajustar: borda ambar + tint ambar + botao ✏️ preenchido + textarea revelada.
- Lacuna: borda vermelha + tint vermelho + botao ❓ preenchido.
Lacunas e seguranca
- Se um input for muito grande (>50k tokens), corte por secoes relevantes mas avise o usuario.
- Nunca exponha credenciais (CNPJ, senhas, tokens). Se aparecer no input, marque como
[REDIGIDO] no markdown.
- Se a reuniao mencionar concorrentes V4 ou clientes de outros squads, ignore — nao e pra entrar na KB.
- Toda analise critica vai em
alertaInterno, nunca em conteudo. Se voce hesitar entre os dois, vai pro alerta — e mais seguro nao expor pro cliente.
