Colony: Uma Camada de Coordenação Local-Primeiro que Reduz Tokens de Transferência Multiagente de 30K para 400

Colony é uma camada de coordenação local-first para configurações de codificação multiagente. Ela fica entre seus runtimes de agente (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) e um armazenamento SQLite local, reduzindo a sobrecarga de handoff de ~30.000 tokens para ~400 tokens por final de sessão.

Principais Recursos

• Reivindicações antes de edições — Agentes reivindicam um arquivo antes de tocá-lo; outros agentes veem a reivindicação ativa e se abstêm, evitando condições de corrida e PRs duplicados.
• Handoffs compactos — Ao final da sessão, Colony escreve um recibo estruturado (link do PR, SHA do merge, arquivos alterados, resultados de verificação, status de limpeza). O próximo agente lê ~400 tokens em vez de reproduzir ~30.000.
• Diagnósticos de saúde — colony health detecta falhas silenciosas de coordenação: reivindicações obsoletas, incompatibilidades de ponte de ciclo de vida, lacunas de adoção de plano-reivindicação.
• Memória persistente — Comprimida em repouso (~70% de compressão de prosa, perfeita para caminhos/código/comandos). Pesquisável via FTS5.

O Que Não É

• Não é um plano de controle hospedado — local-first por padrão, os dados nunca saem do disco.
• Não é um executor de agente — Codex, Claude, Cursor ainda executam o trabalho.
• Não é orquestração — estigmergia: agentes deixam rastros, os úteis são reforçados, os obsoletos evaporam.

Formato do Recibo de Handoff

Quando uma sessão termina, os agentes retornam uma resposta estruturada com link do PR, SHA do merge, arquivos alterados, resultados de verificação e status de limpeza da árvore de trabalho. Colony captura isso como uma observação; o próximo agente lê em vez de rederivar o contexto. mcp_metrics registra o custo.

Instalação

npm install -g /colony-cli
colony install --ide codex
colony health

Requer Node 20+. Licenciado sob MIT. Todos os dados armazenados em ~/.colony/data.db.

Melhorias Futuras

O autor está trabalhando em resolver automaticamente conflitos de reivindicação do mesmo arquivo e um comando colony heal --apply que executa o plano de correção em vez de apenas imprimi-lo.