breferrari/obsidian-mind

개요

Obsidian Mind는 Obsidian 볼트 템플릿으로, 개인 지식 기반을 Claude Code, Codex CLI, Gemini CLI와 같은 AI 코딩 에이전트의 장기 기억 저장소로 전환합니다. 이 볼트는 일련의 훅 스크립트, 명령 단축키, 선택적 의미 검색 통합(QMD)을 제공하여 코딩 어시스턴트 세션을 시작할 때마다 에이전트에 North Star 목표, 활성 프로젝트, 최근 git 변경 사항, 열린 작업, 파일 목록이 미리 로드됩니다. 대화하는 동안 에이전트는 회의록, 결정 기록, 인시던트 타임라인, 브래그 문서 항목 등 메모를 자동으로 생성하고 업데이트하며 볼트를 정리합니다.

주요 기능

기능	설명	중요성
세션 간 영구 메모리	SessionStart 훅이 모든 에이전트 대화 시작 시 큐레이팅된 컨텍스트(목표, 프로젝트 상태, 최근 변경 사항)를 주입합니다.	에이전트는 더 이상 빈 상태에서 시작하지 않으며 과거 결정과 진행 중인 작업을 기억합니다.
슬래시 명령 단축키	/om-standup, /om-dump, /om-incident‑capture, /om-wrap‑up 같은 명령이 특정 폴더(사람, 업무, 결정, 브래그 문서 등)에 메모를 생성하거나 업데이트하는 사전 정의된 워크플로를 실행합니다.	한 줄 명령으로 음성 업데이트를 완전히 연결된 마크다운 파일 세트로 전환합니다.
자동 메모 연결 및 검증	사후 도구 훅이 프런트매터를 검증하고, 백링크를 강제하며, 과대한 메모를 분할하고, 잘못 배치된 파일을 표시합니다.	탐색 및 감사가 쉬운 깔끔한 그래프 구조의 지식 기반을 보장합니다.
선택적 QMD 의미 검색	설치 시 QMD는 로컬 임베딩, 쿼리 확장, 재순위화를 제공하여 에이전트가 의미로 메모를 검색할 수 있습니다(예: "캐싱에 대해 무엇을 결정했나요?").	외부 API로 데이터를 보내지 않고 더 빠르고 정확한 검색이 가능하며 오프라인에서도 작동합니다.
Model Context Protocol (MCP) 서버	에이전트의 도구 메뉴에 나타나는 mcp__qmd__* 도구를 노출하여 하위 에이전트가 동일한 검색 기능을 프로그래밍 방식으로 호출할 수 있게 합니다.	나중에 티켓팅, 캘린더 등 MCP 인식 도구를 쉽게 추가할 수 있습니다.
크로스 에이전트 지원	훅 및 명령 파일은 에이전트에 구애받지 않으며, 동일한 볼트가 Claude Code, Codex CLI, Gemini CLI, Antigravity, Grok에서 작동합니다.	지식 기반을 재구축하지 않고도 제공자를 전환할 수 있습니다.
ShardMind 설치 프로그램	shardmind install은 새 볼트를 생성하고, brain/North Star.md를 채우는 마법사를 실행하며, git을 초기화하고, 선택적으로 QMD를 부팅합니다.	원클릭 설정; 일반 템플릿을 선호하는 경우 볼트를 직접 복제할 수도 있습니다.
토큰 효율적 컨텍스트 처리	시작 시 가벼운 발췌문만 주입되고, 전체 노트 내용은 QMD 또는 명시적 읽기를 통해 필요 시 가져옵니다.	대화를 Claude의 토큰 한도 내로 유지하고 비용을 절감합니다.

작동 방식 (개괄)

