1
🎯 Princípio da paralelização
A regra é uma só: se o output de A não alimenta B, rodar juntos.
Teste de independência: consigo executar as duas ações em ordem inversa sem quebrar? Se sim, são independentes.
2
📋 Prompt canônico
<use_parallel_tool_calls>
For maximum efficiency, whenever you perform multiple
independent operations, invoke all relevant tools
simultaneously rather than sequentially.
This includes — but is not limited to — reading multiple
files, running independent searches (Grep/Glob), gathering
git state (status + diff + log), and executing independent
checks (lint + typecheck + test).
Never use placeholders or guess missing parameters. If a
required parameter is unknown, read or ask first.
</use_parallel_tool_calls>3
🔗 Quando NÃO paralelizar
✗ Dependente
- • Read → Edit (precisa ler antes)
- • Grep → Read (precisa achar antes)
- • Bash "mkdir x" → Bash "cd x/..."
- • Install dep → import dela
✓ Independente
- • Read A, Read B, Read C
- • git status + git diff + git log
- • npm run lint + test + typecheck
- • Grep pattern1 + Grep pattern2
4
🧪 Com vs sem prompt
| Métrica | Sem prompt | Com prompt |
|---|---|---|
| Turnos do modelo | 8 | 3 |
| Wall-clock | ~90s | ~25s |
| Tokens totais | similar | similar |
| Tempo humano | alto | baixo |
5
🔐 Never guess parameters
Paralelismo incentiva pular coleta de dados. A regra proíbe explicitamente:
"Never use placeholders or guess missing parameters." Se falta um path, ID ou valor, o modelo lê/pergunta antes; não chuta no paralelo.
6
🍳 Micro-receitas de fan-out
Git triage
status + diff + log + branch
Arquivos conhecidos
Read A + Read B + Read C
Busca multifacetada
Grep pat1 + Grep pat2 + Glob **/*.ts
CI local
lint + typecheck + test
Info de sistema
node --version + ls + pwd
Commit gate
add + commit + status (seq!)
7
📊 Medindo wall-clock
Tokens não mostram ganho — só o relógio mostra. Registre:
- •Start: timestamp quando você enviou o briefing
- •End: timestamp quando a resposta final veio
- •Turnos: quantas vezes você teve que digitar algo
KPI do módulo: minutos humanos recuperados por semana.
📋 Resumo
✓
Independentes em paralelo — teste da ordem inversa
✓
Bloco use_parallel_tool_calls — copy/paste canônico
✓
Never guess parameters — regra anti-alucinação
✓
Wall-clock é o KPI — não tokens
Próximo Módulo:
3.3 — Subagentes Explícitos