hdknr blog

Obsidian Vault Writeback Loop

AI Agent と個人ナレッジを循環させる設計パターン。Vault から AI に文脈を渡し、得た学びを Vault に書き戻すループを構成する

概要

Obsidian Vault Writeback Loop は、AI Agent が個人ナレッジ（Obsidian Vault）を 読み取るだけでなく、得た学びをそこに書き戻して自己強化する 循環設計パターン。GitHub リポジトリに閉じた知識管理（プロジェクト型）に対して、Vault を中心に据えたネットワーク型のナレッジ管理を、Claude Code のフック・スキル・MCP・GitHub Actions self-hosted runner を組み合わせて実装する。

4 つの構成レイヤー

レイヤー役割主な構成要素
読み取りVault → AI Agent への文脈供給symlink (.claude/knowledge/) + 読み取り用 MCP (vault-readonly)
書き戻し設計AI Agent → Vault inbox への安全な投入書き込み用 MCP (vault-inbox)、inbox-first 原則
書き戻しトリガいつ書き戻すかの発火制御Claude Code hooks（PostToolUse / Stop / SessionEnd）、Git post-merge
昇格inbox → Vault 本体への統合人間による週次レビュー（4 択フロー: 昇格 / 追記 / 保留 / 破棄）

設計原則

  1. AI に Vault 正本を直接書かせない: リンク構造を壊さないよう、inbox/ にしか書かない
  2. 読み取り MCP と書き込み MCP をサーバ単位で分離: @modelcontextprotocol/server-filesystem は引数で渡したディレクトリしか公開しないため、サーバを分けるだけで構造的な物理隔離になる
  3. CLAUDE.md には安定パス（.claude/knowledge/）を書く: Vault の生パスをコミットしない
  4. 昇格判断は人間に残す: AI に自動昇格させると Vault が壊れる
  5. 書き戻し対象はリポジトリに収まらない知見だけ: コードや設計書はリポジトリの docs/ に置く

自動化レイヤーの段階導入

  1. Claude Code PostToolUse フック — gh pr merge 直後に書き戻しを促す
  2. Claude Code Stop フック — Daily Note の器を自動作成
  3. Git post-merge フック — GitHub UI マージ派の取りこぼし回収
  4. Self-hosted runner + GitHub Actions — マシン起動中なら必ず走る最後の砦（Vault・Skills・MCP がフル活用可能）

cloud-hosted Actions は Vault に書けない・Skills が使えない・会話文脈ゼロという三重苦のため、書き戻し用途では self-hosted runner に切り替えるのが正解。

派生形：継続入力ループ（LINE × Codex × Cloudflare）

書き戻しループと対をなすのが、入力側を摩擦ゼロにして「読んだ気づきを次のインプットに変える」継続入力ループ（Continuous Input Loop）。8ステップで構成される。

  1. LINE に気になった URL・思いつきを投げる（入力の入口を1つに統一）
  2. LINE Notes Sync（Obsidian コミュニティプラグイン）が LINE メッセージを Vault へ同期
  3. Obsidian に Markdown として蓄積
  4. Codex Automation（OpenAI Codex）が溜まったメモをトリガーに自動で深掘り・要約
  5. 結果を HTML 化
  6. Cloudflare Pages にデプロイ（Zero Trust Access で認証をかければ非公開の下書き置き場に向く）
  7. スマホで読む
  8. 読んで得た気づきを再び LINE へ → 1 に戻る

この設計の肝は、単に「メモを自動要約する」で終わらせず、アウトプットを読んだ気づきを次のインプットに変える導線にある。ツール自体は既存の組み合わせで、特別なインフラの新規構築は要らない。書き戻しループ（AI → Vault）が「知識を積み上げる」方向なら、継続入力ループ（人 → Vault → AI → 人）は「気づきを回し続ける」方向で、両者は補完関係にある。

なぜループを閉じることが重要か

読み取り側だけ設定しても、Vault は「過去の自分のノート集」のスナップショットに固定される。書き戻し側を実装して初めて、AI Agent が「3 ヶ月前に別プロジェクトで試したあの技術、いまのバグに応用できるか？」という プロジェクトを跨いだ伏線回収 を提案できるようになる。Vault が時間とともに自己強化される構造は、ループを閉じた瞬間に立ち上がる。

関連ページ

ソース記事