1
🧠 Teste mental
Antes de disparar subagente, pergunte-se:
"Preciso do output intermediário ou só da conclusão?"
Se só conclusão → subagente. Se precisa ver o caminho → mantém no contexto principal.
2
📝 Prompt canônico
<subagent_policy>
Do not spawn a subagent for tasks that fit in a single
direct response. Subagents have setup overhead and their
own context; they only pay off when either:
(a) the output intermediário é ruidoso (50k+ tokens) e
you only need a distilled conclusion, or
(b) three or more independent investigations can run
simultaneously and you want real parallelism.
When spawning, always pass: goal, exact file paths,
success criteria, and the expected return shape.
</subagent_policy>3
🪄 Fan-out múltiplo
Três subagentes no mesmo turno, cada um com seu contexto isolado. Pai sintetiza quando todos voltam.
Exemplo: em um refator grande, um subagente atualiza o módulo de auth, outro migra os testes, outro reescreve a doc — simultaneamente.
4
⚠️ Over-use
✗ Não delegue
- • "Qual o nome da função X?"
- • Edit de 3 linhas em 1 arquivo
- • Resposta que cabe em 1 parágrafo
✓ Delegue
- • Mapear 30 arquivos legados
- • Rodar suíte de testes pesada
- • Explorar 3 designs em paralelo
5
💰 Economia de contexto
O subagente lê 50k tokens e retorna 2k resumidos. A janela pai fica livre para decisão.
| Cenário | Contexto pai | Output útil |
|---|---|---|
| Sem subagente | 50k+ tokens ruidosos | ~2k |
| Com subagente | ~2k resumo | ~2k |
6
🔁 Passando contexto
Subagente começa do zero — briefing vale como ICCA humano:
- •Goal: uma frase objetivo do que retornar
- •Paths: caminhos absolutos exatos, não "algum lugar em src"
- •Constraints: o que NÃO pode modificar
- •Return shape: markdown com seções, JSON, tabela etc.
7
🧪 Laboratório: refator com 3 subagentes
Exercício
- Escolha um refator de ≥3 módulos independentes.
- Briefing pai: delega 3 subagentes paralelos, cada um com paths e return shape próprios.
- Pai sintetiza e abre PR.
- Registre: wall-clock, turnos, tokens, context do pai.
- Compare com a versão sequencial que você teria feito.
📋 Resumo
✓
Teste mental — output ou conclusão?
✓
Prompt canônico — anti over-use
✓
Economia de contexto — principal ganho
✓
Briefing completo — goal, paths, constraints, shape
Próximo Módulo:
3.4 — Receitas de Subagentes