CoderMind

English | 简体中文 | 日本語 | 한국어 | हिन्दी

コーディングエージェントに、編集する前にプランを立てさせる

コーディングエージェントはローカルな編集には強いものの、リポジトリレベルのタスクは安定した計画構造がないと失敗しがちです。要件はドリフトし、アーキテクチャ上の判断は失われ、複数ファイルにまたがる生成は一貫性を欠き、更新は隠れた依存関係を見落とすことがあります。

CoderMind は Claude Code と GitHub Copilot に、リポジトリレベルのコーディングのための永続的な RPG ワークスペースを提供します。このワークスペースは、要件・機能・アーキテクチャ・ファイル・コードエンティティ・依存関係をつなぐ Repository Planning Graph (RPG) を中心に構成されています。

CoderMind を使うと、エージェントはグラフ駆動のワークフローで作業できます:

• Build（構築）: 要件を RPG プランに変換し、複数ファイルからなるリポジトリを生成する。
• Understand（理解）: 既存のリポジトリを RPG にマッピングし、検索・探索・説明する。
• Update（更新）: 影響を受ける RPG ノードを特定し、編集プランを立て、コードとグラフを同時に更新する。

ワークフローを選ぶ

詳細なパイプライン

初めて使う方は、このセクションを飛ばして下のクイックスタートから始められます。

Forward Direction: Requirements → RPG → Code

 Phase 1: Feature Specification       Phase 2: RPG Construction & Planning                             Phase 3
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ feature  │ │ feature  │ │ feature  │ │  build   │ │  build   │ │ design   │ │ design   │ │  plan    │ │          │
│  _spec   ├─▶  _build  ├─▶_refactor ├─▶ skeleton ├─▶  data    ├─▶  base    ├─▶interfaces├─▶  tasks  ├─▶ code_gen │
│          │ │          │ │          │ │          │ │  flow    │ │ classes  │ │          │ │          │ │   (TDD)  │
└──────────┘ └──────────┘ └────┬─────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └────┬─────┘
 feature_     feature_        │        skeleton     data_flow    base_        interfaces   tasks        source
 spec/        build           │        .json        .json        classes      .json        .json        code
 feature_     .json           │        skeleton_    data_flow    .json
 spec.json                    │        summary.txt  _viz.html
                              │
                       ┌──────▼──────┐
                       │ feature_edit│ optional pre-planning edits to feature_tree.json
                       └─────────────┘
                                        ╰───── rpg.json (created → progressively enriched) ─────╯
                                                                            │
                                                                            ▼
                                                                     ┌──────────┐
Surgical edit workflow: Requirements -> RPG update -> Code Update    │ rpg_edit │ optional synchronized RPG + code + dep_graph edits
                                                                     └──▲────▲──┘
                                                                        │    │
Reverse Direction: Code → RPG                                           │    │
                                                                        │    │
┌──────────────────┐         ┌──────────┐       ┌──────────┐            │    │
│ Existing Codebase│────────▶│  encode  │──────▶│update_rpg│────────────┘    │
│                  │         │  (full)  │       │ (manual  │                 │
└──────────────────┘         └────┬─────┘       │ fallback)│                 │
                              rpg.json          └──────────┘                 │
                              dep_graph.json     rpg.json / dep_graph.json   │
                                  │                                          │
                                  └──────────────────────────────────────────┘
                                                  ▲
                                                  │ post-commit hook normally runs incremental updates

MCP Server: search_rpg / explore_rpg / get_node_detail / list_rpg_tree

CoderMind の実例

下の図は、本リポジトリに対して生成されたグラフ可視化の一部です。/cmind.encode を実行した後、<workspace>/.cmind/reports/rpg.html を開くと完全なインタラクティブグラフを閲覧できます。現在のワークスペースの解決済みパスを見るには cmind version を実行してください。

インストール

前提条件

• Python 3.12+
• uv
• Git
• インストール済みで認証済みの AI コーディングエージェント CLI: GitHub Copilot または Claude Code

CoderMind のインストール

# 永続インストール（推奨）
uv tool install cmind-cli --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=CoderMind"
cmind check

# 一度きりの使用
uvx --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=CoderMind" cmind init <project-name>

0.1.3 以降、wheel には pipeline scripts と slash-command templates が packaged assets として同梱されるため、cmind init はオフライン環境（air-gapped 環境や企業プロキシ環境など）でも動作します。

クイックスタート: 新規リポジトリ

要件から新しいコードベースを生成したい場合は、こちらの手順を使います。

