Como Executar de 3 a 8 Agentes de Codificação em Paralelo Sem Perder o Controle

Executar dois agentes ao mesmo tempo leva cinco minutos. Você abre dois terminais, dá a cada um uma tarefa e observa o texto rolar.

O problema começa no quarto.

Você já não sabe mais qual está esperando por uma revisão, qual terminou, qual travou há dez minutos enquanto você olhava para outro lugar. Você rola no terminal errado. Você relança uma tarefa que já estava concluída. Uma hora depois, você está fazendo o trabalho de três agentes manualmente só para se orientar.

Não é um problema de potência. É um problema de visibilidade.

O verdadeiro gargalo é sua cabeça

Um agente codificando autonomamente entrega em rajadas. Ele pensa por 40 segundos, escreve, para, espera sua aprovação. Durante esses 40 segundos, você pode acompanhar um segundo agente. Enquanto o segundo escreve, você aprova o primeiro.

Até 3 agentes, seu cérebro acompanha. Passando de 5, você perde o fio.

A Anthropic publicou um número revelador em sua documentação: tentativas sem orientação têm sucesso cerca de uma vez em três. A diferença entre as pessoas que entregam em volume e todos os outros não é o modelo. É a estrutura que elas colocam em prática antes de começar.

Então, antes de escalar, você estrutura.

Regra um: um agente, um espaço de trabalho isolado

O erro clássico é colocar três agentes na mesma cópia do repositório. Eles se atrapalham. Um edita package.json, outro também, e você acaba com um merge que não consegue desfazer.

A solução são duas palavras: git worktree.

git worktree add ../project-auth feature/auth
git worktree add ../project-billing feature/billing
git worktree add ../project-export feature/export

Cada agente trabalha em sua própria pasta, em seu próprio branch, com seus próprios arquivos. Zero colisões. Você revisa cada branch separadamente e faz o merge quando estiver pronto.

Esta é a base do que os pesquisadores chamam de delegação isolada: um gerente central divide o trabalho, cada subtarefa é executada em seu próprio canto, e a integração acontece depois, com testes para validar.

Regra dois: nunca distribua o mesmo arquivo central duas vezes

Antes de dividir o trabalho, encontre os arquivos que várias funcionalidades precisarão tocar. O roteador. O esquema do banco de dados. A configuração da rota da API.

Esses arquivos recebem exatamente um agente. Os outros esperam ou trabalham em torno deles.

Entregue o mesmo routes.ts para dois agentes paralelos e você pagará em conflitos de merge o que achou que ganharia em paralelismo. Essa troca perde todas as vezes.

Regra três: um quadro, não dez terminais

É aqui que a maioria das pessoas desiste do multi-agente. Elas abrem oito abas de terminal, perdem o fio e voltam rastejando para um único agente.

Você precisa de uma visão que responda a três perguntas de relance:

• Quem está codificando agora?
• Quem está esperando minha revisão?
• Quem terminou ou travou?

Sem essa visão, o multi-agente custa mais em carga mental do que oferece em velocidade. Com ela, você pode realmente manter 6 ou 8 fluxos de trabalho ao mesmo tempo.

Essa é a lacuna exata que o AgentsRoom preenche. Cada agente recebe seu próprio espaço, seu status, sua cor. Um agente esperando sua resposta fica vermelho e te avisa. Você para de rolar o terminal errado, olha para o quadro e sabe para onde ir.

O ritmo que funciona na prática

Aqui está o ritmo com o qual eu começaria.

Comece com dois agentes, em duas funcionalidades que não compartilham arquivos. Acostume-se com o loop de revisão e merge. Esse loop, não o código, se torna seu verdadeiro trabalho.

Quando esse loop parecer suave, vá para quatro. Mantenha uma lista de prioridades estrita de tarefas de alto impacto e confie fortemente no modo de planejamento: você aprova o plano do agente antes que ele escreva uma linha. Um plano aprovado antecipadamente te poupa de uma revisão dolorosa depois.

O ponto ideal está entre 3 e 8 funcionalidades no mesmo repositório, com supervisão visual. Além disso, mesmo com um bom quadro, a revisão se torna o gargalo e você perde o benefício.

O que você realmente ganha

Multi-agente é inútil para 95% das pequenas tarefas. Para corrigir um erro de digitação ou adicionar um botão, um único agente é suficiente, e é mais rápido.

Onde isso muda sua semana é em trabalhos grandes. Você inicia três refatorações independentes em uma noite, as revisa conforme chegam, e na manhã seguinte você tem três dias de trabalho prontos para mesclar.

O segredo não é o número de agentes. É sempre saber qual deles precisa de você, agora. Conserte isso, e o resto segue.