클로드 코드와 옵시디언으로 자기 개선 지식 시스템 구축하기

아키텍처 개요

한 개발자가 Claude Code의 세션 건망증 문제를 해결하기 위해 25개의 자동화 도구를 매시간 실행하는 자가 개선 지식 시스템을 만들었습니다. 이 시스템은 로컬 시맨틱 검색, 지식 그래프, 자동화된 처리를 통해 Claude Code를 Obsidian 볼트(~350개 노트)에 연결합니다.

기술 스택

• Obsidian 볼트를 지식 저장소로 사용
• Claude Code (Opus)를 볼트를 읽고 쓰는 AI로 사용
• Ollama + bge-m3 (1024차원 임베딩, RTX 3080) 로컬 시맨틱 검색
• SQLite (better-sqlite3) 검색 인덱스, 그래프 DB, 코드베이스 인덱스
• Express 서버 React 대시보드용
• 2개의 MCP 서버 Claude에 네이티브 볼트 + 그래프 액세스 제공
• Windows 작업 스케줄러 모든 것을 매시간 실행

도구 계층 및 기능

계층 1: 데이터 수집

• vault-live-sync.mjs: Claude Code JSONL 세션을 실시간으로 감시하고 Obsidian 노트로 변환
• vault-sync.mjs: Supabase 통계, AutoPost 상태, git 활동, 프로젝트 컨텍스트의 매시간 동기화
• vault-voice.mjs: Whisper 음성 인식 + Sonnet 오디오 파일 요약을 통한 음성-볼트 변환
• vault-clip.mjs: RSS 피드 + Brave Search 주제 모니터링 + AI 요약을 통한 웹 클리핑
• vault-git-stats.mjs: 커밋 스트릭, 파일 핫스팟, 시간별 분포를 포함한 Git 메트릭

계층 2: 처리 및 지능

• vault-digest.mjs: 모든 세션을 하나의 가독성 있는 페이지로 집계하는 일일 다이제스트
• vault-reflect.mjs: Sonnet을 사용하여 세션에서 주요 결정을 추출하고 MEMORY.md로 자동 승격
• vault-autotag.mjs: Sonnet이 태그 + 위키링크 연결을 제안하는 AI 자동 태깅
• vault-schema.mjs: 10개 노트 유형, 준수 보고, 자동 수정 모드를 갖춘 프론트매터 검증기
• vault-handoff.mjs: 기계 판독 가능한 handoff.json 생성 (마크다운보다 압축에서 더 잘 유지됨)
• vault-session-start.mjs: 새로운 Claude 세션을 위한 최적의 컨텍스트 패키지 구성

계층 3: 검색 및 검색

• vault-search.mjs: FTS5 + 청크 시맨틱 검색 (512자 청크, bge-m3 1024차원). 플래그: --semantic, --hybrid, --scope, --since, --between, --recent. 검색 로깅 + 히트 맵 포함.
• vault-codebase.mjs: 2,011개 소스 파일 색인화: 내보내기, 경로, 가져오기, JSDoc
• vault-graph.mjs: 375개 노드, 275개 엣지, 매개 중심성, 커뮤니티 감지, 링크 제안을 갖춘 지식 그래프
• vault-graph-mcp.mjs: 6개 도구(검색, 이웃, 경로, 공통, 브리지, 커뮤니티)를 갖춘 MCP 서버로서의 그래프, Claude가 네이티브로 사용 가능

계층 4: 자가 개선

• vault-patterns.mjs: 주간 패턴: 모멘텀 점수(1-10), 프로젝트 주의도 %, 속도 추세, 토큰 소모($), 정체 감지, 좌절/에너지 추적, 번아웃 위험
• vault-spaced.mjs: 간격 반복(FSRS) 348개 노트 추적, 우선순위 기반 검토 일정
• vault-prune.mjs: 핫/웜/콜드 감쇠 점수, 오래된 노트 자동 아카이브, 검색되지 않은 노트 플래그 지정
• vault-contradict.mjs: 규칙 기반(오래된 참조, 메트릭 드리프트, 날짜 충돌) + AI 기반(Sonnet 관련 문서 비교) 모순 감지
• vault-research.mjs: Brave Search + Sonnet을 통한 자율 연구, 예약된 주제 모니터링

계층 5: 시각화 및 모니터링

• vault-canvas.mjs: 지식 그래프에서 Obsidian Canvas 파일 자동 생성 (5가지 모드: 전체 맵, 프로젝트별, 허브 중심, 커뮤니티, 일일)
• vault-heartbeat.mjs: 모든 서비스에서 상태를 수집하고 Sonnet을 사용하여 주의가 필요한 사항을 추론하는 사전 대응 에이전트

이 시스템은 4개의 상호 연결된 프로젝트를 운영하고, 64K 비즈니스 리드를 관리하며, 매주 수백 건의 Claude Code 세션을 진행하는 솔로 개발자 대행사 소유자가 구축했습니다. 모든 도구는 저장소에 이미 있는 것 외에 외부 종속성이 없는 Node.js ES 모듈입니다.