📋 Briefing
App full-stack: API REST (users + posts), front React, JWT, suíte de testes, relatório QA, doc operacional. Realista para exercitar todas as armadilhas; pequeno o suficiente para 4h.
📌 Deliverables obrigatórios
Critério de aceite do capstone.
- •App rodando em localhost:3000
- •tests/report.md com pass/fail
- •docs/build-summary.md com decisões
- •docs/cost-report.md com tokens por papel
- •Auth JWT funcionando
👥 Squad sugerido (5 agentes)
5 teammates Sonnet com territórios distintos: src/api, src/ui, tests/, audits/, docs/. Aplicação prática de tudo que veio antes.
📊 Squad
- Backend Dev (Sonnet) → src/api/
- Frontend Dev (Sonnet) → src/ui/
- QA Engineer (Haiku) → tests/
- Security Reviewer (subagent definition, Sonnet) → audits/
- Tech Writer (Haiku) → docs/
💡 Mix de modelos
QA e Tech Writer em Haiku; resto Sonnet. Reduz custo sem perder qualidade.
📐 Rubrica de avaliação
Critérios objetivos forçam você a aplicar conceitos do curso, não só 'fazer rodar'.
📊 Pontos
- 25 — prompt segue template e separa territórios
- 20 — hooks ativos (≥ 1 quality gate)
- 20 — testes verdes
- 15 — cost report coerente
- 10 — cleanup limpo (sem tmux órfão)
- 10 — portabilidade (1 papel em Codex ou Gemini)
🪝 Quality gates obrigatórios
Pelo menos 1 hook ativo: tests passando ao TaskCompleted, ou block-rm em PreToolUse. Hook é o que separa demo de entrega.
📌 Hook canônico para o capstone
TaskCompleted que roda testes.
- •.claude/hooks/test-on-complete.sh
- •Roda npm test do path da task
- •Exit 2 com saída se falha
- •Stderr volta ao teammate
- •Configurado em .claude/settings.json
📊 Cost report
Documento docs/cost-report.md com tokens por teammate, modelo escolhido por papel, e justificativa do tamanho do squad. Mostra que entende custo.
📌 Estrutura do report
Vá direto ao ponto.
- •Tabela: papel | modelo | tokens in | tokens out
- •Decisões de modelo (por que cada um)
- •'Por que 5 e não 3'
- •Alternativas consideradas e descartadas
- •Total de custo da run
🎬 Apresentação final
Grave 5 min mostrando spawn, mailbox, idle notifications e cleanup; depois discuta decisões. Apresentar consolida; outros aprendem com seus erros e acertos.
📌 Estrutura da demo (5 min)
Cada parte do ciclo.
- •0:00-0:30 — prompt do spawn
- •0:30-2:00 — execução paralela (split-pane)
- •2:00-3:00 — mailbox em ação (Dev↔QA)
- •3:00-4:00 — quality gate via hook
- •4:00-5:00 — cleanup limpo
💡 Tempo curto força clareza
Mostre só o que importa. Admita o que não funcionou.
📌 Resumo do Módulo
Próximo módulo:
Voltar à trilha 5