Skip to content

A self-organizing Obsidian vault that gives AI coding agents persistent memory.

docs: add emojis to translated README subsection headings

Brenno Ferrari3dbf29390060
diff --git a/README.ja.md b/README.ja.md
index 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.md
index 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.md
index 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) 语义搜索——在读取文件之前、在创建笔记之前(检查重复)以及在创建笔记之后(查找应该链接到它的相关内容)。