obsidian-mind

obsidian-mind

**「この依頼には、obsidian-mind のどのモードが必要か — インストール、日次セッションループ、記録、レビュー、メンテナンス、マルチエージェント連携、セマンティック検索のどれか？」**が本当の質問である場合に、このスキルを使用します。

obsidian-mind（breferrari/obsidian-mind）は、すぐに使える特定の Obsidian Vaultであり、ゼロから構築する汎用的なパターンではありません。これをクローンするか、shardmind install でインストールすると、5 つのライフサイクルフック、/om-* スラッシュコマンド、分離されたコンテキストウィンドウで動作するサブエージェント、キャリア／パフォーマンスグラフ（コンピテンシーノート、実績記録、レビュー概要）を通じて、コーディングエージェントにセッションをまたいで持続するメモリを提供します。「手続き的なコードが環境を管理し、エージェントがコンテンツを管理する」——フックはコンテキストを決定論的に分類、検証、挿入し、何を書くか、どこに書くかはエージェントが判断します。

毎回、すべてのコマンド、フック、サブエージェントの機能を網羅して示すことが目的ではありません。目的は次のとおりです。

1. 依頼を 1 つのモードに分類する。
2. README に記載されている該当のコマンド、フック、フォルダー、またはインストール手順を示す。
3. 依頼が実際には隣接する別のスキルに属する場合は、適切に案内する。

このスキルを使用する場合

• obsidian-mind Vault のインストールまたは初期設定（ShardMind ウィザード、git clone、GitHub テンプレートのいずれか）
• 日次ループの実行：朝の /om-standup、その場での記録、1 日の終わりの /om-wrap-up
• 分類フックまたは /om-dump、/om-capture-1on1、/om-incident-capture を使い、決定事項、インシデント、1:1、成果を適切な Vault ノートに記録する
• レビューサイクルの準備：/om-self-review、/om-review-peer、/om-review-brief、/om-peer-scan の使用、またはコンピテンシー／バックリンクグラフの確認
• Vault の監査または移行：/om-vault-audit、/om-tidy、/om-vault-upgrade、shardmind adopt
• obsidian-mind を Claude Code、Codex CLI、Gemini CLI、または AGENTS.md を読み取る別のエージェントに連携する
• オプションの QMD セマンティック検索レイヤー（qmd CLI、.mcp.json、om MCP サーバー）のセットアップまたは説明

このスキルを使用しない場合

• 汎用的な Obsidian Vault、プラグイン開発、CLI 自動化、JSON Canvas、または Bases のパターンを求めていて、obsidian-mind 固有の仕組みを必要としていない場合 → obsidian-second-brain の、 このリポジトリの Obsidian 関連スキルはテンプレート固有であるという注記を案内するか、いずれのスキルも使わず通常の Obsidian に関する質問として対応します
• Karpathy の LLM-Wiki パターン（追記ではなくページの書き換え、矛盾の調整、リサーチツールキット、思考ツールパネル）に基づく自己書き換え型 Vault を求めていて、obsidian-mind のキャリア／パフォーマンスグラフを重視していない場合 → obsidian-second-brain（別の上流プロジェクト、akillness/obsidian-second-brain）を使用します。2 つの Vault テンプレートを混同しないでください
• Obsidian Vault テンプレート、フック、スラッシュコマンドを使わず、index.md／log.md を備えたシンプルな raw/ + wiki/ の Markdown ナレッジベースを求めている場合 → llm-wiki を使用します
• 個人用／キャリア用の Obsidian Vault ではなく、単一のコードベースに限定した CLI 中心のアクティブなプロジェクト／リポジトリのメモリ（決定ログ、マニフェスト、引き継ぎメモ）を求めている場合 → opencontext を使用します
• Lapian Notes／ショットごとの映画分析について質問している場合 → それは lapian-notes であり、無関係な動画分析ツールです。エージェントメモリシステムではありません

案内の前にフォルダー構成全体を確認する必要がある場合は、references/vault-structure.md を読んでください。

手順

ステップ 1：リクエストを 1 つのモードに分類する

回答する前に、メインモードを 1 つだけ選んでください。

