📖 CLAUDE.md compartilhado
Todo teammate carrega CLAUDE.md ao acordar. É o jeito mais robusto de dar instruções globais. Boilerplate no spawn é caro — o que vale para todos vai aqui.
📌 O que entra no CLAUDE.md
Convenções globais e contratos do repo.
- •Convenções de código
- •Mapas de pastas
- •Políticas de testes
- •Variáveis de ambiente
- •Comandos comuns
💡 O que NÃO entra
Instruções específicas da tarefa atual. Aquelas vão no spawn — CLAUDE.md é estável.
🚫 O que NÃO carrega
Conversa anterior do lead, decisões tomadas no chat, contexto implícito — tudo isso fica fora do teammate. É a fonte mais comum de 'o agente esqueceu o que combinamos': ele simplesmente nunca soube.
⚠️ Pegada típica
Você decide algo no chat com o lead. Spawna teammate. Teammate ignora porque não sabe.
💡 Solução
Tudo que importa para o teammate vai no spawn. Sempre. Mesmo que pareça repetição.
🛠️ Subagent definitions reusáveis
Um teammate pode usar uma subagent definition (em .claude/agents/) como tipo, herdando tools e modelo. Uma vez bom, vale para o time todo.
📌 Como usar
Cite o nome no prompt do spawn.
- •'Spawn a security-reviewer teammate to audit auth'
- •Body do .md vira system prompt
- •Tools allowlist é respeitada
- •Skills/MCP servers do frontmatter NÃO se aplicam
⚠️ Limitação
Skills e mcpServers do frontmatter do subagent definition NÃO se aplicam quando ele é teammate. Apenas tools e model.
🔒 Modos de permissão pós-spawn
Você pode mudar o modo de permissão de um teammate específico depois que ele já está rodando. Útil para 'soltar' agente que provou competência ou 'apertar' agente aventureiro.
📌 Por teammate, em runtime
Não há per-teammate mode no spawn.
- •Spawn: todos herdam do lead
- •Runtime: muda por teammate via mensagem
- •Auditoria via PostToolUse hook
- •Reverte se quiser
💡 Padrão útil
QA sempre em modo restrito; Architect em modo permissivo; Dev no meio.
📁 Onde a equipe vive em disco
Config em ~/.claude/teams/{team}/config.json; tasks em ~/.claude/tasks/{team}/. Saber inspecionar ajuda diagnóstico.
⚠️ NÃO edite à mão
Config é regravado a cada update de estado. Modificações manuais somem na próxima ação.
📊 O que olhar
- config.json para session IDs e nomes
- tasks/ para estado e dependências
- Locking automático (file locks)
- Permanece após cleanup (auditoria)
🌐 MCP servers e impacto no time
MCP servers configurados ficam disponíveis a todos os teammates como tools. 1 servidor MCP de qualidade = N teammates instantaneamente capazes.
📌 Cuidados
Tools que escrevem precisam de allowlist por papel.
- •MCP read-only: pode liberar geral
- •MCP que escreve: allowlist por papel
- •Auditoria via PostToolUse
- •Cuidado especial com QA
📌 Resumo do Módulo
Próximo módulo:
3.3 — Aprovação de plano