1. 볼트 구조 – brain/(목표, 주제), work/(프로젝트 노트, ADR), org/people/, perf/Brag Doc.md, thinking/session‑logs/ 같은 핵심 폴더가 영구 데이터를 보관합니다.
2. 훅 – .claude/scripts/의 Node/TypeScript 스크립트(Codex/Gemini에서도 사용)가 정의된 수명 주기 이벤트(SessionStart, UserPromptSubmit, PostToolUse, PreCompact, Stop)에서 실행됩니다. 컨텍스트를 주입하고, 메시지를 분류하며, 쓰기를 검증하고, 하우스키핑을 수행합니다.
3. Claude Code 모드 – 최신 Claude Code 버전의 경우 소규모 플러그인(.claude/skills/obsidian‑mind/)이 모델 내부에서 실행되어 주입된 컨텍스트를 지침 파일로 전달하고 각 턴 후 간결한 "볼트 점검" 보고서를 표시합니다.
4. 의미 검색(선택 사항) – QMD를 설치하면 임베딩이 포함된 로컬 SQLite 저장소가 생성됩니다. 볼트의 .mcp.json은 QMD 쿼리 도구를 등록하며, 에이전트가 직접 또는 훅 생성 프롬프트를 통해 호출할 수 있습니다.
5. 사용자 상호작용 – Obsidian에서 볼트를 열고 Obsidian CLI를 활성화한 다음 선택한 에이전트(claude, codex, 또는 gemini)를 시작합니다. 이후 간단히 대화하면 되며, 슬래시 명령이 위에서 설명한 자동화된 워크플로를 트리거합니다.

일반적인 워크플로

# 1️⃣ 설치 (권장)
npm install -g shardmind
mkdir my‑vault && cd my‑vault
shardmind install github:breferrari/obsidian‑mind

# 2️⃣ Obsidian에서 폴더를 열고 CLI를 활성화합니다 (설정 → 일반)
# 3️⃣ 같은 디렉터리에서 코딩 에이전트를 시작합니다
claude   # 또는 codex / gemini

세션 시작 → /om-standup → 에이전트가 North Star, 최근 git, 작업을 읽음 → 간결한 상태 보고를 받습니다.

회의 후 → /om‑dump "…" → 메모, 결정 기록, 브래그 문서 항목이 자동 생성 및 연결됩니다.

인시던트 → /om‑incident‑capture <slack-url> → 전체 타임라인, 인물 프로필, 근본 원인 분석이 생성됩니다.

하루 마감 → wrap up → 볼트 위생 점검, 인덱스 업데이트, 성과 발견.

대상 사용자

• 소프트웨어 엔지니어 또는 테크니컬 리드로서 이미 AI 코딩 어시스턴트를 사용하고 있으며, 어시스턴트가 프로젝트 기록, 결정, 개인 목표를 기억하길 원하는 사람.
• Obsidian에서 회의록, ADR, 인시던트 보고서를 유지하는 팀으로, 이러한 산출물이 AI에 의해 자동으로 연결되고 검색 가능해지기를 원하는 팀.
• Node 기반 CLI에 익숙하고 더 풍부한 검색을 위해 로컬 의미 검색 엔진(QMD)을 실행할 의향이 있는 모든 사람.

제한 사항 및 고려 사항

• 이 볼트는 독립형 AI가 아닙니다; 외부 코딩 에이전트(Claude Code, Codex, Gemini 등)에 의존합니다.
• QMD는 선택 사항이지만 광고된 "의미 검색" 경험에 필요합니다. 없으면 시스템은 단순 grep으로 대체되며, 여전히 작동하지만 덜 강력합니다.
• 훅 스크립트는 사용자와 동일한 권한으로 실행됩니다. 볼트를 신뢰하기 전에 (특히 Claude Code 모드를) 검토해야 합니다.
• 토큰 예산 처리는 Claude Code의 10k 문자 훅 제한에 맞게 조정됩니다. 다른 에이전트는 제한이 다를 수 있지만, 설계는 합리적인 범위 내에 있습니다.

---

Obsidian Mind는 따라서 AI 코딩 에이전트에게 일반 Obsidian 지식 기반 내에 존재하는 지속적이고 검색 가능한 메모리를 제공하는 구체적이고 재현 가능한 방법을 제공합니다. 대화형 어시스턴트와 엔지니어가 이미 유지 관리하는 구조화된 메모 사이의 격차를 메웁니다.

작동 방식 (개괄)

