Como rodar vários agentes de IA sem um sobrescrever o outro

Resposta curta: dê a cada agente de IA uma cópia própria do projeto, em uma branch separada, com git worktree. Sem esse isolamento, dois agentes que editam o mesmo arquivo se sobrescrevem sem nenhum erro na tela, e o trabalho perdido só aparece quando um teste que passava começa a falhar.

Rodar dois agentes de IA ao mesmo tempo no mesmo projeto parece só uma questão de abrir dois terminais. Funciona por uns vinte minutos. Depois um deles reescreve um arquivo que o outro tinha acabado de mudar, e o trabalho perdido não aparece em lugar nenhum.

Esse é o detalhe que torna a falha cara: ela é silenciosa. Não há mensagem de erro, não há conflito, não há alerta. O arquivo simplesmente volta a ser o que era. Você descobre meia hora depois, quando o teste que passava começa a falhar, e gasta mais meia hora procurando um bug que nunca existiu.

Por que dois agentes de IA se sobrescrevem

Um agente de IA de programação não trabalha por transação. Ele lê um arquivo, pensa, e escreve o arquivo inteiro de volta com a versão dele. Se dois agentes leram a mesma versão e escreveram em momentos diferentes, o segundo apaga o primeiro sem nunca ter sabido que o primeiro existia.

Nenhum dos dois errou. Os dois fizeram exatamente o que foi pedido. O problema é que estavam pisando no mesmo chão.

Como isolar cada agente de IA no mesmo repositório

Toda ferramenta séria desta categoria resolve isso do mesmo jeito, e vale entender por quê: cada agente recebe uma cópia própria do projeto, na sua própria linha de trabalho. No Git isso tem nome, worktree, e é uma cópia de verdade do código em disco, ligada ao mesmo repositório e a uma branch separada.

O efeito prático é que o agente A e o agente B nunca escrevem no mesmo arquivo, porque não existe o mesmo arquivo. Existem dois. E quando os dois terminam, quem decide o que entra é você, com o Git mostrando a diferença lado a lado, que é exatamente o momento em que uma colisão deve aparecer: na hora de juntar, com tudo à vista, e não no meio do trabalho, escondida.

Como o CanvasCode isola cada agente de IA

No CanvasCode o isolamento é da casa, e a diferença está no que você vê sem precisar perguntar.

Cada agente de IA que sai para trabalhar mostra no próprio painel em que linha de trabalho ele está, ao lado do estado do pull request. Você olha o canvas e sabe quem está onde, sem rodar um comando.

Quando duas frentes começam a mexer no mesmo arquivo, o aviso aparece antes, não depois. E quando um agente termina e é dispensado, a cópia dele não fica largada no disco: o app recolhe o que sobrou e diz o que ficou faltando.

O isolamento também é uma decisão sua, não uma imposição: ele pode ficar ligado para tudo, desligado num projeto específico, e as instruções que os agentes recebem sobre como trabalhar isolados são texto que você escreve, não uma regra fixa dentro do programa.

Preciso de isolamento se uso um agente de IA por vez?

Vale dizer o contrário também. Se você usa um agente de IA por vez, nada disso importa e a complexidade extra não se paga. O isolamento existe para quem tem três, cinco, oito frentes abertas ao mesmo tempo, que é quando o ganho de rodar em paralelo passa a ser maior do que o custo de coordenar.

É aí que a pergunta deixa de ser "consigo abrir vários?" e vira "consigo confiar no que eles fizeram?".

Worktree ou contêiner: qual usar para isolar agentes de IA?

Worktree é mais leve e mais rápido: são arquivos no mesmo disco, e o agente de IA continua enxergando as ferramentas da sua máquina. Contêiner isola mais fundo, inclusive processo e rede, e é o que você quer se pretende deixar um agente rodando sem supervisão. Ferramentas como o JetBrains Air oferecem os dois; o CanvasCode usa worktree.

E se dois agentes de IA precisarem mexer no mesmo arquivo?

Vai acontecer, e o certo é que apareça cedo. Com isolamento, os dois trabalham nas cópias deles e a colisão surge na hora de juntar, com o Git mostrando as duas versões lado a lado. No CanvasCode o aviso vem antes disso: quando duas frentes começam a tocar o mesmo arquivo, o app avisa enquanto ainda dá para dividir o trabalho de outro jeito.

Quantos agentes de IA dá para rodar em paralelo?

Tecnicamente, quantos a máquina aguentar: cada agente é um processo e uma cópia do projeto em disco. Na prática o limite é humano e chega bem antes, porque o gargalo passa a ser quantos você consegue acompanhar. Seis é onde a maioria das pessoas começa a perder o fio.