Communityライティング&編集github.com

jlholm/noodle

ブレインファイル(Obsidian Vault brain/)の読み書き。知識の永続化、内省、計画作成、直接編集など、セッションを超えて保持する価値のあるあらゆるタスクに使用します。

noodle とは?

このスキルは、Obsidian Vault を永続的な記憶領域として活用し、エージェントがセッション間で知識を保持・共有できるようにします。開発者が「ブレインに追加」「これを覚えておいて」「ノートを書いて」といった指示を出すと、このスキルが発動し、`brain/` ディレクトリ内のマークダウンファイルを読み書きします。Claude Code や Cursor などのプラットフォームで使用でき、デバッグ後の振り返り、アーキテクチャ決定、失敗や修正の記録など、あらゆる洞察を `brain/` に保存することで、後続のセッションでもその知識を利用可能にします。ファイル名は小文字ハイフン区切り、wikilink 形式(`[[section/file-name]]`)で相互参照し、トピックは1ファイル1つに保つなど、明確な構造ルールに従います。書き込み前には必ず `brain/index.md` を読み、耐久性テスト(「異なるタスクのプロンプトに含められるか?」)を通過した知識のみを保存することで、情報の品質とシステム全体の効率を維持します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jlholm/noodle/tree/HEAD/.agents/skills/brain

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ブレイン

セッションを超えた永続メモリ。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/ 内のランダムな名前のファイルを削除する — 古い計画モードのアーティファクトです。
  • 新しいノートを追加する前に、重複するノートをマージする。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル