Orquestração multiagente no Orca: como transformar uma tarefa complexa em trabalho coordenado

A pergunta que todo mundo faz quando começa a usar agentes de IA no trabalho: "como isso funciona na prática?" A resposta curta: dividir o problema, distribuir para agentes especializados e coordenar o resultado. A resposta longa é este artigo.

O cenário: uma tarefa que, se você fizesse sozinho, tomaria o dia inteiro — ou a semana. O objetivo aqui não é "automatizar tudo". É transformar uma demanda real em trabalho coordenado: cada parte do problema nas mãos de quem (ou do quê) executa melhor, com contexto suficiente para não errar e critério claro para saber quando terminou.

O problema com tarefas grandes

Toda tarefa complexa carrega três riscos quando você tenta executá-la de uma vez:

• Contexto demais. Um agente (ou pessoa) que precisa saber tudo acaba não retendo nada. Janela de contexto não é memória infinita — e nem deveria ser.
• Responsabilidade de menos. Quando todo mundo é responsável por tudo, ninguém é responsável por nada. Se algo quebra, você não sabe onde procurar.
• Qualidade diluída. Sem critério de qualidade explícito, cada parte do trabalho fica "quase boa" — e o conjunto, pior.

A orquestração multiagente existe para resolver exatamente isso. Não para impressionar ninguém com arquiteturas sofisticadas, mas para devolver clareza: quem faz o quê, com qual contexto, e quem responde por cada parte.

Passo 1: dividir o trabalho

O primeiro passo não é criar agentes. É entender o problema.

Pegue a tarefa e pergunte: quais partes são independentes? Quais dependem de outras? Quais exigem contexto que o resto do time não precisa ter?

No meu caso: eu precisava publicar um artigo bilíngue. Duas versões (pt-BR e en), mesmo translationKey, mesmo date, tags diferentes por idioma. O trabalho se divide naturalmente:

1. Escrever em pt-BR — contexto: tom do blog, pauta em português
2. Escrever em en — contexto: tom do blog, pauta em inglês
3. Validar — contexto: convenções do repo, comandos de lint/build

Cada parte tem contexto próprio e responsável próprio. Nenhum agente precisa saber tudo — só o que compete a ele.

Regra prática: se você não consegue descrever uma parte da tarefa sem mencionar outra parte, elas não são independentes. Divida de novo — ou aceite que é uma tarefa única.

Passo 2: dar contexto a cada agente

Contexto é o que impede um agente de errar com confiança. É a diferença entre "escreva algo sobre X" e "escreva X com este tom, estas referências e este limite de tamanho".

No Orca, o contexto chega de três formas:

• Preamble + TASK block. O que você está lendo agora é um exemplo: regras de comportamento, o ID da tarefa, e a instrução completa do que fazer. É o "briefing" do agente.
• Worktree. Cada agente roda em um worktree git próprio. Ele vê o código, lê o AGENTS.md, segue as convenções — sem pisar no trabalho dos outros.
• CLI de coordenação. Comandos como check, ask, send permitem que o agente pergunte, reporte progresso e escale bloqueios — sem inventar respostas quando falta informação.

O erro clássico é dar contexto demais ("aqui está o repositório inteiro") ou de menos ("escreva um artigo"). O ponto ideal: o mínimo que o agente precisa para não ter que adivinhar.

Passo 3: coordenar sem centralizar

Coordenação não é microgerenciamento. O coordenador não diz como cada agente trabalha — diz o que precisa ser entregue e quando reportar.

O loop de coordenação no Orca:

1. Dispatch. O coordenador envia a tarefa com escopo, IDs e regras de comportamento.
2. Heartbeat. O agente sinaliza que está vivo a cada ~5 minutos — distinguindo "ainda pensando" de "travou".
3. Ask/escalate. Se algo bloqueia o trabalho, o agente pergunta ou escala — em vez de parar em silêncio ou improvisar.
4. worker_done. Ao terminar, o agente envia um resumo em 3 frases: o que fez, o que descobriu, o que falta. O coordenador decide se aceita ou reengaja.

Esse loop é o que permite que um humano coordene vários agentes sem virar gargalo. Você não acompanha cada passo — acompanha entregas e bloqueios.

Regra prática: se você está acompanhando passos, você está microgerenciando. Se está acompanhando entregas, você está orquestrando.

Passo 4: manter qualidade e responsabilidade

Divisão de trabalho sem critério de qualidade vira bagunça distribuída. Três mecanismos simples resolvem:

• Contrato de entrega. Todo dispatch define o formato esperado: arquivos criados, validações que devem passar, resumo final em 3 frases. Se a entrega não bate com o contrato, o coordenador devolve.
• Validação no worktree. O agente valida o próprio trabalho antes de reportar — lint, build, testes. Quem produz, valida. Sem terceirizar a responsabilidade.
• Responsabilidade individual. Cada agente responde pela sua parte. Se o artigo em pt-BR tem erro, não é "culpa do sistema" — é da parte que escreveu pt-BR. Localizar o responsável deve ser trivial.

Isso não é burocracia. É o que permite que o conjunto fique melhor que a soma das partes: cada parte boa, cada fronteira clara.

Lições práticas

1. Divida por independência, não por etapa. Partes independentes podem rodar em paralelo; partes dependentes precisam de ordem. Confundir os dois desperdiça tempo.
2. Contexto mínimo, não máximo. Mais contexto não é melhor contexto. Dê o suficiente para o agente não adivinhar — e nada além disso.
3. Coordene entregas, não passos. Heartbeats e worker_done existem para que você não precise vigiar. Use-os.
4. Quem produz, valida. O agente que fez o trabalho roda lint e build antes de reportar. Sem isso, o coordenador vira QA.
5. Responsabilidade rastreável. Um problema deve apontar para uma parte, não para "o sistema". Se não aponta, a divisão foi ruim.

Conclusão

Orquestração multiagente não é sobre ter muitos agentes. É sobre ter um problema bem dividido, agentes com contexto suficiente e um coordenador que acompanha entregas — não passos.

O Orca materializa isso com worktrees, dispatches e um protocolo simples (heartbeat, ask, escalate, worker_done). Nada disso é magia: é processo, com nomes e regras.

A pergunta certa não é "quantos agentes eu uso?" mas "como eu divido esse problema para que cada parte tenha dono, contexto e critério de qualidade?" — e essa pergunta você responde antes de abrir qualquer ferramenta.