本文へスキップ
ReviewRamble

週刊ブリーフ

AIのレビューを、あなたの受信箱に。

  • ツール、モデル、MCPサーバー、リポジトリの新しいレビュー(結論を最初に)
  • 変更があったときに再確認した価格と評価
  • 公開された新しい分析記事

モデル、エージェント、MCPサーバー、そして本当に時間をかける価値のあるツール。

週に1通です。配信停止は各メールのリンクからできます。 メールアドレスの利用について

brain.md

MindMux の小さな CLI と四つのエージェントスキルで、プロジェクトの決定事項や制約を Markdown ページとしてリポジトリに残します。

レビュー: ReviewRamble editors · 更新

GitHubで見る オープンソース

このページを共有:XLinkedInFacebookRedditWhatsAppメール

当サイトの評価

3.4/5

brain.md は、なぜその決定をしたのかをエージェントに書き残させる整った方法ですが、規則の厳しい、よく手入れされたドキュメントフォルダー以上のことはほとんどしません。

brain.mdとは?

brain.md は、コーディングエージェントがプロジェクトについて忘れてはいけないことを書き残すための規約とツールです。brain init を実行すると、プロトコルファイル BRAIN.md、brain/ フォルダー、そして CLAUDE.md と AGENTS.md の目印付きブロックが追加され、どのエージェントにも使い方が伝わります。各ページは decision、concept、reference など六つのカテゴリのいずれかに属し、書き換え可能な現在の要約と、追記のみの根拠のタイムラインを持ちます。書き込みはすべて brain CLI を通すため、形式が崩れません。

四つのスキルが動かします。brain-setup はプロジェクトの準備と設定、brain-bootstrap はコード、ドキュメント、git log から、またはあなたへの聞き取りから最初のページを下書きし、brain-page は読み書きの手引き、brain-ingest は会話や文書を brain に取り込みます。Claude Code と Codex 向けの任意の SessionStart フックが、各セッションの開始時にページの索引をエージェントに渡します。

CLI は依存関係のない Node.js スクリプトで、MindMux が npm で @mindmux/brain-md として Apache 2.0 ライセンスで公開しています。リポジトリの作成は 2026 年 6 月、v0.4.2 は 2026 年 11 月 13 日に公開されました。

brain.mdは使う価値があるか?

考え方は妥当で、範囲の取り方も誠実です。brain.md はエージェントの行動をすべて記録しようとはしません。6 か月後も重要で、コードから読み取れないことだけを残し、理解が変わったときには痕跡を残すよう求めます。update-truth はページの要約を書き換え、同じ一回の書き込みでタイムラインに項目を追加するため、覆された決定も消えずに記録が残ります。

裏にあるコードは多くなく、それが魅力でもあり限界でもあります。CLI とインストーラーは依存関係なしで約 1,750 行の JavaScript で、ほかに四つのスキルファイルとテストがあります。検索コマンドはありません。エージェントはページを ID、タイトル、カテゴリで一覧し、関係がありそうなものを読みます。数十ページなら機能しますが、数百ページになると難しくなります。記録はエージェントが BRAIN.md に従うかどうかにかかっています。claude-mem や ai-memory と違ってセッションを自動で記録する仕組みはないため、忙しいエージェントは単に書き忘れることがあります。

フックは控えめです。Codex の SessionStart フックが送るのはページの索引だけで、上限は 8 KiB、実行時間は 5 秒で、CLI が失敗しても静かに終了します。Node 18 と POSIX シェルが必要なため、ネイティブ Windows は対象外です。フックには絶対パスが含まれるので、プロジェクトを移動したら入れ直す必要があります。brain はリポジトリの中にあるため、リポジトリにアクセスできる人なら誰でも読めます。それが狙いである一方、秘密情報を入れない理由にもなります。

普及度は控えめで、スター 722、貢献者 9 人、11 月 19 日までの 30 日間の npm ダウンロードは 814 件です。すでにアーキテクチャの決定記録をつけているチームにとっては、エージェントに維持させる形式が加わるもので、何も記録していないチームにとっては手軽な第一歩になります。