モード	次のようなことをユーザーが求めている場合に選択
install	vault を初めてインストール／セットアップする、またはアップグレード／移行する
daily-session	朝会 → 作業 → 振り返りを行う、またはライフサイクルフックについて理解する
capture	決定事項、インシデント、1:1、成果、または自由形式のブレインダンプを記録する
review	パフォーマンスグラフを基に、自己評価、ピアレビュー、またはレビュー概要を準備する
maintenance	vault のコンテンツを監査、整理、または移行する
multi-agent	obsidian-mind を Claude Code、Codex CLI、Gemini CLI、または別のエージェントに接続する
qmd	オプションのセマンティック検索をセットアップまたは説明する

モードを明示してください。例："install → ShardMind ウィザード" または "capture → /om-dump"

ステップ 2：インストール／セットアップ（モード install）

同じ vault を作成する、サポート対象の方法が 2 つあります。

# Recommended: ShardMind wizard
npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

shardmind install は現在のディレクトリに書き込みます。必ず最初に新しいフォルダーを mkdir で作成し、cd してください。ウィザードでは、名前、組織、vault の目的、含めるエージェント、QMD を使用するかどうかを確認し、その後 brain/North Star.md を個別設定します。

# Direct clone (no wizard, no .shardmind/ sidecar)
git clone https://github.com/breferrari/obsidian-mind.git

どちらの方法でも、最後に次の 4 つの手順を行います。

1. インストールしたフォルダーをObsidian vaultとして開く
2. Settings → General で Obsidian CLI を有効にする（Obsidian 1.12+ が必要です）
3. vault ディレクトリでエージェントを実行する：claude、codex、または gemini
4. 仕事について話し始める

要件（尋ねられた場合は、以下を正確に伝えてください）：Obsidian 1.12+、AI コーディングエージェント（Claude Code は完全サポート、Codex CLI または Gemini CLI）、フックスクリプト用の Node 22+ LTS、Git、および任意で QMD。

インストールの詳細、アップグレード（git pull、フォークのマージ、shardmind adopt）、および /om-vault-upgrade による移行については、references/install-and-agent-wiring.md を参照してください。

jeo ランタイムでの vault の場所。 このリポジトリのインストールガイド （setup-all-skills-prompt.md、ステップ 3e）では、obsidian-mind の配置先をホームディレクトリ内の 1 つのクローンに固定していません。vault はプロジェクト単位で、実行時に次の順序で解決されます： $OBSIDIAN_MIND_VAULT → 現在のディレクトリの git rev-parse --show-toplevel → どの Git リポジトリの外にいる場合は ~/vaults/obsidian-mind。 つまり、作業中のリポジトリ自体が vault であり、llm-wiki は brain/、org/、perf/ の隣に置かれるのではなく、 <vault>/llm-wiki/ の下に配置されます。専用の個人用 vault を使う場合は、 OBSIDIAN_MIND_VAULT を設定して上書きしてください。

ステップ 3：毎日のセッションループを実行する（モード daily-session）

Morning:      /om-standup   → North Star, active projects, open tasks, recent changes
Throughout:   talk naturally; UserPromptSubmit hook classifies + routes each message
Big dumps:    /om-dump      → narrate everything at once, agent files it all
End of day:   "wrap up"     → runs /om-wrap-up: verifies notes, updates indexes, spots wins
Weekly:       /om-weekly    → cross-session synthesis + North Star alignment

5 つのライフサイクルフックにより、これらの処理が自動化されます：SessionStart（コンテキストの注入）、UserPromptSubmit（分類とルーティングのヒント）、PostToolUse（.md の書き込み後に frontmatter／wikilink を検証）、PreCompact（セッションのトランスクリプトをバックアップ）、Stop（整理のチェックリスト）。フックの全一覧とトークン予算の段階設定、および /om-* コマンドの完全な一覧は、references/session-lifecycle-and-commands.md を参照してください。

ステップ 4：記録内容を振り分ける（モード capture）

手動でフォルダーを選ばせないでください。コマンドを伝え、分類フックに保存先を確認させてください。

