Your AI Coding Agent Forgets Everything — Fix It With a Free Obsidian Vault

개요

AI 코딩 에이전트의 세션마다 발생하는 정보 망각 문제를 해결하기 위해, Obsidian Vault를 활용하여 영구적인 기억 저장소와 자가 검증 메커니즘을 제공하는 방안이 제시되었습니다.

주요 내용

* AI 코딩 에이전트의 망각 문제: AI 코딩 에이전트는 매 세션마다 이전 작업 내용, 개발 선호도, 결정 사항 등 과거 세션의 지식을 잊어버려 반복적인 설명이 필요합니다.
* Verified Memory Vault 소개: 이는 Obsidian Vault를 기반으로 AI 에이전트에게 지속적인 기억 저장 공간을 제공하며, 기억의 건강성을 검증하는 메커니즘을 포함합니다.
* Vault 구조:
* 00_Inbox: 모든 새로운 정보가 우선적으로 저장되는 곳 (분류 없이 수집).
* 01_Daily: 세션별 진행 상황, 결정 사항, 차단된 문제 등을 기록하는 일일 노트.
* 02_Templates: 일일 노트 작성을 위한 영어 및 독일어 템플릿.
* CLAUDE.md: 에이전트가 세션 시작 시 읽는 부트 파일로, 규칙 및 메모리 프로토콜 포함.
* MEMORY.md: 날짜별로 기록되는, 수정 불가능한 영구 기억 저장소.
* 자가 검증 메커니즘:
* memory_check.py: 메모리 상태를 점수화하고 프로토콜 위반, 링크 오류, 불필요한 정보 증가, 인박스 압박 등의 문제를 보고합니다.
* memory_guard.py: Git pre-commit 훅으로, 에이전트의 기억(MEMORY.md) 삭제를 방지합니다.
* 운영 규칙:
* 수집, 분류 금지: 새로운 정보는 인박스에 저장하고, 분류는 일일 노트 작성 시 진행합니다.
* 세션별 일일 노트: 다음 세션이 이전 상태를 기억하도록 각 세션마다 일일 노트를 작성합니다.
* 영구 사실 승격: 향후 세션에서 중요할 사실은 날짜별, 한 줄로 MEMORY.md에 기록하고 수정하지 않습니다.
* 설정 및 사용: Obsidian 설치 후 Vault를 폴더로 열면 10분 안에 설정이 완료되며, Claude Code는 자동 인식하고 다른 에이전트는 CLAUDE.md를 부트 파일로 지정하거나 복사하여 사용합니다. 세션 종료 시 일일 노트 작성, 영구 사실 승격, 메모리 체크를 수행합니다.
* 특징 및 비특징: 플러그인 수집, 벡터 데이터베이스, 자율 시스템, 코드 리포지토리 대체가 아니며, 유지보수가 필요 없고 10분 안에 감사 가능한 구조입니다.
* 라이선스: CC BY 4.0 라이선스를 적용하여 상업적 이용을 포함한 자유로운 사용 및 재배포가 가능하며, 출처 표기만 요구됩니다.

시사점

Verified Memory Vault는 AI 코딩 에이전트의 정보 지속성 문제를 해결하여 개발 생산성을 향상시키고, CC BY 4.0 라이선스를 통해 다양한 환경에서 자유롭게 활용될 수 있는 기반을 마련합니다.