TL;DR

이 저장소는 Obsidian vault를 영속 메모리로 사용하는 AI 코딩 에이전트용 템플릿이자 CLI 기반 도구입니다. Claude Code를 중심으로 Codex CLI와 Gemini CLI의 lifecycle hook을 연결해 세션 시작 시 업무 맥락을 불러오고, 대화와 파일 기록을 분류·검증·링크합니다. QMD를 추가하면 로컬 semantic search와 MCP 서버를 통해 다른 저장소에서도 관련 노트를 찾고 기억을 기록할 수 있으며, 미설치 상태에서는 grep과 Obsidian CLI로 동작합니다. Obsidian과 세 에이전트를 이미 사용하고 업무 결정·프로젝트·성과 기록을 Git으로 관리하려는 개발자에게 적합하지만, 개인 vault 운영 규칙과 로컬 Node·QMD 환경을 직접 관리해야 합니다.

핵심 포인트

• 이 저장소는 Obsidian vault를 기반으로 한 AI 코딩 에이전트용 persistent memory 도구입니다. Claude Code를 중심으로 Codex CLI와 Gemini CLI도 지원하며 특정 SDK에 종속되지 않은 Markdown, TypeScript, shell 구조로 작동합니다. Obsidian 1.12+, Node 22+와 Git이 필요하고 QMD는 선택 사항입니다.
• SessionStart hook이 North Star, 활성 프로젝트, 최근 변경 사항, 작업 목록을 주입합니다. UserPromptSubmit은 결정·사고·성과·1:1 같은 내용을 분류하고 PostToolUse는 frontmatter와 wikilink를 검증합니다. 이를 통해 대화 내용을 적절한 노트에 연결하면서 세션 간 업무 맥락을 유지합니다.
• QMD를 설치하면 로컬 embedding, query expansion, reranking을 결합한 semantic search를 사용할 수 있습니다. QMD가 없을 때는 grep과 Obsidian CLI로 자동 전환하며, MCP 서버인 om은 다른 저장소에서도 search, recall, remember, record_work, reason 같은 도구를 제공합니다. 검색 결과와 기록 범위는 프로젝트 식별자와 노출 경로 정책으로 제한됩니다.
• 기본 vault에는 업무·조직·성과·brain·reference 폴더와 18개 slash command, 9개 subagent, Obsidian Bases 뷰가 포함됩니다. /om-standup, /om-dump, /om-wrap-up, /om-review-brief 같은 명령이 일상 기록과 평가 자료 생성을 연결합니다. ShardMind를 이용하면 초기 설정, 선택 모듈, 세 방향 병합 기반 업그레이드를 추가할 수 있지만 clone만으로도 사용할 수 있습니다.