🎯 Bloco 1: Goal
Frase única que descreve o objetivo final do time, não o passo-a-passo. Teammates acordam sem contexto; o Goal dá norte para decisões locais.
📌 Goal eficiente vs ineficiente
Goal observável tem critério de aceite embutido.
- •✓ 'app rodando em localhost:3000 com login'
- •✗ 'fazer um app legal'
- •✓ 'pull request mergeable até sexta'
- •✗ 'ajude com o projeto'
💡 Regra de ouro
Se você não sabe quando o time terminou só lendo o Goal, ele está vago demais.
👥 Bloco 2: Team (N + modelo)
Especifique quantos teammates e qual modelo padrão. Sem N explícito o lead chuta. Sem modelo, default herda do lead — pode ser caro demais.
📊 Mix de modelos por papel
- Tech Writer / docs → Haiku
- Dev padrão → Sonnet
- Architect / decisão → Opus
- QA simples → Haiku, complexo → Sonnet
📌 Nomeando o time
Nome próprio facilita auditoria e resume.
- •✓ 'Create a team called Neuroflow with 3 teammates'
- •✓ 'Spawn the backend_review squad'
- •✗ 'Crie uns agentes'
🎭 Bloco 3: Roles
Cada role tem 3 campos no prompt: o que faz, o que entrega, e para quem manda mensagem ao terminar. Sem destinatário explícito, todos voltam ao lead.
📌 Template de role
Estrutura repetível.
- •Papel: Backend Dev
- •Faz: API REST em src/api/
- •Entrega: rotas /users e /posts funcionando
- •Quando termina: mande contrato para Frontend Dev
⚠️ Erro comum
Esquecer o 'destinatário'. Sem ele, todos retornam ao lead, eliminando vantagem do mailbox.
📦 Bloco 4: Final deliverables
Lista explícita de artefatos: app rodando, tests/report.md, docs/build-summary.md. Sem isso, time pode encerrar com trabalho parcial.
📌 Deliverables observáveis
Path + formato + critério de aceite.
- •✓
tests/report.mdcom lista pass/fail - •✓ App acessível em localhost:3000 sem erros
- •✓
docs/build-summary.mdcom decisões - •✗ 'um relatório do trabalho'
💡 Executável > documentação
Sempre inclua um deliverable que possa ser rodado ou aberto, não só lido.
📐 Templates reutilizáveis
Mantenha prompts versionados em prompts/. Times bem desenhados são reutilizáveis. Salvar bons prompts vale ouro — escala para o time todo.
📌 Estrutura de prompts/
Catalog de spawns por situação.
- •
prompts/spawn-fullstack.md - •
prompts/spawn-pr-review.md - •
prompts/spawn-debug-hypothesis.md - •
prompts/spawn-incident-response.md
💡 Versionamento
Cada prompt tem changelog próprio. Pequenas mudanças trazem ganho ou regressão — saiba qual.
🧪 Refactor: vago → cirúrgico
Lab: pegue um prompt vago e transforme em prompt de 4 blocos com roles e deliverables claros. Treina o olho — depois você corrige no automático.
✓ Versão cirúrgica
- ✓Goal observável
- ✓N e modelo definidos
- ✓Cada role tem destinatário
- ✓Deliverables com path
✗ Versão vaga
- ✗'Faça uma equipe pra ajudar'
- ✗'uns agentes'
- ✗'alguém revisa no final'
- ✗'me dê o resultado'
📌 Resumo do Módulo
Próximo módulo:
2.3 — Faça vs Não Faça