mcpField
B
brain

brain

github.com/potetoエージェントワークフロー564233 回インストール32 週間前に更新
リポジトリ

brain について

brain は、Obsidian vault にプロジェクトの知識を整理し、セッションをまたいで保持するスキルです。簡潔でリンク可能なノートを管理するエージェントやセッション向けに、記録内容の選別と索引の保守ルールを定めています。

主な機能

  1. 01セッションをまたぐ永続メモリ
  2. 02Obsidian vault の構成
  3. 03トピック別ノートとリンク索引
  4. 04価値ある知識を選ぶルール

活用シーン

  1. 01セッション間でプロジェクトの文脈を保持
  2. 02エンジニアリング原則やコードベースの知見を記録
  3. 03計画や知識を参照しやすく管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/poteto/noodle --skill brain

インストール後、Claude Code で/brainを入力して読み込まれたか確認します。

詳細

Brain

セッションをまたいで保持されるメモリです。brain/ にある Obsidian ボルトです。

Brain はワークフロー全体の基盤です。すべてのエージェント、スキル、セッションがこれを読み込みます。質の低い内容や推測に基づく内容は、後続のすべてに悪影響を及ぼします。何かを追加する前に、「これによってシステムの動作は本当に改善されるか？」と自問してください。明確に「はい」と言えない場合は、書き込まないでください。

書き込む前に

まず brain/index.md を読みます。次に、トピックに関連するエントリーポイントを読みます。

  • 原則の更新については brain/principles.md
  • 計画関連のメモについては brain/plans/index.md

専用のインデックスファイルがまだないディレクトリ（brain/codebase/、brain/audits/）については、近くのファイルを直接確認し、可能であれば既存のメモを編集します。

構成

brain/
├── index.md              ← root entry point, links to everything
├── principles.md         ← index for principles/
├── todos.md              ← product backlog
├── vision.md             ← elevator pitch + link to architecture
├── architecture.md       ← full technical reference
├── principles/           ← engineering and design principles
├── codebase/             ← project-specific knowledge and gotchas
├── plans/                ← numbered feature plans (02-arrow-bindings/, etc.)
└── audits/               ← design and quality audits (date-prefixed filenames, e.g. 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 がルートです。すべての brain ファイルに、ここからたどれるようにします。
  • ファイル名は小文字とハイフンを使います。worktree-gotchas.md のようにします。
  • 計画ディレクトリの名前には、brain/todos.md の todo ID を先頭に付けます。02-arrow-bindings/ の中に overview.md と phase-N-*.md を配置します。

Wiki リンク

形式：[[section/file-name]]。解決順序は、同じディレクトリ、相対パス、ボルトのルートです。見出しアンカー（[[file#heading]]）は解決時に取り除かれます。

執筆スタイル

  • 散文より箇条書きを優先します。前置きは不要です。
  • # Title 形式のプレーンな Markdown を使います。Obsidian のフロントマターは使いません。
  • メモは約 50 行未満にします。長くなる場合は分割します。

書き込んだ後

追加または削除したファイルがあれば、brain/index.md を更新します。該当する場合は、関連するエントリーポイント（brain/principles.md、brain/delegation.md、または brain/plans/index.md）も更新します。インデックスはリンクのみとし、一覧性を保ちます。

耐久性テスト

「別のタスクのプロンプトにも、これを含めるか？」と自問します。

  • はい → brain/ に書き込みます。長期的に有用な知識です。
  • いいえ、計画固有の内容 → 計画のフェーズドキュメントを更新します。
  • いいえ、スキルに関する問題 → スキルファイルを直接更新します。
  • いいえ、フォローアップ作業が必要 → todo スキルを使って todo を登録します。

メンテナンス

  • 古くなったメモや、ほかのメモに統合されたメモは削除します。
  • brain/plans/ にある、ランダムな名前のファイルを削除します。これらは古い plan モードのアーティファクトです。
  • 新しいメモを追加する前に、内容が重複するメモを統合します。

コメント

Markdown 対応