Colony: Una Capa de Coordinación Local-Primero que Reduce los Tokens de Transferencia Multi-Agente de 30K a 400

Colony es una capa de coordinación local-first para configuraciones de codificación multi-agente. Se sitúa entre los entornos de ejecución de tus agentes (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) y un almacén local SQLite, reduciendo la sobrecarga de transferencia de ~30,000 tokens a ~400 tokens por finalización de sesión.

Características Principales

• Reclamaciones antes de editar — Los agentes reclaman un archivo antes de modificarlo; otros agentes ven la reclamación activa y se abstienen, evitando condiciones de carrera y PR duplicados.
• Transferencias compactas — Al finalizar la sesión, Colony escribe un recibo estructurado (enlace del PR, SHA de fusión, archivos modificados, resultados de verificación, estado de limpieza). El siguiente agente lee ~400 tokens en lugar de reproducir ~30,000.
• Diagnósticos de salud — colony health detecta fallos de coordinación silenciosos: reclamaciones obsoletas, desajustes en el puente de ciclo de vida, brechas de adopción plan-reclamación.
• Memoria persistente — Comprimida en reposo (~70% de compresión de prosa, byte exacto para rutas/código/comandos). Consultable mediante FTS5.

Qué No Es

• No es un plano de control alojado — local-first por defecto, los datos nunca salen del disco.
• No es un ejecutor de agentes — Codex, Claude, Cursor siguen realizando el trabajo.
• No es orquestación — estigmergia: los agentes dejan rastros, los útiles se refuerzan, los obsoletos se evaporan.

Formato del Recibo de Transferencia

Cuando una sesión finaliza, los agentes devuelven una respuesta estructurada con el enlace del PR, SHA de fusión, archivos modificados, resultados de verificación y estado de limpieza del árbol de trabajo. Colony lo captura como una observación; el siguiente agente lee en lugar de reconstruir el contexto. mcp_metrics registra el costo.

Instalación

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

Requiere Node 20+. Con licencia MIT. Todos los datos se almacenan en ~/.colony/data.db.

Próximas Mejoras

El autor está trabajando en la resolución automática de conflictos de reclamación del mismo archivo y un comando colony heal --apply que ejecuta el plan de corrección en lugar de solo imprimirlo.