업무와 취미 프로젝트 사이에서 저는 Claude Code, Codex CLI, Kiro, 그리고 OpenCode를 사용합니다. 저는 이 도구들을 모두 좋아하며, 각각의 강점과 가용성에 따라 자주 전환하며 사용합니다. 하지만 문제는 항상 동일합니다. 모든 세션이 제로 상태에서 시작된다는 점이며, 각 에이전트(agent)는 서로 다른 파일(.claude.json, .codex/config.toml, 별도의 글로벌 기술(skills), 별도의 글로벌 훅(hooks)...)에 흩어진 고유의 설정(config)을 가지고 있다는 점입니다. 메모리(memory)와 설정(configuration) 중 그 어느 것도 세션을 통해 유지되지 않으며, 팀의 나머지 구성원에게 전파되지도 않습니다.

초기 아이디어는 Karpathy의 "LLM Wiki"에서 영감을 얻었습니다. 에이전트는 정적인 문서 더미에 대해 상태가 없는 RAG(Retrieval-Augmented Generation)를 수행하는 것이 아니라, 사람이 업무 중에 노트를 작성하는 방식처럼 세션이 거듭됨에 따라 스스로 구축하고 관리하는 위키를 가져야 한다는 것입니다. 문제는 에이전트가 마크다운(markdown) 파일을 자유롭게 작성하도록 내버려 두면, 조만간 데드 링크(dead links), 서로를 덮어쓰는 동시 쓰기(concurrent writes), 컨텍스트 손실 등 무언가 망가지게 된다는 점입니다.

저는 이를 해결하기 위해 Cartographer를 작성했습니다. 이는 Go 언어로 작성된 MCP 서버로, 에이전트가 파일에 직접 접근하지 않고 오직 MCP 도구(tools)와만 통신하며, 서버 측에서 불변성(invariants)을 강제합니다(검증, 쓰기당 하나의 git 커밋, 깨진 링크/오래된 주장(stale claims)에 대한 자동 린트(lint), 동시 쓰기에 대한 충돌 처리 등).

하지만 팀 단위에서 가장 강력하다고 생각하는 부분은 따로 있습니다. 지식 베이스(KB)가 단순히 지식만 보유하는 것이 아니라, 기술(skills), 훅(hooks), 그리고 운영 지침(operational instructions)도 보유한다는 점입니다. 그리고 클라이언트(cartographer connect)는 설치된 에이전트가 무엇이든(Claude Code, Codex CLI, Kiro 또는 OpenCode) 해당 에이전트의 네이티브 형식으로 이를 자동으로 구현합니다. 실제 사례를 들면, 기술이나 훅을 한 번만 작성하면 공유 KB를 통해 모든 팀원이 cartographer connect(또는 변경 시 sync)를 실행하여 자신의 에이전트 네이티브 메커니즘(Claude의 경우 settings.json, Codex의 경우 config.toml 등)에 이미 등록된 기술/훅을 즉시 사용할 수 있게 됩니다.

cartographer status는 현재 상태가 지식 베이스(KB)가 배포 중인 내용으로부터 벗어나 있는지 즉시 알려줍니다. 따라서 이것은 "단순한" 에이전트형 위키(agentic wiki)가 아닙니다. 서명된 감사 로그(audit log)를 갖추고 하단에서는 git을 통해 모든 것을 되돌릴 수 있는 상태에서, 이질적인 에이전트 팀(서로 다른 에이전트, 서로 다른 제공자)이 동일한 지식 베이스와 동일한 운영 동작에 맞춰 정렬되도록 유지하는 방법입니다. 내부적으로는 Google Cloud의 OKF (Open Knowledge Format)를 포맷으로 사용하여 종속성(lock-in)이 전혀 없습니다. 단순히 마크다운(markdown) + git 조합이며, Obsidian이나 다른 텍و 에디터로도 열 수 있습니다. 이것은 저의 첫 오픈 소스 프로젝트이며, 저 또한 여전히 많은 것을 배워가는 과정에 있습니다. 하지만 만약 직접 사용해보고 싶으시다면 저에게 큰 의미가 될 것이며, 마음에 드신다면 GitHub에서 스타(star)를 눌러주시면 언제나 감사하겠습니다. 아직 모두 1.0 이전의 베타 버전이므로 다소 거친 부분이 있을 수 있지만, 잠재력이 있다고 생각합니다. 의견이나 비판, 아이디어가 있다면 언제든 이슈(issues)에 남겨주세요. 모든 피드백을 환영합니다. github.com/BeppeTemp submitted by /u/BeppeTemp [link] [comments]