분산된 학습 데이터 통합, AI 전용 지식 저장소 Vault 설계 전략

Context

학습 노트, 코드 저장소, AI 대화 이력이 각각 독립된 데이터 사일로로 존재. AI 어시스턴트가 로컬 자원에 직접 접근하지 못해 매번 수동으로 컨텍스트를 제공하는 번거로움 발생. 업데이트가 빠른 코드 저장소와 지식 간의 동기화 오류 및 공유 한계 직면.

Technical Solution

• AI가 즉시 이해 가능한 통합 지식 저장소 추상화 레이어인 Vault 시스템 도입
• 일반 폴더, 코드 참조(coderef), Obsidian 노트, 시스템 관리형의 4가지 Vault 타입 정의를 통한 유스케이스별 최적화
• 코드 학습 전용 coderef 타입에 표준화된 디렉토리 구조와 AI 판독 가능 메타데이터 설계
• 별도의 DB 의존성 없이 JSON 파일 기반의 VaultRegistryStore를 구축하여 설정의 단순성과 디버깅 편의성 확보
• 읽기 전용 및 쓰기 가능 권한을 구분하여 AI 프롬프트에 자동으로 컨텍스트를 주입하는 buildTargetVaultsText 로직 구현
• 사용자 개입 없이 AI가 가용 학습 자원을 스스로 인지하는 암묵적 이해 구조 설계

Key Takeaway

복잡한 데이터 통합 문제의 핵심은 기술적 정교함보다 AI가 이해할 수 있는 단순하고 명확한 추상화 레이어를 구축하는 설계 원칙에 있음.