A self-organizing Obsidian vault that gives AI coding agents persistent memory.
TypeScript ai-agentsclaude-codecodex-cligemini-cliknowledge-managementobsidianobsidian-vaultpersistent-memorysecond-braintemplate
docs: add emojis to translated README subsection headings
Brenno Ferrari3dbf29390060
diff --git a/README.ja.md b/README.ja.mdindex 7bf5be2..5f2ee33 100644--- a/README.ja.md+++ b/README.ja.md@@ -103,7 +103,7 @@ Decision: defer Redis migration. Win: Sarah praised the auth architecture.5. **`brain/North Star.md`**に目標を記入 — これがすべてのセッションの基盤になります6. 仕事について話し始める-### オプション:QMDセマンティック検索+### 🔍 オプション:QMDセマンティック検索ボールト全体のセマンティック検索(ノートのタイトルが「Redis Migration ADR」でも「キャッシュについて何を決めた?」で見つかる):@@ -137,7 +137,7 @@ qmd update && qmd embed**セッションには設計されたライフサイクルがあります。** `SessionStart`フックが自動的にNorth Starの目標、アクティブプロジェクト、最近の変更、未完了タスク、ボールト全体のファイル一覧を注入します — Claudeは白紙からではなく、コンテキストを持ってセッションを開始します。終了時に「wrap up」と言えば、Claudeが`/om-wrap-up`を実行 — ノートの検証、インデックスの更新、記録漏れの実績の発見を行います。285行の`CLAUDE.md`がその間のすべてを統制します:ファイルの配置場所、リンクの仕方、ノートの分割タイミング、意思決定やインシデントの扱い方。-### フック+### 🔗 フック5つのライフサイクルフックが自動的にルーティングを処理します:@@ -152,7 +152,7 @@ qmd update && qmd embed> [!TIP]> ただ話すだけ。フックがルーティングを処理します。-### トークン効率+### ⚡ トークン効率obsidian-mindはボールト全体をコンテキストに読み込み**ません**。階層型ローディングでトークンコストを抑えます:@@ -166,7 +166,7 @@ obsidian-mindはボールト全体をコンテキストに読み込み**ませSessionStartは**軽量なコンテキスト**を読み込みます — 主要ファイルからの短い抜粋、ファイル名、git概要のみで、ノート全体は読み込みません。エージェントはQMDで意味検索してからファイルを読むため、関連する情報のみを取得します。分類フックはメッセージごとに軽量なPython呼び出し1回です。検証フックはMarkdown書き込み時のみ発火し、除外パスはスキップします。-### 他のエージェントでの利用+### 🌐 他のエージェントでの利用obsidian-mindはClaude Code、Codex CLI、Gemini CLIで動作します。`CLAUDE.md`のボールト規約、`.claude/scripts/`のフックスクリプト、`.claude/commands/`の18コマンドはすべてエージェント非依存です — 純粋なMarkdown、Python、シェルでSDK依存はありません。@@ -350,7 +350,7 @@ YAMLフロントマター付きテンプレート。段階的開示のための`## 🔧 同梱内容-### Obsidianスキル+### 🧩 Obsidianスキル[kepano/obsidian-skills](https://github.com/kepano/obsidian-skills)が`.claude/skills/`にプリインストール済み:@@ -360,7 +360,7 @@ YAMLフロントマター付きテンプレート。段階的開示のための`- **json-canvas** — ビジュアル`.canvas`ファイル作成- **defuddle** — WebページからMarkdownへの変換-### QMDスキル+### 🔍 QMDスキル`.claude/skills/qmd/`にあるカスタムスキル。Claudeに[QMD](https://github.com/tobi/qmd)セマンティック検索を積極的に活用するよう教えます — ファイルを読む前、ノートを作成する前(重複チェック)、ノートを作成した後(リンクすべき関連コンテンツの発見)に使用します。diff --git a/README.ko.md b/README.ko.mdindex 473a072..289d9d9 100644--- a/README.ko.md+++ b/README.ko.md@@ -103,7 +103,7 @@ You: "wrap up"5. **`brain/North Star.md`**에 목표를 작성합니다 — 이것이 모든 세션의 기준이 됩니다6. 업무에 대해 이야기를 시작하세요-### 선택 사항: QMD 시맨틱 검색+### 🔍 선택 사항: QMD 시맨틱 검색볼트 전체의 시맨틱 검색을 위해 (노트 제목이 "Redis Migration ADR"이어도 "캐싱에 대해 뭘 결정했지?"를 찾을 수 있습니다):@@ -137,7 +137,7 @@ qmd update && qmd embed**세션은 설계된 생명주기를 따릅니다.** `SessionStart` 훅이 North Star 목표, 활성 프로젝트, 최근 변경사항, 미완료 작업, 전체 볼트 파일 목록을 자동 주입합니다 — Claude는 빈 상태가 아니라 컨텍스트가 있는 상태로 모든 세션을 시작합니다. 마무리할 때 "wrap up"이라고 말하면 Claude가 `/om-wrap-up`을 실행합니다 — 노트 검증, 인덱스 업데이트, 누락된 성과 발견. 285줄의 `CLAUDE.md`가 그 사이의 모든 것을 관리합니다: 파일 배치 위치, 링크 방법, 노트를 분할해야 할 때, 의사결정과 인시던트 처리 방법.-### 훅+### 🔗 훅다섯 개의 생명주기 훅이 라우팅을 자동으로 처리합니다:@@ -152,7 +152,7 @@ qmd update && qmd embed> [!TIP]> 그냥 이야기하세요. 훅이 라우팅을 처리합니다.-### 토큰 효율성+### ⚡ 토큰 효율성obsidian-mind는 전체 볼트를 컨텍스트에 로드하지 **않습니다**. 계층형 로딩으로 토큰 비용을 최소화합니다:@@ -166,7 +166,7 @@ obsidian-mind는 전체 볼트를 컨텍스트에 로드하지 **않습니다**.SessionStart는 **가벼운 컨텍스트**를 로드합니다 — 주요 파일의 짧은 발췌, 파일명, git 요약만 로드하며 전체 노트 내용은 읽지 않습니다. 에이전트는 QMD를 통해 의미 기반 검색 후 파일을 읽으므로 관련 정보만 가져옵니다. 분류 훅은 메시지당 가벼운 Python 호출 1회입니다. 검증 훅은 마크다운 쓰기 시에만 실행되며 제외된 경로는 건너뜁니다.-### 다른 에이전트와 사용하기+### 🌐 다른 에이전트와 사용하기obsidian-mind는 Claude Code, Codex CLI, Gemini CLI에서 작동합니다. `CLAUDE.md`의 볼트 규약, `.claude/scripts/`의 훅 스크립트, `.claude/commands/`의 18개 커맨드는 모두 에이전트 비의존적입니다 — 순수 Markdown, Python, 셸이며 SDK 의존성이 없습니다.@@ -350,7 +350,7 @@ YAML 프론트매터가 포함된 템플릿으로, 각각 점진적 공개를## 🔧 포함 항목-### Obsidian 스킬+### 🧩 Obsidian 스킬[kepano/obsidian-skills](https://github.com/kepano/obsidian-skills)가 `.claude/skills/`에 사전 설치되어 있습니다:@@ -360,7 +360,7 @@ YAML 프론트매터가 포함된 템플릿으로, 각각 점진적 공개를- **json-canvas** — 시각적 `.canvas` 파일 생성- **defuddle** — 웹 페이지를 마크다운으로 추출-### QMD 스킬+### 🔍 QMD 스킬`.claude/skills/qmd/`에 있는 커스텀 스킬로, Claude가 [QMD](https://github.com/tobi/qmd) 시맨틱 검색을 능동적으로 사용하도록 합니다 — 파일을 읽기 전, 노트 생성 전(중복 확인), 노트 생성 후(링크할 관련 콘텐츠 탐색).diff --git a/README.zh-CN.md b/README.zh-CN.mdindex dc4f89d..2df2ee9 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -103,7 +103,7 @@ Decision: defer Redis migration. Win: Sarah praised the auth architecture.5. 在 **`brain/North Star.md`** 中填写你的目标——这将为每次会话定下基调6. 开始谈论工作-### 可选:QMD 语义搜索+### 🔍 可选:QMD 语义搜索用于在仓库中进行语义搜索(即使笔记标题是 "Redis Migration ADR",也能找到 "我们关于缓存做了什么决策"):@@ -137,7 +137,7 @@ qmd update && qmd embed**会话有设计好的生命周期。** `SessionStart` 钩子自动注入你的北极星目标、活跃项目、最近变更、待办任务和完整的仓库文件列表——Claude 每次会话都带着上下文启动,而不是从空白开始。结束时,说 "wrap up",Claude 就会运行 `/om-wrap-up`——验证笔记、更新索引、发现未记录的成就。285 行的 `CLAUDE.md` 规范了中间的一切:文件归档位置、链接方式、何时拆分笔记、如何处理决策和事件。-### 钩子+### 🔗 钩子五个生命周期钩子自动处理路由:@@ -152,7 +152,7 @@ qmd update && qmd embed> [!TIP]> 你只需要正常对话。钩子会处理路由。-### Token 效率+### ⚡ Token 效率obsidian-mind **不会**将整个 vault 加载到上下文中。它使用分层加载来控制 token 成本:@@ -166,7 +166,7 @@ obsidian-mind **不会**将整个 vault 加载到上下文中。它使用分层SessionStart 加载**轻量级上下文** — 关键文件的简短摘要、文件名和 git 摘要,而非完整笔记内容。Agent 通过 QMD 进行语义搜索后再读取文件,因此只获取相关内容。分类钩子每条消息仅执行一次轻量级 Python 调用。验证钩子仅在 markdown 写入时触发,跳过排除的路径。-### 与其他 Agent 配合使用+### 🌐 与其他 Agent 配合使用obsidian-mind 支持 Claude Code、Codex CLI 和 Gemini CLI。`CLAUDE.md` 中的 vault 规约、`.claude/scripts/` 中的钩子脚本、`.claude/commands/` 中的 18 个命令都是 Agent 无关的 — 纯 Markdown、Python 和 Shell,无 SDK 依赖。@@ -350,7 +350,7 @@ templates/ 带有 YAML frontmatter 的 Obsidian 模板## 🔧 包含内容-### Obsidian Skills+### 🧩 Obsidian Skills[kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) 预装在 `.claude/skills/` 中:@@ -360,7 +360,7 @@ templates/ 带有 YAML frontmatter 的 Obsidian 模板- **json-canvas** — 可视化 `.canvas` 文件创建- **defuddle** — 网页到 Markdown 的提取-### QMD Skill+### 🔍 QMD Skill`.claude/skills/qmd/` 中的自定义技能,教会 Claude 主动使用 [QMD](https://github.com/tobi/qmd) 语义搜索——在读取文件之前、在创建笔记之前(检查重复)以及在创建笔记之后(查找应该链接到它的相关内容)。