Artigos

Reserva de arquivos: Como evitar conflitos entre múltiplos agentes de IA no mesmo repositório

25 de julho de 2026

Múltiplos agentes sem coordenação geram sobrescritas silenciosas. Isolá-los em branches impede o compartilhamento de código. A solução é a reserva de caminhos de arquivos arbitrada pelo servidor.

Coloque três agentes no mesmo repositório sem controle e eles se sobrescreverão em menos de um minuto. A divisão em branches isoladas prejudica o desenvolvimento colaborativo de novas aplicações.

O custo de branches isoladas

Ambientes isolados impedem que agentes vejam tipos recém-criados uns pelos outros.

Arquivos comuns sofrem conflitos de merge insolúveis de forma automática.

A visualização em tempo real torna-se incompleta.

A reconciliação manual consome tempo e tokens desnecessários.

Por isso, os agentes compartilham o mesmo diretório.

Concessão temporária sem travamento

A reserva define caminhos, agente, modo e tempo de expiração.

Modos exclusivo (escrita) e compartilhado (leitura com notificações de alteração).

export interface ClaimDenial {
  path: string;
  holder: string;
  holderTask: string;
  expiresInS: number;
  hint: string;
}

Pedidos negados retornam instantaneamente dados do titular para que o agente possa redirecionar suas tarefas.

As concessões são renovadas a cada gravação e liberadas automaticamente ao encerrar o processo.

A disciplina do modelo é otimização; a garantia do servidor é a segurança real.

Monitoramento ativo do sistema de arquivos

O servidor valida todas as gravações no disco e bloqueia alterações não autorizadas.

classifyWrite(rawPath: string, hintedAgentId?: string): WriteClassification

Em caso de violação, um snapshot de segurança é criado antes de o arquivo ser alterado.

O agente infrator é alertado para reverter e o titular legítimo é notificado.

Rastreabilidade total

Cada commit no Git é atribuído automaticamente ao agente responsável pela modificação.

A arquitetura completa é detalhada em vários agentes de IA num repositório, e o fluxo de terminal em observar um terminal remoto.

Respostas diretas