真価を発揮する場面

  • エージェントが決着済みの設計判断を何度も蒸し返す 3 人のチーム

    新しい方針を提案する前に過去の決定をエージェントに読ませたい

    brain init のあと brain-bootstrap スキルで git log から決定ページを下書きします。CLAUDE.md のブロックが、各タスクの開始時に関係するページを読み込むようエージェントに指示します。無料で、ページはコードレビューにも表れます。

  • 同じリポジトリで Claude Code と Codex を使い分ける開発者

    セッション開始時に両方のエージェントへ同じプロジェクト知識を渡したい

    brain install-hooks と brain install-hooks --agent codex で両方の SessionStart フックを入れます。各セッションは最大 8 KiB のページ索引を受け取り、必要に応じてページ全文を読みます。

導入前に確認すること

導入
npm install -g @mindmux/brain-md を実行し、brain setup -y で検出した各エージェントにスキルをコピーしてから、プロジェクトで brain init を実行します。Node 18 以降が必要です。
連携
Claude Code、Codex、Cursor、Pi 向けのエージェントスキル。Claude Code と Codex 向けの SessionStart フック。AGENTS.md や CLAUDE.md を読むエージェントならプロトコルに従えます。MCP サーバーはありません。
データとプライバシー
ページはリポジトリの brain/ フォルダー、または brainRoot で指定したパスに Markdown として置かれ、CLI はどこにも何も送りません。エージェントが書いた内容は、リポジトリにアクセスできる人全員に見えます。
制限
検索も埋め込みもありません。Codex フックのスナップショットは 8 KiB と 5 秒が上限です。フックは絶対パスを持つため、移動後は入れ直しが必要です。ネイティブ Windows のシェルには対応していません。

良い点

  • リポジトリ内のプレーンな Markdown で、コードと一緒にバージョン管理
  • 追記のみのタイムラインで決定を変えた理由が残る
  • 依存関係のない CLI で、ホスティング不要
  • ブートストラップスキルがコードと git log から最初のページを下書き

気になる点

  • 検索がなく、エージェントはページ一覧をたどる
  • 記録はエージェントが書くのを忘れないかに依存
  • フックには POSIX シェルが必要で、ネイティブ Windows は非対応
  • 小規模なプロジェクトで、貢献者 9 人、npm ダウンロードは月 814 件

おすすめの人

Claude Code や Codex にアーキテクチャの決定や制約をリポジトリに残させ、人がプルリクエストで確認できる形にしたい小さなチームに向いています。

brain.mdの代替

brain.md:よくある質問

brain.mdは使う価値があるか?
brain.md は、なぜその決定をしたのかをエージェントに書き残させる整った方法ですが、規則の厳しい、よく手入れされたドキュメントフォルダー以上のことはほとんどしません。 評価は5点満点中3.4点です。
brain.mdの料金は?
Apache 2.0 ライセンスで無料です。サービスやアカウントは不要です。
brain.mdの欠点は?
検索がなく、エージェントはページ一覧をたどる; 記録はエージェントが書くのを忘れないかに依存; フックには POSIX シェルが必要で、ネイティブ Windows は非対応; 小規模なプロジェクトで、貢献者 9 人、npm ダウンロードは月 814 件.
brain.mdは誰に向いているか?
Claude Code や Codex にアーキテクチャの決定や制約をリポジトリに残させ、人がプルリクエストで確認できる形にしたい小さなチームに向いています。
brain.mdは企業データを扱っても安全か?
ページはリポジトリの brain/ フォルダー、または brainRoot で指定したパスに Markdown として置かれ、CLI はどこにも何も送りません。エージェントが書いた内容は、リポジトリにアクセスできる人全員に見えます。
brain.mdの代わりになるものは?
当サイトでレビューした中で最も近い代替はai-memory, claude-obsidian 、 OpenWikiです。

回答確認日:2026年11月20日