여러 코딩 에이전트의 공유 상태 관리 도구

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

여러 코딩 에이전트 사이에서 프로젝트 맥락을 공유하려고 만든 StateRoot는 Rust 단일 바이너리 CLI로 세션 시작 Digest, 단계별 Plan Store, 에이전트 간 Task 위임, Skills와 MCP Config 동기화를 처리합니다. Fable 같은 고성능 모델이 Plan을 세우고 다른 Harness의 저렴한 모델이 실행하도록 역할을 나누며, 작업 트리는 refs/stateroot 아래 Git 객체로 Snapshot해 복원과 Fork를 지원합니다. 정보 출처를 verified, observed, synthesized로 구분해 신뢰 수준을 표시하지만, 현재 Hook과 Session Transfer 지원은 Harness별로 제한적이며 v0.1.5 초기 단계입니다.

실용적 조언

여러 코딩 에이전트를 오갈 때는 Transcript를 매번 붙여 넣기보다 목표, 결정 사항, 다음 작업처럼 짧게 유지할 상태와 장기적으로 재사용할 Rules를 분리하는 방식이 적합합니다. 강한 모델이 승인 가능한 Plan을 만들고 저렴한 모델이 그 Plan만 실행하게 하면 Planning과 Typing에 서로 다른 모델을 배치할 수 있습니다. 다만 실제 적용 전에는 사용하는 Harness의 Hook 시점과 Timeout, Session Transfer 지원 여부를 먼저 확인해야 합니다.
에이전트가 남긴 사실을 그대로 저장하지 말고 Git에서 확인한 정보, Transcript에서 관찰한 정보, LLM이 합성한 정보를 구분해야 합니다. StateRoot처럼 프로젝트 상태를 Markdown, JSONL, Git 객체로 로컬에 보관하면 특정 에이전트나 클라우드 서비스에 종속되지 않고 내용을 직접 확인할 수 있습니다. 작업 트리를 별도 Git 참조에 Snapshot하면 실험적인 복원과 Fork를 실제 개발 Branch와 분리할 수 있습니다.

섹션별 상세

작성자는 여러 agent harness를 번갈아 사용하면서 파일을 다시 읽는 수준을 넘어 코딩 스타일, 규칙, 반복 Workflow, 해결 과정에서 만든 Skills, 작업 Memory까지 공유할 필요를 느꼈고 이를 해결하기 위해 StateRoot를 만들었습니다. StateRoot는 각 Harness의 세션 시작 Hook에서 목표, 현재 Plan, 결정 사항, Memory, 다음 작업을 짧은 Digest로 주입해 Transcript 전체를 복사하지 않도록 합니다. 이 구조는 특정 Harness의 사용량 제한에 걸려도 프로젝트의 작업 맥락을 다시 구성하지 않고 다른 도구로 전환하려는 목적에 맞춰져 있습니다.

작성자는 비싸지만 성능이 높은 Fable 같은 모델이 Planning을 맡고, 다른 Harness의 저렴한 모델이 승인된 Plan을 실행하는 역할 분리를 핵심 기능으로 둡니다. Plan Store는 draft, approved, active, done Lifecycle을 가지며 실행 에이전트에는 다시 계획을 세우는 대신 Plan을 수행하라고 전달합니다. 한 에이전트에서 다른 에이전트의 CLI로 제한된 Task를 위임할 때도 전체 Transcript가 아니라 결론만 돌려받도록 설계했습니다.

StateRoot는 Skills, Rules, MCP Config를 에이전트 사이에서 동기화하고, 한 에이전트가 문제를 해결한 뒤 기록한 내용을 다른 에이전트가 따르도록 합니다. 작업 트리는 Git 내부 기능을 사용해 refs/stateroot 아래에 Snapshot으로 저장되므로 실제 Git Branch를 건드리지 않고 전체 프로젝트 상태를 복원하거나 Fork할 수 있습니다. 각 사실에는 Git에서 확인한 verified, Transcript에서 관찰한 observed, LLM이 만든 synthesized라는 출처 표시가 붙어 도구가 생성한 정보를 그대로 신뢰하지 않도록 했습니다.

작성자는 StateRoot를 Rust로 만든 단일 바이너리 Open Source CLI로 공개했으며 Apache 2.0 License와 v0.1.5라는 초기 상태를 밝혔습니다. 현재 Hook 동작은 Harness마다 차이가 크고 Cursor는 세션 시작 시에만 Context를 주입하며 Hook Timeout 문제로 하루를 소모했다고 했습니다. Session Transfer는 아직 Pi와 DeepSeek Harness에만 기록되므로 여러 실행 환경을 완전히 연결하려면 Harness별 지원 범위를 넓혀야 합니다.

용어 해설

에이전트 실행 프레임워크(Agent Harness): — 코딩 에이전트가 파일을 읽고 명령을 실행하며 작업을 수행하도록 연결하는 실행 환경입니다. 여러 Harness는 서로 다른 모델과 Hook, 세션 상태 저장 방식을 사용하므로 한 도구에서 다른 도구로 옮길 때 작업 맥락이 끊길 수 있습니다.
Git 내부 저장 기능(Git Plumbing): — 사용자용 브랜치 명령보다 낮은 수준에서 Git 객체와 참조를 직접 다루는 기능입니다. StateRoot는 이를 활용해 실제 작업 브랜치와 분리된 refs/stateroot 아래에 작업 트리 상태를 보관하고 복원 또는 분기를 가능하게 합니다.
MCP 설정(MCP Config): — 에이전트가 외부 도구와 데이터에 연결될 때 사용하는 설정 정보입니다. StateRoot는 MCP 설정과 규칙, Skills를 여러 에이전트 사이에서 동기화해 한 도구에서 축적한 작업 방식을 다른 도구에서도 재사용하게 합니다.
JSON Lines(JSONL): — 각 줄을 하나의 JSON 객체로 저장하는 텍스트 형식입니다. StateRoot는 Markdown, JSONL, Git 객체를 로컬에 남겨 에이전트 런타임이나 클라우드 서비스가 없어도 프로젝트 상태를 사람이 읽을 수 있게 유지합니다.

언급된 도구

StateRoot추천링크

여러 코딩 에이전트가 공유하는 프로젝트 상태, Plan, Skills, Rules, Memory를 로컬 파일과 Git 객체로 관리하는 Open Source CLI입니다.

Cursor중립

세션 시작 시 Hook으로 Context를 주입하는 코딩 에이전트 Harness입니다.

Pi중립

현재 State Transfer 기록이 지원되는 코딩 에이전트 Harness입니다.

DeepSeek Harness중립

현재 State Transfer 기록이 지원되는 코딩 에이전트 Harness입니다.

언급된 리소스

GitHubCognizTech/stateroot