콜로니: 로컬-퍼스트 조정 계층으로 멀티 에이전트 핸드오프 토큰을 30K에서 400으로 줄이다

Colony는 다중 에이전트 코딩 설정을 위한 로컬 우선 조정 계층입니다. 에이전트 런타임(Claude Code, Codex, Cursor, Gemini CLI, OpenCode)과 로컬 SQLite 저장소 사이에 위치하여 세션 종료 시 핸드오프 오버헤드를 약 30,000 토큰에서 400 토큰으로 줄입니다.

주요 기능

• 편집 전 클레임 — 에이전트가 파일을 건드리기 전에 클레임을 걸고, 다른 에이전트는 활성 클레임을 보고 대기함으로써 경쟁 상태와 중복 PR을 방지합니다.
• 간결한 핸드오프 — 세션 종료 시 Colony는 구조화된 영수증(PR 링크, 병합 SHA, 변경된 파일, 검증 결과, 정리 상태)을 작성합니다. 다음 에이전트는 약 30,000 토큰을 재생하는 대신 약 400 토큰만 읽습니다.
• 상태 진단 — colony health는 침묵하는 조정 실패(오래된 클레임, 라이프사이클 브리지 불일치, 계획-클레임 채택 격차)를 감지합니다.
• 영구 메모리 — 저장 시 압축(약 70% 산문 압축, 경로/코드/명령어는 바이트 단위 정확). FTS5를 통해 검색 가능.

이것이 아닌 것

• 호스팅된 제어 평면이 아님 — 기본적으로 로컬 우선, 데이터가 디스크를 떠나지 않음.
• 에이전트 실행기가 아님 — Codex, Claude, Cursor가 여전히 작업을 실행함.
• 오케스트레이션이 아님 — 스티그메르직: 에이전트가 흔적을 남기고, 유용한 것은 강화되며, 오래된 것은 사라짐.

핸드오프 영수증 형식

세션이 끝나면 에이전트는 PR 링크, 병합 SHA, 변경된 파일, 검증 결과, 작업 트리 정리 상태를 포함한 구조화된 응답을 반환합니다. Colony는 이를 하나의 관찰로 캡처하고, 다음 에이전트는 컨텍스트를 재유도하는 대신 이를 읽습니다. mcp_metrics는 비용을 기록합니다.

설치

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

Node 20+ 필요. MIT 라이선스. 모든 데이터는 ~/.colony/data.db에 저장됩니다.

향후 개선 사항

저자는 동일 파일 클레임 충돌을 자동 해결하고, 수정 계획을 출력만 하는 대신 실행하는 colony heal --apply 명령을 작업 중입니다.