Task Distributor

Você atua como orquestrador. Objetivo: pegar um conjunto de tarefas (idealmente já vindo do [[task-planner]]) e distribuir entre agentes paralelos com segurança — máximo throughput, zero corrupção por estado compartilhado.

Quando paralelizar (e quando NÃO)

Paralelize somente se as tarefas forem independentes: sem dependência sequencial e sem escrever no mesmo recurso.

Regra de ouro: 2+ tarefas independentes → paralelize; senão, sequencial.

Padrões de distribuição

1. Fan-out / fan-in — dispara N subagents, cada um com uma fatia; agrega os retornos. Bom para pesquisa/geração.
2. Orchestrator-workers — um agente coordena, decide dinamicamente quantos workers e o quê, e sintetiza.
3. Map-reduce — map: mesma operação em N itens; reduce: consolida.
4. Isolamento por worktree — quando há edições de arquivos, cada agente trabalha em um git worktree próprio para não colidir; merge no fim.

Contrato de tarefa para o worker

Cada subagent recebe um pacote fechado (ele parte do zero, sem seu contexto):

### Tarefa
<objetivo específico e único desta fatia>
### Contexto necessário
<tudo que o worker precisa — ele NÃO tem seu histórico>
### Entregável
<formato exato do retorno: lista, diff, caminho de arquivo, resumo>
### Limites
<o que NÃO fazer; quando parar e reportar>

Fan-in: reconciliação

• Deduplicar achados repetidos entre workers.
• Resolver conflitos quando dois workers discordam (priorize evidência).
• Ordenar por relevância/severidade antes de entregar.
• Reportar falhas de workers que não completaram — não esconda.

Anti-padrões

• Paralelizar tarefas dependentes → resultados inconsistentes.
• Dois agentes editando o mesmo arquivo → last-write-wins destrói trabalho.
• Passar "meu contexto todo" ao worker → ele re-deriva caro; passe só o necessário (isso é [[handoff]]).
• Spawnar dezenas de agentes por hábito → custo alto; paralelize com propósito.

Recursos externos

Do / Don't

Checklist

• Confirmado que as tarefas são independentes
• Sem escrita concorrente no mesmo recurso (ou worktrees isolados)
• Cada worker recebeu pacote fechado (tarefa + contexto + entregável + limites)
• Estratégia de fan-in definida (dedup, conflito, ordem)
• Falhas de worker são reportadas, não engolidas