MemoryCustodian

MemoryCustodian은 모든 프로젝트 기억을 docs/memory/에 순수 Markdown으로 저장한다. 즉 소스 코드와 똑같이 검토하고 비교하고 커밋하고 안전하게 되돌릴 수 있으며, 기억이 실제 엔지니어링 결정을 담을 때 바로 이 점이 핵심이다. 무엇도 독점 데이터베이스에 갇히지 않고, 팀원은 코드와 같은 풀 리퀘스트에서 기억 변경을 검토할 수 있다.

전체 이력을 모든 프롬프트에 밀어 넣는 대신, 이 도구는 먼저 manifest.md를 읽고, 다음 brief.md를 읽고, 그다음 매니페스트가 당신의 작업에 지정한 파일만 읽는다. 라우팅은 명시적 작업과 범위 입력을 쓰며, 의미 추측도 LLM 순위 매기기도 없다. 에이전트 컨텍스트 라우팅은 결정론적이고 예측 가능하게 유지된다. 당장의 작업에 맞는 한정된 컨텍스트 팩을 얻는다.

CLI는 고정된 작업 범주를 갖춘다. general, planning, implementation, artifact, preferences, history, maintenance다. read --task implementation을 호출하면 코드 작성에 관련된 기억을 끌어오고, 다른 작업은 넘긴 범위에 따라 다른 조각을 불러온다. --strict-routing 플래그는 범위가 불완전하거나 모호할 때 추측하는 대신 닫힌 쪽으로 실패한다.

활성 기억은 근거로 뒷받침된다. 항목은 MC-DEC-...나 MC-SUBJ-... 같은 안정적인 ID를 받고, 모든 쓰기는 사용자 확인이나 프로젝트 출처가 있어야 실제로 인정된다. 확인되지 않은 에이전트 관찰은 사람이 보증할 때까지 inbox.md에 후보로 남는다. 이 덕분에 유령 규칙이 작업 기억에 들어오지 않고 코드에서도 멀어진다.

망각은 미리보기 우선이고 범위가 정해져 있다. memory-custodian forget은 Plan ID를 출력하고, 삭제 전에 당신이 확인해야 한다. 이 미리보기 단계는 중요하다. 기억 파일은 공유되므로 잘못된 삭제가 모두의 에이전트에 한꺼번에 영향을 줄 수 있기 때문이다. compact 같은 유지보수 명령은 파일을 예산 안에 유지하고 요청 시 가장 오래된 항목을 보관 처리한다. 라우팅, 신선도, 프라이버시, 보안, 충돌을 다루는 점검이 따로 있으며, 기준 브랜치에 대한 Git 병합 인식 검토도 포함된다.

도구 전체가 Python 표준 라이브러리에서 돈다. 서드파티 런타임 의존성이 전혀 없다. 오프라인으로 작동하고 RAG 파이프라인도 벡터 데이터베이스도 필요로 하지 않으므로, 임베딩 지연과 환각 검색을 피한다. 설치는 편집 가능한 pip install 한 번, 또는 함께 제공되는 스크립트 래퍼로 끝난다.