ObsidianをAIエージェントの外部記憶として使うためのVault設計
こんにちは、AI実務活用を実践中のHayashiです。
Claude CodeやCodexのようなAIエージェントを使っていると、プロジェクトの前提や過去の判断を毎回説明する場面が出てきます。
たとえば、次のような情報です。
- 前回どこまで作業したか
- なぜその方針にしたか
- ユーザーが好む出力スタイル
- 過去に起きたミスと再発防止策
- 次回の作業開始時に確認すべきこと
これらをチャット履歴だけに置いておくと、セッションが変わったときに文脈が途切れやすくなります。
そこで今回は、Obsidian VaultをAIエージェントの「外部記憶」として使うためのスターター構成を作りました。
この記事では、作成したディレクトリ構成、AIに読ませるルール、セッション開始/終了時のプロンプト、オートメーションへの活用方法をまとめます。
作ったもの
今回作ったのは、obsidian-ai-memory-vault というObsidian Vaultです。
目的は、AIエージェントが次回以降の作業で参照できるように、プロジェクトの状態、判断、知識、ミスをMarkdownとして残すことです。
ディレクトリ構成は以下のようにしました。
obsidian-ai-memory-vault/
00_Index/
Home.md
Video Summary - Claude Obsidian External Memory.md
01_Daily/
2026-05-23.md
02_Projects/
Project Index.md
03_Knowledge/
Knowledge Index.md
04_Decisions/
Decision Index.md
05_Mistakes/
Mistakes Index.md
06_Prompts/
AI Session Start.md
AI Session End.md
Remember This.md
07_Areas/
AI Operating Preferences.md
User Preferences.md
99_Templates/
Daily Note.md
Decision Record.md
Knowledge Note.md
Mistake Record.md
Project.md
AGENTS.md
CLAUDE.md
README.md
Setup Guide.md
Sources.mdobsidian-ai-memory-vault/
00_Index/
Home.md
Video Summary - Claude Obsidian External Memory.md
01_Daily/
2026-05-23.md
02_Projects/
Project Index.md
03_Knowledge/
Knowledge Index.md
04_Decisions/
Decision Index.md
05_Mistakes/
Mistakes Index.md
06_Prompts/
AI Session Start.md
AI Session End.md
Remember This.md
07_Areas/
AI Operating Preferences.md
User Preferences.md
99_Templates/
Daily Note.md
Decision Record.md
Knowledge Note.md
Mistake Record.md
Project.md
AGENTS.md
CLAUDE.md
README.md
Setup Guide.md
Sources.md設計方針
今回の設計では、最初から細かく分類しすぎないことを意識しました。
最小運用では、まず以下の3つだけを回します。
- 01_Daily: 日々の作業ログ
- 04_Decisions: 判断と理由
- 05_Mistakes: ミスと再発防止ルール
02_Projects や 03_Knowledge は、Dailyが増えてから整理しても問題ありません。最初から分類を厳密にしようとすると、ノートを書く前に手が止まりやすくなるためです。
各ディレクトリの役割
00_Index
Vaultの入口です。
AIエージェントには、まず 00_Index/Home.md を読ませます。ここに各Indexへのリンクと、セッション開始時に確認する流れを書いておきます。
01_Daily
日ごとの作業ログです。
AIに「昨日の続き」「前回の続き」を依頼するための入口になります。今回作った 2026-05-23.md には、以下を記録しました。
- ObsidianをAIの外部記憶として使う準備を始めたこと
- Daily、Projects、Knowledge、Decisions、Mistakesの分類を用意したこと
- AGENTS.md と CLAUDE.md を用意したこと
- 最初は完璧な分類より、毎日残すことを優先する方針
02_Projects
プロジェクト単位の現在地を置く場所です。
プロジェクトごとに、目的、現状、制約、次の作業を1ページにまとめます。AIに「このプロジェクトの続き」と言いやすくするためのノートです。
03_Knowledge
再利用できる知識や手順を置きます。
セットアップ手順、コマンド、調査結果、レビュー観点、文章の型など、何度も使う情報をDailyから切り出していく想定です。
04_Decisions
判断の記録を置きます。
「なぜその実装方針にしたのか」「なぜその運用ルールにしたのか」を残しておくと、後からAIと一緒に見直しやすくなります。
05_Mistakes
ミスと再発防止ルールを置きます。
ここは今回の構成で特に重視しました。AIエージェントは、過去の失敗を明示的に読める状態にしておくと、同じミスを避けやすくなります。
記録する内容は以下です。
- 何が起きたか
- 原因
- 修正内容
- 次回の予防ルール
06_Prompts
AIに渡す定型プロンプトを置きます。
今回は以下の3つを作りました。
- AI Session Start.md
- AI Session End.md
- Remember This.md
毎回プロンプトを手で書くのではなく、運用の型としてVault内に置いておくのが目的です。
続きはSubstackの方に無料で掲載中です。
https://open.substack.com/pub/masashihayashi/p/obsidianaivault?r=6j0kcg&utm_campaign=post-expanded-share&utm_medium=web
