🏷️ Regra 1: território próprio
Cada arquivo crítico tem 1 e somente 1 teammate dono. Outros podem ler; só o dono escreve. É a regra mais quebrada e a que mais causa estrago.
⚠️ Overwrite silencioso
Sem ownership, dois teammates editando o mesmo arquivo gera merge implícito ruim. Não há crash — só código faltando.
📌 Como impor
Defina no spawn e replique no CLAUDE.md.
- •Pasta-âncora por papel
- •Padrões de path por papel
- •Mensagens P2P para troca de info
- •git blame para auditar dono real
📬 Regra 2: mensagens diretas
Teammates falam direto via SendMessage; lead só entra para sintetizar ou desempatar. Tudo passar pelo lead serializa o time.
📌 Padrões de handoff
Direto entre quem produz e quem consome.
- •Backend → contrato → Frontend
- •Frontend → screenshot → QA
- •QA → findings → Backend (retrabalho)
- •Security → severidade → Backend
💡 Lead como árbitro
Quando deve subir ao lead? Conflito de prioridade, dúvida fora do escopo do role, decisão arquitetural.
⚡ Regra 3: paralelismo real
Spawn em paralelo + tasks independentes na partida. Quem precisa esperar, espera por mensagem — não por turno do lead.
✓ Paralelo real
- ✓Todos acordam juntos
- ✓Tasks independentes na partida
- ✓Espera = aguardar mensagem
- ✓Fan-out + fan-in
✗ Paralelo fake
- ✗1 acorda, depois outro
- ✗Cadeia 1 → 2 → 3
- ✗Espera = lead ainda processa
- ✗Sem mailbox real
🚧 Demo de conflito de arquivo
Lab: force dois teammates a editar o mesmo arquivo. Veja o overwrite acontecer. Depois corrija com ownership e rode de novo. Ver acontecer treina o olho.
Setup
Spawn errado
2 teammates ambos com 'edita src/app.js'
Run
Concorrência ruim
Backend escreve linha 50; Frontend escreve linha 50 sobrepondo
Diagnóstico
git diff mostra perda
Linha do Backend sumiu; QA falha
Fix
Spawn corrigido
Backend dono de src/api/; Frontend de src/ui/
Re-run
Sem conflito
Mensagem P2P troca contrato em vez de editar mesmo arquivo
📐 Quando 'quebrar' as regras
Casos pequenos onde 1 arquivo compartilhado é OK (TODO.md temporário) — desde que documentado e nunca em arquivos críticos. Saber quebrar com critério é parte do ofício.
📌 Exceções aceitáveis
Apenas leitura ou append; nunca em arquivos de produção.
- •TODO.md temporário (apenas append)
- •Logs de coordenação (apenas append)
- •Arquivos read-only auxiliares
- •Lock explícito via mensagem antes de editar
🔍 Auditoria pós-execução
Após cada execução: mailbox + git diff + task list. Times 'aparentemente bem' às vezes serializam por baixo. Auditar fecha o ciclo de aprendizado.
📊 Métricas para olhar
- git blame por teammate name
- Mensagens P2P vs lead-mediated
- Wall-clock por papel
- Tasks pending no fim
- Tokens por papel
📌 Resumo do Módulo
Próximo módulo:
3.2 — Contexto e permissões