1. 新しいプロジェクトを初期化します:

   cmind init my-project
   cd my-project
   

   よく使うバリエーション:

   cmind init my-project --ai claude --script sh
   cmind init my-project --ai copilot
   

2. [任意] 要件ドキュメントを my-project/docs/ に配置します。

3. プロジェクトディレクトリで AI コーディングエージェントを起動します。

4. フォワードパイプラインを実行します:

   /cmind.feature_construct <feature description>
   [Optional] /cmind.feature_edit <edit instructions>
   /cmind.plan
   /cmind.code_gen
   [Optional] /cmind.rpg_edit <edit instructions>
   

CoderMind は ~/.cmind/workspaces/<workspace-id>/data/rpg.json を段階的に作成し、それを使って要件・計画成果物・生成コード・依存情報を整合した状態に保ちます。ワークスペースのソースファイルは汚染されません。

クイックスタート: 既存リポジトリ

すでにリポジトリがあり、AI エージェントに RPG コンテキストで理解または編集させたい場合は、こちらの手順を使います。

1. リポジトリのルートで CoderMind を初期化し、初期グラフを構築します:

   cd existing-repo/
   cmind init . --encode    # --encode は現在のコードから RPG を生成します
   

   空でないディレクトリでの確認プロンプトをスキップしたい場合:

   cmind init . --force --encode
   

2. リポジトリで AI コーディングエージェントを起動します。

3. [任意] 生成された RPG を MCP ツールおよびスラッシュコマンド経由で利用します。以下のコマンドは手動で実行する場合にのみ必要です:

   /cmind.encode                                  # 必要に応じて完全な RPG を再構築
   /cmind.update_rpg                              # 手動の増分更新（フォールバック）
   /cmind.rpg_edit <edit instructions>            # グラフ認識型のコード編集
   

4. 各 commit の後、CoderMind がインストールした git hook が cmind hook <name> ディスパッチャを自動的に呼び出し、RPG を更新してコード変更と整合した状態に保ちます。hook が失敗したりスキップされたりした場合は、/cmind.update_rpg を手動で実行してください。

cmind init の後に起きること

cmind init はソースファイルを変更しません。また、ワークスペースにランタイム状態を書き込みません。ワークスペースには command 定義、MCP 設定、および hooks のみを追加します。CoderMind のランタイムデータ（成果物、ログ）は home-side ディレクトリ ~/.cmind/workspaces/<workspace-id>/ 下に配置されます。<workspace-id> はワークスペースの絶対パスから導出される可読な slug です（例: home-hys-projects-myrepo）。

my-project/
├── docs/                 # /cmind.feature_construct 用の任意の要件ドキュメント
├── .github/ or .claude/  # Coding Agent のコマンド定義と設定
├── .vscode/              # 該当する場合の Copilot/VS Code MCP 設定
├── .cmind/              # 生成されたレポートと設定ファイル
└── .git/hooks/           # cmind init が設置する post-commit / post-merge（各 hook は 1 行のみ: `cmind hook <name>`）

完全なレイアウトとデータファイルのリファレンスは docs/project-structure.md を参照してください。

CoderMind の更新

uv tool install cmind-cli \
   --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=CoderMind" \
   --force \
   --reinstall

# 既存のワークスペースを更新
cd <your-workspace>
cmind update

対応プラットフォーム

Coding Agent サポート:

オペレーティングシステムサポート:

ドキュメント

• スラッシュコマンドリファレンス — すべての /cmind.* コマンドの入力・出力・例。
• CLI リファレンス — cmind init、cmind update、cmind check、cmind version とすべてのオプション。
• 設定 — AI アシスタントのセットアップ、MCP 登録、フック、自動承認、およびトラブルシューティング。
• プロジェクト構造 — CoderMind が作成するファイルとディレクトリ。

今後の機能

• よりシンプルな生成コマンド: 現在の多段階の生成フローを、/cmind.generate_repo や /cmind.generate_feature などのより少ないコマンドにまとめます。/cmind.plan は 0.1.4 でリリース済みです。
• 多言語サポート: Go、C++、Rust、JavaScript/TypeScript などのサポートを追加します。
• より多くのプラットフォーム連携: さまざまなシステム上の異なる AI コーディングエージェントについて、CLI と VS Code 拡張ワークフローを横断して CoderMind をサポートします。

トラブルシューティング

AI アシスタント CLI が見つからない: cmind check を実行し、選択したアシスタント CLI をインストールおよび認証し、cmind init または cmind update を再実行してください。

ライセンス

MIT License — 詳細は LICENSE を参照してください。

謝辞

GitHub Spec-Kit を基にしています。