4 Coisas que seu Orquestrador de Código Claude Precisa para Ser Útil

Se você está construindo agentes orquestradores (agentes que gerenciam outros agentes) com Claude Code, quatro componentes separam um útil de um caótico. Aqui está o que aprendi após meses construindo-os.

1. Um Documento de Missão

Não deixe seu orquestrador depender da inteligência padrão do modelo. Escreva um "documento de missão" — uma descrição de cargo que define o que fazer, como fazer e quando escalar. Para um orquestrador de relatórios de bugs, isso pode ser:

• Verificar e-mails com "feedback do cliente" no assunto
• Registrar um ticket localmente
• Criar um agente filho para reproduzir o bug e implementar uma correção usando engenharia composta (ou outro plugin como superpowers ou GSD)
• Me alertar quando estiver pronto para QA

Você não precisa intervir até o passo 4. No melhor cenário, economiza tempo; no pior, o código é descartado.

2. Um Heartbeat (Loop)

Um orquestrador sem loop é apenas um script de uso único. O verdadeiro poder está na cadência — releia o documento de missão em um cronograma (a cada 10 minutos, a cada hora, o que funcionar). A maioria dos CLIs de agente oferece um loop ou primitiva cron. A cada tick, o orquestrador verifica novas tarefas, monitora o progresso das tarefas existentes e age conforme a missão determina.

3. Comunicação Entre Agentes

Seu orquestrador mantém contexto que você não carregou nos filhos. Ele pode responder perguntas deles, coordenar abordagens entre eles ou executar revisões adversariais onde um agente verifica o trabalho do outro. A implementação pode ser simples: um arquivo markdown compartilhado com regras estruturadas, uma ferramenta de passagem de mensagens ou um sistema de canal secundário. O mecanismo importa menos do que garantir que o canal exista.

4. Controle Auditável

Construa seu orquestrador para produzir registros: o que decidiu, o que criou, o que os filhos produziram. Você precisa ser capaz de entrar em qualquer agente filho, revisar seu trabalho e interrompê-lo a qualquer momento. A visibilidade de tudo é a única maneira de ter confiança no resultado — você é responsável por tudo.

Esses princípios se aplicam independentemente de você usar a ferramenta mostrada no vídeo original ou qualquer outra ferramenta de agente. Você pode construir um orquestrador com o que já está usando.