🔍 Plan mode read-only
Teammate inicia em plan mode (sem write tools), pesquisa, monta o plano e só depois passa para execução. Reduz drasticamente 'agente fez merda no caminho errado'.
📌 O que muda em plan mode
Escrita desativada por construção.
- •Read, Glob, Grep funcionam
- •Edit, Write, Bash bloqueados
- •Plano em formato estruturado
- •Sai automaticamente após aprovação
💡 Padrão para tarefas críticas
Migração de DB, refactor grande, mudança de arquitetura — sempre em plan mode obrigatório.
📤 Enviar plano ao lead
Teammate envia plano formalmente para o lead via approval request. Lead pode aprovar ou rejeitar com feedback. Rejeitado = volta para plan mode.
Pesquisa
Read-only
Teammate explora o código relevante
Plano
Estruturado
Lista passos concretos com paths
Approval request
Para o lead
Mensagem formal pedindo OK
Decisão
Aprovado ou rejeitado com feedback
Loop até OK ou abort
Execução
Write tools liberadas
Implementa o plano aprovado
📏 Critérios para o lead aprovar
'Só aprove se o plano cobre testes; rejeite se mexe em schema'. Critérios viram texto no prompt do lead. Sem critérios, o lead aprova quase tudo.
📌 Critérios típicos
Cole no prompt do spawn do lead.
- •Cobertura de testes obrigatória
- •Sem migração de DB sem flag
- •Sem novos endpoints públicos
- •Mudanças em < X linhas
- •Documentação atualizada
⚠️ Sem critério, sem portão
Aprovação vira carimbo. Defina critério antes de delegar a aprovação ao lead.
🔁 Ciclo de revisão
Quando rejeitado, teammate fica em plan mode, revisa com base no feedback e resubmete. É o equivalente a 'PR review' — só que no spawn.
✓ Loop saudável
- ✓Feedback específico
- ✓1-2 ciclos de revisão
- ✓Ajustes incrementais
- ✓Critério estável
✗ Loop ruim
- ✗Feedback vago ('melhore')
- ✗> 3 ciclos sem convergir
- ✗Critério muda a cada round
- ✗Lead aprova por cansaço
👤 Você como aprovador
Em tarefas críticas, peça que todo plano passe pelo humano antes da execução. No início, é o melhor jeito de calibrar critérios.
💡 Estratégia de calibração
Aprove manualmente os primeiros 5-10 planos. Capture os critérios que você usou. Cole no prompt do lead. Delegue.
📌 Quando manter aprovação humana
Casos onde lead não tem alçada.
- •Mudanças em produção
- •Tools com efeito externo (email, slack)
- •Migração de DB
- •Quando o time é novo (calibração)
🧪 Lab: aprovador autônomo
Spawn de 'architect' em plan mode obrigatório, com 3 critérios de aprovação no prompt do lead. Ver o ciclo completo te dá confiança para operar sem aprovador humano.
📊 Lab spec
- Tarefa: refactor do módulo de auth
- Teammate: architect (Opus)
- Plan mode: obrigatório
- Critério 1: testes cobertos
- Critério 2: sem schema change
- Critério 3: backwards compat
📌 Resumo do Módulo
Próximo módulo:
3.4 — Hooks como quality gates