1. 볼트 구조 – brain/(목표, 주제), work/(프로젝트 노트, ADR), org/people/, perf/Brag Doc.md, thinking/session‑logs/와 같은 핵심 폴더가 영구 데이터를 보관합니다.
2. 훅 – .claude/scripts/의 Node/TypeScript 스크립트(Codex/Gemini에서도 사용)가 정의된 수명 주기 이벤트(SessionStart, UserPromptSubmit, PostToolUse, PreCompact, Stop)에서 실행됩니다. 컨텍스트를 주입하고, 메시지를 분류하며, 쓰기를 검증하고, 하우스키핑을 수행합니다.
3. Claude Code 모드 – 최신 Claude Code 버전의 경우 소규모 플러그인(.claude/skills/obsidian‑mind/)이 모델 내부에서 실행되어 주입된 컨텍스트를 지침 파일로 전달하고 각 턴 후 간결한 "볼트 점검" 보고서를 표시합니다.
4. 의미 검색(선택 사항) – QMD를 설치하면 임베딩이 포함된 로컬 SQLite 저장소가 생성됩니다. 볼트의 .mcp.json은 QMD 쿼리 도구를 등록하며, 에이전트가 직접 또는 훅 생성 프롬프트를 통해 호출할 수 있습니다.
5. 사용자 상호작용 – Obsidian에서 볼트를 열고, Obsidian CLI를 활성화한 다음, 선택한 에이전트(claude, codex, 또는 gemini)를 시작합니다. 이후에는 대화만 하면 됩니다. 슬래시 명령은 위에서 설명한 자동화된 워크플로를 트리거합니다.

일반적인 워크플로

# 1️⃣ 설치 (권장)
npm install -g shardmind
mkdir my‑vault && cd my‑vault
shardmind install github:breferrari/obsidian‑mind

# 2️⃣ Obsidian에서 폴더를 열고 CLI를 활성화합니다 (설정 → 일반)
# 3️⃣ 같은 디렉터리에서 코딩 에이전트를 시작합니다
claude   # 또는 codex / gemini

세션 시작 → /om-standup → 에이전트가 North Star, 최근 git, 작업을 읽음 → 간결한 상태 보고를 받습니다.

회의 후 → /om‑dump "…" → 메모, 결정 기록, 브래그 문서 항목이 자동 생성되고 연결됩니다.

인시던트 → /om‑incident‑capture <slack-url> → 전체 타임라인, 인물 프로필, 근본 원인 분석이 생성됩니다.

하루 마감 → wrap up → 볼트 위생 점검, 인덱스 업데이트, 성과 발견.

대상 사용자

• 소프트웨어 엔지니어 또는 테크니컬 리드로서 이미 AI 코딩 어시스턴트를 사용하고 있으며, 어시스턴트가 프로젝트 기록, 결정, 개인 목표를 기억하길 원하는 사람.
• Obsidian에서 회의록, ADR, 인시던트 보고서를 유지하는 팀으로, 이러한 문서가 AI에 의해 자동으로 연결되고 검색 가능해지기를 원하는 팀.
• Node 기반 CLI에 익숙하고 더 풍부한 검색을 위해 로컬 의미 검색 엔진(QMD)을 실행할 의향이 있는 모든 사람.

제한 사항 및 고려 사항

• 이 볼트는 독립형 AI가 아닙니다; 외부 코딩 에이전트(Claude Code, Codex, Gemini 등)에 의존합니다.
• QMD는 선택 사항이지만 광고된 "의미 검색" 경험에 필요합니다. 없으면 시스템은 단순 grep으로 대체되며, 여전히 작동하지만 덜 강력합니다.
• 훅 스크립트는 사용자와 동일한 권한으로 실행됩니다. 볼트를 신뢰하기 전에 (특히 Claude Code mod) 검토해야 합니다.
• 토큰 예산 처리는 Claude Code의 10k 문자 훅 제한에 맞게 조정됩니다. 다른 에이전트는 제한이 다를 수 있지만, 설계는 합리적인 범위 내에 있습니다.

---

Obsidian Mind는 따라서 AI 코딩 에이전트에게 일반 Obsidian 지식 기반 안에 존재하는 지속적이고 검색 가능한 메모리를 제공하는 구체적이고 재현 가능한 방법을 제공합니다. 대화형 어시스턴트와 엔지니어가 이미 유지 관리하는 구조화된 메모 사이의 격차를 메워줍니다.

요약

Obsidian 볼트에 훅, 슬래시 명령, 선택적 로컬 의미 검색(QMD)을 통해 AI 코딩 에이전트(Claude Code, Codex CLI, Gemini CLI)에 지속적이고 검색 가능한 메모리를 추가하는 Obsidian용 템플릿 볼트입니다.

제목

Obsidian Mind: 당신의 Obsidian 볼트를 AI 코딩 에이전트의 장기 기억으로 전환하기