Glossário
Vocabulário do kit em pt-BR: CoS, agente, skill, task, gate, family, draft, handoff, ledger.
Vocabulário do KPA em pt-BR. Use como referência rápida quando bater dúvida de termo dentro do kit.
Conceitos
- CoS (Chief of Staff)
- Entry point único do kit. Recebe pedido, classifica task, escolhe agente, define orçamento de contexto, valida output. Você nunca chama agente direto.
- Agente
- Especialista reduzido com contrato curto: entrada, saída, gate. Não carrega prompt gigante — só o necessário pra task.
- Skill
- Capacidade específica que um agente pode usar. Tipo: gerar email, fazer headline, montar SOP, auditar pixel.
- Task
- Pedaço atômico de trabalho. Tem entrada, saída, prazo, gate. CoS cria, agente executa, ledger registra.
- Gate
- Critério de qualidade que bloqueia avanço caro quando a base está fraca. Cada task tem um gate específico.
- Family / Família operacional
- Padrão operacional compartilhado por nichos parecidos. 8 famílias cobrem 99% dos casos: serviço local, profissional liberal, B2B consultivo, ecommerce, infoproduto, agência, clínica, jurídico.
- Pipeline
- Sequência de fases pra entregar algo complexo (lançamento, projeto, campanha). Cada fase tem agente, gate e output.
- Squad adaptativo
- Grupo de agentes que se reorganiza por cliente, fase ou gargalo. Não é estrutura fixa — é dinâmica.
Operação
- Draft
- Estado inicial de todo artefato sensível (WhatsApp, automação, deploy). Precisa de revisão humana antes de virar real.
- Handoff
- Transferência explícita de tarefa entre agente e humano (ou entre agentes). Não é silêncio — é declaração: 'agora você assume'.
- Stop rule
- Critério que para a automação. Ex: 3 mensagens sem resposta = pausa. Sempre obrigatória em WhatsApp.
- Ledger
- Quadro vivo de tasks. Mostra o que está pending, in_progress, blocked, done. CoS atualiza, você consulta.
- Workspace
- Pasta com estado vivo de um projeto/cliente. Contextos, decisões, premissas, outputs em andamento.
- Preflight
- Mapeamento inicial de acessos, ferramentas, pastas e limites. Reduz interrupção em 90%.
- Auto mode
- Modo onde o kit avança sem confirmar cada passo reversível. Ação irreversível continua exigindo confirmação humana.
Stacks
- WhatsApp Stack
- Camada operacional pra WhatsApp: prospecção, SDR, CS, follow-up, onboarding, reativação, handoff humano. Tudo em draft primeiro.
- Automation Stack
- Camada pra automatizar processos. Entrega SOP + blueprint + plano de teste + plano de ativação.
- Traffic Stack
- Camada de Meta Ads via CLI nativa. 8 agentes especializados em DR. Roda direto em conta viva com Paused-First.
- Cowork
- Ferramenta de WhatsApp que recebe os fluxos gerados pelo kit. YAML importável + checklist de teste.
Tráfego
- Paused-First
- Regra inegociável: toda criação (campaign/adset/ad) inicia em PAUSED. Você valida no Gerenciador e ativa manualmente.
- EMQ (Event Match Quality)
- Métrica Meta de qualidade do match entre evento do Pixel/CAPI e usuário. Quanto mais alta, melhor o aprendizado da campanha.
- Oxigênio (lateralização)
- Estratégia de escala onde você duplica adsets vencedores em novas variações de público/criativo pra ganhar fôlego.
- Kill list
- Critério de quando matar criativo/adset/campanha. Define por CPA, ROAS, hook rate, frequência, etc.
- Scatter
- Mapa visual de criativos por performance. Identifica padrões (formato, tom, gancho) do que está vencendo.
Builder
- Forge
- Agente builder. Cria novos agentes, skills, tasks ou diretrizes seguindo padrão V30. Atualiza índices automaticamente.
- MCP
- Model Context Protocol. Conectores externos do Claude (WhatsApp, Slack, Drive, Meta, etc). Setup em 20_MCP_SETUP/.
- Composio Rube
- Plataforma de integração que conecta o kit a 1000+ apps externos (Slack, Notion, Gmail, etc) via MCP.
- .env / .env.local
- .env é template (sem secrets). .env.local é o real (gitignored). Tokens, API keys, credenciais ficam só no .local.
Modelos
- Router-cheap
- Perfil de modelo barato/rápido pra tarefas de roteamento, classificação, organização. Usado pelo CoS.
- Strategy-frontier
- Perfil de modelo top pra decisões irreversíveis: posicionamento, oferta, mecanismo, copy final.
- Reviewer-frontier
- Perfil top pra revisão crítica. Usado quando o gate de qualidade bloqueia avanço.