Project Brain – AIコーディングのための永続メモリーインデックス

Project Brain は、Claude Code のための革新的なスキルであり、AI コーディングアシスタントが複数のプロジェクトを扱う際の記憶問題を解決します。多くの開発者は、毎回の新しいセッションで Claude にプロジェクトのアーキテクチャ、デプロイ方法、技術スタック、履歴を説明する必要があり、時間を浪費しています。さらに悪いことに、長時間作業後にはモデルが異なるプロジェクトの詳細を混同し、誤った判断や無駄な作業を引き起こすことがあります。

Project Brain は、プロジェクトルートに .project-brain/ フォルダを作成し、軽量なインデックスファイル（index.md）とオンデマンドでロードされるトピックファイルを配置するというシンプルな方法でこの問題を解決します。インデックスにはプロジェクトリスト、トピックとそのステータス、ポインタのみが含まれ、詳細は個別のファイルに保存され、必要なときだけ読み込まれます。これにより、Claude はすべての知識を一度に読み込むことなく、質問に応じて正確な情報を取得できます。

このスキルの核となる利点は、ステータス追跡機能です。各トピックは単に「完了」とマークされるだけでなく、「検証済み（成功）」、「試行済み（失敗）」、「進行中」に区別されます。例えば、問題解決方法を Claude が問い合わせた際、マップがその方法が3日前に検証済みであることを示せば、ユーザーにその旨を伝えて繰り返すかどうかを尋ねます。この設計により、幻覚が効果的に減少し、モデルがデプロイ詳細を捏造したりプロジェクトスタックを混同したりするのを防ぎます。

さらに、バージョン管理もサポートしています。あるアプローチが置き換えられた場合、古いバージョンは「置き換え済み」ノートとして保持され、試行の軌跡と変更理由が完全に記録されます。この非上書き式の履歴は、チームコラボレーションや長期プロジェクト保守に貴重なコンテキストを提供します。

インストールは非常に簡単です。git クローンでリポジトリを取得し、install.sh スクリプトを実行するだけで、スキルが ~/.claude/skills/ ディレクトリにコピーされます。スキルはマシンごとに一度インストールしますが、メモリデータ（.project-brain/）は各ワークスペースに存在します。初回使用時は、ワークスペース内で /project-brain init コマンドを実行するだけで、プロジェクトを自動検出（package.json、pyproject.toml、git に基づく）し、インデックスを作成します。初期化プロセスは軽量で、ソースコードを読み取ることはありません。

既存の大規模コードベースがある場合、ユーザーは「ディープバックフィル」を選択して、Claude に既存のコードとドキュメントを読み取らせ、要約を生成させることができます。これには一度だけトークン投資が必要ですが、その後のセッションはより安価で正確になります。スキルはディープバックフィルを実行する前に警告を表示し、意図しない消費を防ぎます。

プライバシーと柔軟性も重視されています。.project-brain/ フォルダの内容にはデータベース名、ポート、サーバーパスなどのインフラ詳細が含まれる可能性があるため、ユーザーはバージョン管理に含めるかどうかをプロジェクトごとに決定できます。プロジェクトにはデフォルトで .project-brain/ を無視する .gitignore が含まれており、偶発的な漏洩を防ぎます。

このスキルの背景には、作者が Sentinel AI、24ad.info を含む複数の独立した SaaS 製品を運用した実際の経験があります。各プロジェクトが数千行のコンテキストを保持する場合、AI の忘却や混同のコストは現実的です。Project Brain は、プロジェクトを明確に保つための実用的なワーキングメモリを提供します。

まとめると、Project Brain は単なるツールではなく、AI アシスタントがプロジェクトの状態を継続的に理解するための方法です。スマートインデックス、ステータス追跡、バージョン履歴により、トークン消費と幻覚を大幅に削減し、数ヶ月にわたる記憶をサポートします。これは AI コーディング効率を向上させる強力な補完ツールです。

このスキルは MIT ライセンスのもとでオープンソース化されており、開発者は自由に試用し、改良することができます。