프로젝트 원장: AI 코딩 에이전트를 위한 인간 참여형 메모리 시스템

project-ledger라는 GitHub 프로젝트는 AI 코딩 에이전트가 여러분의 코드베이스에 대해 기억하는 내용을 관리하기 위한 인간 중심 시스템을 제공합니다. 이 시스템이 해결하는 핵심 문제는 다음과 같습니다: 에이전트는 무엇이 중요한지 판단할 수 없습니다—구현 버그와 아키텍처 결함을 동일하게 취급하며, 중요한 것보다는 자신이 변경한 내용을 기록합니다.

작동 방식

이 시스템은 세 가지 주요 구성 요소를 가지고 있습니다:

• 구조화된 항목을 포함하는 YAML 원장으로, 요약, 신뢰도 수준, 태그 및 상호 참조를 포함합니다
• /ledger 스킬은 항목을 게시하고 자동으로 Haiku 감사관을 생성하여 냉정하게 검토합니다
• UserPromptSubmit 훅은 모든 프롬프트에 대해 TF-IDF 검색을 실행하고 에이전트가 사고를 시작하기 전에 일치하는 항목을 자동으로 주입합니다

이 훅은 매우 중요합니다—이것 없이는 그저 YAML을 허공에 작성하는 것과 같습니다. 출처에서 언급된 대로: "에이전트는 요청 없이는 절대 참조 문서를 읽지 않습니다—이 훅은 모든 프롬프트에서 실행되며, 원장을 검색하고 에이전트가 사고를 시작하기 전에 관련 항목을 주입합니다."

실용적인 예시

창작자는 실제 사용 사례를 설명합니다: 임베디드 프로젝트에서 색상 렌더링 문제를 수정한 지 몇 주 후, 그들은 에이전트에게 "우리가 이전에 이 문제를 고친 내용을 기억하나요?"라고 물었습니다. 훅은 낮은 값에서 8비트 양자화가 색상 충실도를 저하시킨 정확한 항목을 표면화했으며, 여기에는 근본 원인, 임계값 및 영향을 받는 구성 요소가 포함되었습니다.

비교 및 접근 방식

OpenViking과 비교했을 때, 이 시스템은 수동 작업이 필요하지만 더 간단한 아키텍처를 가지고 있습니다: 백엔드 없이 YAML 파일과 셸 훅만으로 구성됩니다. 이 철학은 통찰을 얻기 어려운 프로젝트의 경우, 인간이 무엇이 계속 전달될지 결정해야 한다는 것입니다.

이 시스템은 AI 에이전트가 코드베이스에서 작동할 때 기술 부채가 누적되는 것을 방지하도록 설계되었습니다—각 변경은 무엇이 중요한지에 대한 적절한 컨텍스트 없이는 올바르게 수행하기가 점점 더 어려워집니다.