Coordenação de agentes: agentes em paralelo que não sobrescrevem uns aos outros

Com vários agentes em um projeto, o problema mais comum é dois deles mudarem o mesmo arquivo ao mesmo tempo, ou um não saber o que o outro decidiu. O AgentVera faz duas coisas: percebe quando agentes mexem no mesmo arquivo e avisa, e dá a cada grupo de agentes um quadro compartilhado.

Avisos de conflito de arquivo

Quando um agente edita um arquivo, ele reserva o arquivo por um tempo: enquanto estiver trabalhando, ou por 10 minutos depois da última edição. Se outro agente do mesmo projeto editar esse arquivo, nada é bloqueado; o agente recebe contexto e você recebe um aviso.

  • Mesma pasta: um aviso “A e B estão no mesmo arquivo”, já que as mudanças podem se sobrescrever.
  • Worktrees diferentes: uma nota de que o merge pode dar conflito.
  • O Claude Code é avisado antes da edição: ele é orientado a reler o arquivo, mudar só o que a própria tarefa precisa e não desfazer as mudanças do outro agente.
  • As edições do Codex são lidas da conversa dele quando o turno termina, e o conflito é informado a você.
  • Cada par de arquivo e agente é informado uma vez; as reservas são liberadas quando um agente para.

Quadros de grupo

Cada grupo de agentes tem o próprio quadro; os agentes fora de um grupo compartilham o quadro do projeto. Os agentes leem o quadro, publicam entradas e fecham pendências com as ferramentas MCP agentvera-board. As instruções do servidor dizem aos agentes para ler o quadro ao começar, publicar suas decisões e achados, e não assumir o papel de outro agente.

  • Tipos de entrada: Note, Decision, Todo, Finding, File / module.
  • board_read filtra por tipo, texto ou pendências abertas; board_post adiciona uma entrada; board_update fecha uma pendência ou muda o texto dela.
  • Na aba Board do painel direito você mesmo pode deixar notas, marcar pendências como feitas ou apagar entradas.
  • O quadro é adicionado a todo agente CLI que aceita servidores MCP; os agentes sem MCP usam o mesmo quadro pelo comando de shell agentvera-board.

Aprovações e limites

As chamadas das ferramentas do quadro têm uma categoria própria, “Ortak pano” (quadro compartilhado), nas regras de aprovação automática, então você não precisa aprovar cada publicação. Os quadros e as reservas de arquivo ficam no seu computador. Os avisos de conflito comparam só agentes do mesmo projeto e não cobrem agentes de runners remotos.

Como usar

  1. 1

    Coloque os agentes que trabalham em paralelo em um grupo; o grupo ganha um quadro próprio.

  2. 2

    Passe o trabalho aos agentes; as instruções para usar o quadro vêm do servidor MCP.

  3. 3

    Abra a aba Board no painel direito para acompanhar as entradas e deixar notas quando precisar.

  4. 4

    Quando aparecer um aviso de mesmo arquivo, mude um dos agentes para outro trabalho ou para uma worktree.

Perguntas

Um aviso de conflito bloqueia a edição?

Não. Nada é bloqueado; o agente recebe contexto e você recebe um aviso.

Agentes de projetos diferentes entram em conflito?

Não. Só os agentes do mesmo projeto são comparados.

Onde ficam as entradas do quadro?

No seu computador, em um arquivo por quadro, com até 500 entradas por quadro.

Os agentes em um runner remoto entram?

Não. Os avisos de conflito de arquivo não cobrem agentes de runners remotos.

Recursos relacionados

Todos os recursosVeja os 18 agentes de código suportados

Reúna seus agentes em uma só mesa.

Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.