🤖 Paralelismo Real

Para lancar multiplos agents, basta pedir ao Claude: "Execute essas tres tarefas em paralelo usando subagentes". Ele vai invocar a Task tool multiplas vezes simultaneamente. O segredo e formular cada tarefa como uma instrucao auto-contida.

Execute em paralelo usando subagentes:
1. Rode todos os testes e reporte quais falharam
2. Analise o arquivo src/auth.ts e sugira melhorias de seguranca
3. Atualize o README com as novas funcionalidades
Cada tarefa e independente. Use worktrees se precisar editar arquivos.

A regra de ouro: so paraleliza tarefas que nao dependem umas das outras. Se a tarefa B precisa do resultado da tarefa A, elas devem ser sequenciais. Mas se A, B e C sao independentes (ex.: testes, lint e docs), lancam-se todas ao mesmo tempo.

Uma heuristica util: se voce pode explicar cada tarefa sem mencionar as outras, elas sao independentes. Se precisa dizer "depois que X terminar", e dependente e deve ser sequencial.

O Claude Code pode usar o comando git worktree add para criar espacos de trabalho isolados. Cada worktree e uma copia do repositorio com sua propria branch, onde o subagente edita livremente sem interferir nos outros.

# Criar worktree para um subagente
git worktree add .claude/worktrees/agent-testes -b agent/testes

# Listar worktrees ativos
git worktree list

# Remover apos o merge
git worktree remove .claude/worktrees/agent-testes

Algumas tarefas demoram: rodar uma test suite inteira, fazer build, ou analisar um codebase grande. Em vez de ficar esperando, o agente principal lanca a tarefa em background e continua trabalhando. Quando o resultado estiver pronto, ele o incorpora. Isso e especialmente util com o run_in_background do Bash tool.

Quando todos os subagentes terminam, o agente pai recebe os resultados textuais de cada um. Cabe ao pai sintetizar: combinar os achados, resolver conflitos se houver, e produzir o output final. Pense nele como um gerente que recebe relatorios da equipe e monta o relatorio consolidado.

Quando um subagente falha, o pai tem tres opcoes: retry (tentar novamente com prompt ajustado), skip (ignorar e seguir com os que deram certo) ou abort (parar tudo). A estrategia depende da criticidade da tarefa. Testes falhando? Retry com mais contexto. Docs desatualizados? Skip por ora. Bug de seguranca? Abort e investigar.