ブレイン
セッションを超えた永続メモリ。Obsidian Vault は brain/ にあります。
ブレインは全ワークフローの基盤です — すべてのエージェント、スキル、セッションがこれを読みます。品質の低い、または推測による内容は、後続のすべてを劣化させます。何かを追加する前に、自問してください:「これはシステムの動作を本当に改善するか?」。明確な「はい」が答えでなければ、書かないでください。
書き込み前に
まず brain/index.md を読んでください。次に、トピックに対応するエントリポイントを読んでください:
- 原則の更新 →
brain/principles.md - 計画関連のメモ →
brain/plans/index.md
専用のインデックスファイルがまだないディレクトリ(brain/codebase/、brain/audits/)では、近くのファイルを直接スキャンし、可能な限り既存のノートを編集してください。
構造
brain/
├── index.md ← ルートエントリポイント、すべてにリンク
├── principles.md ← principles/ のインデックス
├── todos.md ← プロダクトバックログ
├── vision.md ← エレベーターピッチ + アーキテクチャへのリンク
├── architecture.md ← 完全な技術リファレンス
├── principles/ ← エンジニアリングおよびデザインの原則
├── codebase/ ← プロジェクト固有の知識と落とし穴
├── plans/ ← 番号付き機能計画(02-arrow-bindings/ など)
└── audits/ ← 設計と品質の監査(日付プレフィックス付きファイル名、例:2026-02-20-quality-audit.md)
ルール:
- 1ファイルにつき1トピック。
brain/codebase/noodle-spawn-gotchas.mdのように、巨大ファイルにしない。 - 既存のインデックスエントリポイントを維持:
brain/index.md、brain/principles.md、brain/plans/index.md。 - 新しいトップレベルのカテゴリを導入する場合は、そのカテゴリ用のインデックススタイルのエントリポイントを追加する(リンクのみ、内容はインライン化しない)。
brain/index.mdがルートです。すべてのブレインファイルはそこから到達可能でなければなりません。- ファイル名:小文字、ハイフン区切り。
worktree-gotchas.md。 - 計画ディレクトリ:
brain/todos.mdの todo ID をプレフィックスとして付ける。02-arrow-bindings/の中にoverview.mdとphase-N-*.mdを配置。
Wikilink
形式:[[section/file-name]]。解決順序:同じディレクトリ、次に相対パス、最後に Vault ルート。見出しアンカー([[file#heading]])は解決時に削除されます。
記述スタイル
- 散文よりも箇条書き。前置きは不要。
# タイトルのプレーンマークダウン。Obsidian フロントマターは使用しない。- ノートは約50行以内に収める。それを超える場合は分割する。
書き込み後に
追加または削除したファイルについては brain/index.md を更新してください。該当する場合は、関連するエントリポイント(brain/principles.md、brain/delegation.md、brain/plans/index.md)も更新してください。インデックスはリンクのみでスキャンしやすく保ってください。
耐久性テスト
自問してください:「これを 別の タスクのプロンプトに含めるか?」
- はい →
brain/に書き込む。耐久性のある知識です。 - いいえ、計画固有です → 計画のフェーズドキュメントを更新する。
- いいえ、スキルの問題です → スキルファイルを直接更新する。
- いいえ、フォローアップ作業が必要です →
todoスキルを使用して todo をファイルする。
メンテナンス
- 古くなった、または統合されたノートは削除する。
brain/plans/内のランダムな名前のファイルを削除する — 古い計画モードのアーティファクトです。- 新しいノートを追加する前に、重複するノートをマージする。