内容	コマンド／保存先
会議、決定事項、成果の自由形式の振り返り	/om-dump
特定の 1:1 のトランスクリプト	/om-capture-1on1 → work/1-1/<Person> YYYY-MM-DD.md
インシデント（多くの場合、Slack のリンクが起点）	/om-incident-capture → slack-archaeologist + people-profiler サブエージェント、タイムライン + RCA + perf/Brag Doc.md のエントリー
単独で記録する価値のある決定事項	該当する work/ ノートの Decision Record テンプレート
レビュー時期に備えて記録しておきたい成果	perf/Brag Doc.md（brag-spotter サブエージェントが未記録の成果も見つけます）

サブエージェントの全一覧とパフォーマンスグラフの仕組みについては、references/capture-and-review-routes.md を参照してください。

ステップ 5：レビューサイクルのリクエストをルーティングする（モード review）

/om-self-review    → self-assessment: projects, competencies, principles
/om-review-peer     → peer review: projects, principles, performance summary
/om-review-brief     → full review brief (manager or peer), evidence pre-linked
/om-peer-scan       → deep-scans a colleague's GitHub PRs into perf/evidence/

これらはパフォーマンスグラフを読み取ります。perf/competencies/ 内のコンピテンシーノートがリンク先となり、作業ノートから ## Related の下にリンクします。バックリンクは証拠として自動的に蓄積され、review-prep と review-fact-checker のサブエージェントが集約・検証します。詳細は references/capture-and-review-routes.md をご覧ください。

ステップ 6：メンテナンス／移行をルーティングする（モード maintenance）

/om-tidy          → acts on every hygiene flag: archive, group, split — never deletes, never commits
/om-vault-audit    → orphan notes, broken links, stale content
/om-vault-upgrade  → migrate an older/other vault into the current template (supports --dry-run)
shardmind adopt github:breferrari/obsidian-mind   → adopt an existing v5.x clone into managed v6, no re-clone

/om-vault-upgrade は obsidian-mind に限らず、あらゆる Obsidian ボルトで動作します。バージョンを検出してファイルを一覧化し、移行計画を提示します。実行するのは承認後のみで、ソースボルトが変更されることはありません。手順全体は references/install-and-agent-wiring.md をご覧ください。

ステップ 7：対象エージェントを接続する（モード multi-agent）

エージェント	対応状況
Claude Code	完全対応 — フック、コマンド、サブエージェント、メモリーシステムがそのまま動作します
Codex CLI	AGENTS.md をネイティブに読み込みます。.codex/hooks.json のフック設定で同じフックスクリプトを接続します。コマンドは / プレフィックスなしの通常のプロンプトとして実行します（例：om-standup）
Gemini CLI	GEMINI.md をネイティブに読み込みます。.gemini/settings.json のフック設定で、Gemini のイベント名を共有フックスクリプトに対応付けます
その他のエージェント（Cursor、Windsurf、GitHub Copilot、JetBrains AI）	ボルトの規約を確認するには AGENTS.md を読み込みます。フックのサポート状況はエージェントによって異なります

~/.claude/ の自動メモリーローダー（MEMORY.md）だけが Claude Code 固有です。これはボルト内の場所を指すインデックスであり、保存先そのものではありません。フック、コマンド、サブエージェントのプロンプト、brain/ のメモリーは、SDK に依存しないエージェント共通の Markdown／TypeScript／シェルで構成されています。om MCP サーバー（search、expand、recall、remember、record_work、reason、health）を介したリポジトリ間アクセスについては、references/install-and-agent-wiring.md をご覧ください。

ステップ 8：オプションの QMD セマンティック検索について説明する（モード qmd）

npm install -g @tobilu/qmd
node --experimental-strip-types .scripts/qmd-bootstrap.ts
qmd --index obsidian-mind query "what did we decide about caching"
qmd --index obsidian-mind update   # after bulk edits
qmd --index obsidian-mind embed    # after many new notes

