v2matosevic/Version2-Agent-Coordination

O que Version2-Agent-Coordination faz?

Camada de coordenação em toda a máquina para que múltiplos agentes de codificação de IA (Claude Code, Codex, ...) não interfiram entre si: presença compartilhada, bloqueios de arquivos com autocura, um guardião universal de commits git, mensagens entre agentes e detecção de trabalho duplicado.

Visão Geral

Este skill resolve o problema de múltiplos agentes de IA operando simultaneamente no mesmo diretório de trabalho. Sem coordenação, agentes podem sobrescrever arquivos uns dos outros, causar conflitos de merge no git ou duplicar trabalho. O Version2-Agent-Coordination fornece uma infraestrutura leve e baseada em sistema de arquivos para garantir que todos os agentes colaborem harmoniosamente.

Recursos Principais

• Presença Compartilhada: Cada agente registra sua presença em um diretório compartilhado, permitindo que outros agentes saibam quem está ativo.
• Bloqueios de Arquivos com Autocura: Arquivos podem ser bloqueados por um agente; se o agente falhar, o bloqueio expira automaticamente após um período de tempo limite.
• Guardião Universal de Commits Git: Garante que apenas um agente possa fazer commit por vez, evitando conflitos de merge.
• Mensagens entre Agentes: Agentes podem enviar mensagens curtas uns aos outros através de um canal de comunicação baseado em sistema de arquivos.
• Detecção de Trabalho Duplicado: Agentes podem anunciar tarefas em andamento, evitando que outro agente inicie a mesma tarefa.

Como Usar

Instalação

Adicione este skill ao seu agente de IA (Claude Code, Codex, etc.) conforme as instruções da sua plataforma.

Comandos

• agent-list: Lista todos os agentes ativos atualmente.
• agent-lock <arquivo>: Bloqueia um arquivo para edição exclusiva.
• agent-unlock <arquivo>: Libera um bloqueio de arquivo.
• agent-commit ou agent-git-commit: Cria um commit git de forma coordenada.
• agent-msg <destinatário> <mensagem>: Envia uma mensagem para outro agente.
• agent-task <descrição>: Anuncia que você está trabalhando em uma tarefa específica.

Variáveis de Ambiente

• AGENT_COORDINATION_DIR: Diretório onde os arquivos de coordenação são armazenados. Padrão é ~/.agent-coordination.
• AGENT_LOCK_TIMEOUT: Tempo limite em segundos para bloqueios de arquivos. Padrão é 300 segundos.

Exemplo de Fluxo de Trabalho

1. Agente A anuncia "Refatorando módulo de login" via agent-task.
2. Agente B verifica tarefas ativas e evita duplicação.
3. Agente A bloqueia login.py via agent-lock login.py.
4. Agente A edita o arquivo e, em seguida, usa agent-unlock login.py.
5. Agente A faz commit coordenado via agent-commit.

Licença

MIT

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório GitHub.