厳密には QMD はオプションです。QMD がなくても、ボルトは grep と Obsidian CLI にフォールバックします。ただし、サブエージェント（context-loader、review-prep、brag-spotter）は、より的確なコンテキストを得るため、まず QMD を参照します。また、QMD は MCP サーバーとして登録されるため、mcp__qmd__query／get／multi_get がエージェントのネイティブツールとして利用できます。API キーやクエリごとの費用は不要で、3 つの小規模なローカルモデル（embeddinggemma-300M、qmd-query-expansion-1.7B、Qwen3-Reranker-0.6B）を実行します。

例

例 1：初回インストール

入力：「コーディングエージェントが作業内容を記憶できるよう、obsidian-mind をセットアップしてください。」 出力の概要： モード install。npm install -g shardmind → 新しい mkdir／cd → shardmind install github:breferrari/obsidian-mind を推奨します。ウィザードで North Star.md が個人向けにカスタマイズされることを説明します。ボルトを開く／CLI を有効にする／エージェントを実行する／会話を始める、という 4 ステップで完了します。ウィザードを使わない方法として git clone も案内します。

例 2：日々のルーティン

入力：「朝と一日の終わりには、何を実行すればよいですか？」 出力の概要： モード daily-session。朝に /om-standup を実行し、日中は自然に話しかけます（分類フックが内容をルーティングします）。大きな振り返りには /om-dump を使い、「wrap up」と伝えて /om-wrap-up を起動し、定期的に /om-weekly を実行します。

例 3：レビューシーズン

入力：「来週、パフォーマンスレビューがあるので、自己評価と、レビューを担当する同僚のための証拠が必要です。」 出力の概要： モード review。自己評価には /om-self-review を使います。/om-peer-scan で同僚の GitHub PR の証拠を perf/evidence/ に取り込み、/om-review-brief（マネージャー向けまたは同僚向けの形式）で、コンピテンシーのバックリンクをもとに包括的なブリーフを作成します。

例 4：該当しない場合 — 汎用的な自己書き換え型 Wiki

入力：「新しいソースが追加されるたびに、関連ページを書き換えて矛盾を自動的に調整する保管庫が欲しいです。キャリアの追跡には関心がありません。」 **出力の概要：**これは obsidian-mind のセッションフック＋パフォーマンスグラフモデルではなく、obsidian-second-brain の書き換え型（追記型ではない）／LLM Wiki の進化モデルだと認識し、無理にこのスキルを適用せず、そちらへ案内してください。

ベストプラクティス

1. 回答する前に、モード（install、daily-session、capture、review、maintenance、multi-agent、qmd）を 1 つ指定してください。質問ごとにコマンド表全体を提示しないでください。
2. スクレイピングした README またはリンク先ページに記載されていないコマンド、フック、フォルダー、サブエージェント名を決して作り出さないでください。記憶ではなく、ソース資料で確認してください。
3. obsidian-mind は特定の保管庫テンプレートとして扱い、汎用的な「Obsidian＋AI メモリ」パターンとして扱わないでください。obsidian-second-brain とは明確に区別してください。
4. 「どこかに保存する」のような曖昧な指示ではなく、メモの保存先となる正確なフォルダー（work/active/、org/people/、perf/competencies/、brain/）を示してください。
5. QMD はオプションであることを忘れないでください。QMD がなくても、保管庫は grep＋Obsidian CLI で問題なく機能します。
6. 汎用的な保管庫作業、Karpathy 風の Wiki、リポジトリ単位のプロジェクトメモリ、または Lapian Notes のような無関係な内容の依頼には、早めに正直に別の案内先へ誘導してください。

参考資料

• references/install-and-agent-wiring.md — ShardMind と git clone によるインストール、要件、アップグレード／導入、/om-vault-upgrade、マルチエージェントの接続、om MCP サーバー
• references/session-lifecycle-and-commands.md — 5 つのライフサイクルフック、/om-* コマンドの全一覧、トークン効率の段階
• references/capture-and-review-routes.md — サブエージェント一覧、パフォーマンスグラフの仕組み、Bases
• references/vault-structure.md — 保管庫のフォルダー構成全体、テンプレート、カスタマイズ箇所
• obsidian-mind README （このスキルのスクレイピング元となる信頼できる情報源）