Skip to content

Commit aeb4f51

Browse files
QingtaoLi1HuYaSenCopilot
authored
feat(cmind): add consolidated /cmind.plan workflow (#57)
- Add `/cmind.plan` as the recommended Phase 2 entry point, consolidating `build_skeleton`, `build_data_flow`, `design_base_classes`, `design_interfaces`, and `plan_tasks` into one resumable workflow. - Add `scripts/plan.py` orchestration with progress probing, automatic resume/restart behavior, downstream rebuild cascading, per-stage verification, and forwarded tuning flags. - Update command docs and multilingual README guidance to replace the multi-command Phase 2 sequence with `/cmind.plan`. - Add unit coverage for the planning orchestrator's deterministic logic, including resume decisions, JSON probe parsing, stage registry checks, and forwarded CLI arguments. --------- Co-authored-by: Yasen Hu <74404492+HuYaSen@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
1 parent 334319c commit aeb4f51

35 files changed

Lines changed: 4414 additions & 1700 deletions

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -421,3 +421,4 @@ FodyWeavers.xsd
421421
CoderMind/.genreleases/
422422
release_notes.md
423423
workspace/
424+
.cmind

CoderMind/README.hi-IN.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -133,24 +133,18 @@ uvx --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=Coder
133133
4. फॉरवर्ड पाइपलाइन चलाएँ:
134134

135135
```text
136-
/cmind.feature_spec <feature description>
137-
/cmind.feature_build
138-
/cmind.feature_refactor
136+
/cmind.feature_construct <feature description>
139137
[Optional] /cmind.feature_edit <edit instructions>
140-
/cmind.build_skeleton
141-
/cmind.build_data_flow
142-
/cmind.design_base_classes
143-
/cmind.design_interfaces
144-
/cmind.plan_tasks
138+
/cmind.plan
145139
/cmind.code_gen
146140
[Optional] /cmind.rpg_edit <edit instructions>
147141
```
148142

149143
> [!IMPORTANT]
150144
> **हर Coding Agent का इनवोकेशन थोड़ा अलग होता है**:
151145
>
152-
> - **Claude Code**: चैट में सीधे `/cmind.feature_spec ...` टाइप करें — slash command पहचाने जाते हैं और संबंधित workflow ट्रिगर हो जाता है।
153-
> - **GitHub Copilot CLI**: slash command समर्थित नहीं हैं (कस्टम agent समर्थित हैं), इसलिए पहले `/agent cmind.feature_spec` से लक्ष्य agent पर स्विच करें, फिर `start` टाइप करके इसका अंतर्निहित workflow चलाएँ।
146+
> - **Claude Code**: चैट में सीधे `/cmind.feature_construct ...` टाइप करें — slash command पहचाने जाते हैं और संबंधित workflow ट्रिगर हो जाता है।
147+
> - **GitHub Copilot CLI**: slash command समर्थित नहीं हैं (कस्टम agent समर्थित हैं), इसलिए पहले `/agent cmind.feature_construct` से लक्ष्य agent पर स्विच करें, फिर `start` टाइप करके इसका अंतर्निहित workflow चलाएँ।
154148
155149
CoderMind क्रमिक रूप से `~/.cmind/workspaces/<workspace-id>/data/rpg.json` बनाता है और इसका उपयोग आवश्यकताओं, प्लानिंग आउटपुट, जनरेटेड कोड और dependency जानकारी को संरेखित रखने के लिए करता है। आपके वर्कस्पेस की स्रोत फ़़ाइलें दूषित नहीं होंगी।
156150

@@ -192,7 +186,7 @@ CoderMind क्रमिक रूप से `~/.cmind/workspaces/<workspace-id
192186

193187
```text
194188
my-project/
195-
├── docs/ # /cmind.feature_spec के लिए वैकल्पिक आवश्यकता दस्तावेज़
189+
├── docs/ # /cmind.feature_construct के लिए वैकल्पिक आवश्यकता दस्तावेज़
196190
├── .github/ or .claude/ # Coding Agent कमांड परिभाषाएँ और सेटिंग्स
197191
├── .vscode/ # लागू होने पर Copilot/VS Code MCP कॉन्फ़िगरेशन
198192
├── .cmind/ # जनरेटेड रिपोर्ट और कॉन्फ़िगरेशन फ़ाइलें
@@ -241,7 +235,7 @@ cmind update
241235

242236
## आगामी सुविधाएँ
243237

244-
- **सरल जनरेशन कमांड्स:** वर्तमान बहु-चरण जनरेशन प्रवाह को कम कमांड्स में मर्ज किया जाएगा, जैसे `/cmind.generate_repo`, `/cmind.generate_feature` और `/cmind.plan`
238+
- **सरल जनरेशन कमांड्स:** वर्तमान बहु-चरण जनरेशन प्रवाह को कम कमांड्स में मर्ज किया जाएगा, जैसे `/cmind.generate_repo` और `/cmind.generate_feature``/cmind.plan` 0.1.4 में रिलीज़ हो चुका है
245239
- **बहु-भाषा समर्थन:** Go, C++, Rust, JavaScript/TypeScript और अन्य के लिए समर्थन जोड़ा जाएगा।
246240
- **अधिक प्लेटफ़ॉर्म एकीकरण:** विभिन्न सिस्टम्स पर विभिन्न AI कोडिंग एजेंट्स के लिए CLI और VS Code एक्सटेंशन वर्कफ़्लो में CoderMind समर्थन।
247241

CoderMind/README.ja-JP.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -133,24 +133,18 @@ uvx --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=Coder
133133
4. フォワードパイプラインを実行します:
134134

135135
```text
136-
/cmind.feature_spec <feature description>
137-
/cmind.feature_build
138-
/cmind.feature_refactor
136+
/cmind.feature_construct <feature description>
139137
[Optional] /cmind.feature_edit <edit instructions>
140-
/cmind.build_skeleton
141-
/cmind.build_data_flow
142-
/cmind.design_base_classes
143-
/cmind.design_interfaces
144-
/cmind.plan_tasks
138+
/cmind.plan
145139
/cmind.code_gen
146140
[Optional] /cmind.rpg_edit <edit instructions>
147141
```
148142

149143
> [!IMPORTANT]
150144
> **コーディングエージェントごとに呼び出し方が異なります**
151145
>
152-
> - **Claude Code**:チャットにそのまま `/cmind.feature_spec ...` と入力します。slash command が認識され、対応する workflow がトリガーされます。
153-
> - **GitHub Copilot CLI**:slash command はサポートされません(カスタム agent はサポート)。まず `/agent cmind.feature_spec` で目的の agent に切り替え、その後 `start` と入力して内蔵の workflow を実行します。
146+
> - **Claude Code**:チャットにそのまま `/cmind.feature_construct ...` と入力します。slash command が認識され、対応する workflow がトリガーされます。
147+
> - **GitHub Copilot CLI**:slash command はサポートされません(カスタム agent はサポート)。まず `/agent cmind.feature_construct` で目的の agent に切り替え、その後 `start` と入力して内蔵の workflow を実行します。
154148
155149
CoderMind は `~/.cmind/workspaces/<workspace-id>/data/rpg.json` を段階的に作成し、それを使って要件・計画成果物・生成コード・依存情報を整合した状態に保ちます。ワークスペースのソースファイルは汚染されません。
156150

@@ -192,7 +186,7 @@ CoderMind は `~/.cmind/workspaces/<workspace-id>/data/rpg.json` を段階的に
192186

193187
```text
194188
my-project/
195-
├── docs/ # /cmind.feature_spec 用の任意の要件ドキュメント
189+
├── docs/ # /cmind.feature_construct 用の任意の要件ドキュメント
196190
├── .github/ or .claude/ # Coding Agent のコマンド定義と設定
197191
├── .vscode/ # 該当する場合の Copilot/VS Code MCP 設定
198192
├── .cmind/ # 生成されたレポートと設定ファイル
@@ -241,7 +235,7 @@ cmind update
241235

242236
## 今後の機能
243237

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

CoderMind/README.ko-KR.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -133,24 +133,18 @@ uvx --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=Coder
133133
4. 포워드 파이프라인을 실행합니다:
134134

135135
```text
136-
/cmind.feature_spec <feature description>
137-
/cmind.feature_build
138-
/cmind.feature_refactor
136+
/cmind.feature_construct <feature description>
139137
[Optional] /cmind.feature_edit <edit instructions>
140-
/cmind.build_skeleton
141-
/cmind.build_data_flow
142-
/cmind.design_base_classes
143-
/cmind.design_interfaces
144-
/cmind.plan_tasks
138+
/cmind.plan
145139
/cmind.code_gen
146140
[Optional] /cmind.rpg_edit <edit instructions>
147141
```
148142

149143
> [!IMPORTANT]
150144
> **Coding Agent마다 호출 방식이 조금씩 다릅니다**:
151145
>
152-
> - **Claude Code**: 채팅에 직접 `/cmind.feature_spec ...` 을 입력하면 slash command가 인식되어 해당 workflow가 트리거됩니다.
153-
> - **GitHub Copilot CLI**: slash command는 지원하지 않으나(커스텀 agent는 지원), 먼저 `/agent cmind.feature_spec` 으로 대상 agent로 전환한 다음 `start` 를 입력해 내장된 workflow를 실행합니다.
146+
> - **Claude Code**: 채팅에 직접 `/cmind.feature_construct ...` 을 입력하면 slash command가 인식되어 해당 workflow가 트리거됩니다.
147+
> - **GitHub Copilot CLI**: slash command는 지원하지 않으나(커스텀 agent는 지원), 먼저 `/agent cmind.feature_construct` 으로 대상 agent로 전환한 다음 `start` 를 입력해 내장된 workflow를 실행합니다.
154148
155149
CoderMind은 `~/.cmind/workspaces/<workspace-id>/data/rpg.json` 을 점진적으로 생성하고, 이를 사용해 요구사항, 계획 산출물, 생성된 코드, 의존성 정보를 정합 상태로 유지합니다. 워크스페이스의 소스 파일은 오염되지 않습니다.
156150

@@ -192,7 +186,7 @@ CoderMind은 `~/.cmind/workspaces/<workspace-id>/data/rpg.json` 을 점진적으
192186

193187
```text
194188
my-project/
195-
├── docs/ # /cmind.feature_spec 용 선택적 요구사항 문서
189+
├── docs/ # /cmind.feature_construct 용 선택적 요구사항 문서
196190
├── .github/ or .claude/ # Coding Agent 커맨드 정의 및 설정
197191
├── .vscode/ # 해당하는 경우 Copilot/VS Code MCP 구성
198192
├── .cmind/ # 생성된 리포트와 설정 파일
@@ -241,7 +235,7 @@ cmind update
241235

242236
## 예정된 기능
243237

244-
- **더 간단한 생성 커맨드:** 현재의 다단계 생성 흐름을 `/cmind.generate_repo`, `/cmind.generate_feature`, `/cmind.plan` 등 더 적은 커맨드로 통합합니다.
238+
- **더 간단한 생성 커맨드:** 현재의 다단계 생성 흐름을 `/cmind.generate_repo`, `/cmind.generate_feature` 등 더 적은 커맨드로 통합합니다. `/cmind.plan` 은 0.1.4 에서 출시되었습니다.
245239
- **다국어 지원:** Go, C++, Rust, JavaScript/TypeScript 등을 추가로 지원합니다.
246240
- **더 많은 플랫폼 통합:** 다양한 시스템에서 서로 다른 AI 코딩 에이전트의 CLI 및 VS Code 확장 워크플로에 걸쳐 CoderMind을 지원합니다.
247241

CoderMind/README.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -136,24 +136,18 @@ Use this path when you want CoderMind to turn requirements into a new codebase.
136136
4. Run the forward pipeline:
137137

138138
```text
139-
/cmind.feature_spec <feature description>
140-
/cmind.feature_build
141-
/cmind.feature_refactor
139+
/cmind.feature_construct <feature description>
142140
[Optional] /cmind.feature_edit <edit instructions>
143-
/cmind.build_skeleton
144-
/cmind.build_data_flow
145-
/cmind.design_base_classes
146-
/cmind.design_interfaces
147-
/cmind.plan_tasks
141+
/cmind.plan
148142
/cmind.code_gen
149143
[Optional] /cmind.rpg_edit <edit instructions>
150144
```
151145

152146
> [!IMPORTANT]
153147
> **Coding Agents are invoked slightly differently**:
154148
>
155-
> - **Claude Code**: type `/cmind.feature_spec ...` directly in the chat — slash commands are recognised and dispatch the matching workflow.
156-
> - **GitHub Copilot CLI**: slash commands are not supported (custom agents are), so first run `/agent cmind.feature_spec` to switch to the target agent, then type `start` to run its built-in workflow.
149+
> - **Claude Code**: type `/cmind.feature_construct ...` directly in the chat — slash commands are recognised and dispatch the matching workflow.
150+
> - **GitHub Copilot CLI**: slash commands are not supported (custom agents are), so first run `/agent cmind.feature_construct` to switch to the target agent, then type `start` to run its built-in workflow.
157151
158152
CoderMind progressively builds `rpg.json` in the home-side runtime directory (`~/.cmind/workspaces/<workspace-id>/data/rpg.json`) and uses it to keep requirements, planning artifacts, generated code, and dependency information aligned. Your workspace source files are not polluted.
159153

@@ -195,7 +189,7 @@ Use this path when you already have a repository and want an AI agent to underst
195189

196190
```text
197191
my-project/
198-
├── docs/ # Optional requirement docs for /cmind.feature_spec
192+
├── docs/ # Optional requirement docs for /cmind.feature_construct
199193
├── .github/ or .claude/ # Coding Agent command definitions and settings
200194
├── .vscode/ # Copilot/VS Code MCP configuration when applicable
201195
├── .cmind/ # Generated reports and configuration files
@@ -244,7 +238,7 @@ cmind update
244238

245239
## Upcoming Features
246240

247-
- **Simpler generation commands:** merge the current multi-step generation flow into fewer commands, such as `/cmind.generate_repo`, `/cmind.generate_feature`, and `/cmind.plan`.
241+
- **Simpler generation commands:** merge the current multi-step generation flow into fewer commands, such as `/cmind.generate_repo` and `/cmind.generate_feature`. `/cmind.plan` has shipped in 0.1.4.
248242
- **Multi-language support:** add support for Go, C++, Rust, JavaScript/TypeScript, and more.
249243
- **More platform integrations:** support CoderMind across CLI and VS Code extension workflows for different AI coding agents on different systems.
250244

CoderMind/README.zh-CN.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -133,24 +133,18 @@ uvx --from "git+https://github.com/microsoft/RPG-ZeroRepo.git#subdirectory=Coder
133133
4. 运行正向流水线:
134134

135135
```text
136-
/cmind.feature_spec <feature description>
137-
/cmind.feature_build
138-
/cmind.feature_refactor
136+
/cmind.feature_construct <feature description>
139137
[Optional] /cmind.feature_edit <edit instructions>
140-
/cmind.build_skeleton
141-
/cmind.build_data_flow
142-
/cmind.design_base_classes
143-
/cmind.design_interfaces
144-
/cmind.plan_tasks
138+
/cmind.plan
145139
/cmind.code_gen
146140
[Optional] /cmind.rpg_edit <edit instructions>
147141
```
148142

149143
> [!IMPORTANT]
150144
> **不同 Coding Agent 的调用方式略有不同**
151145
>
152-
> - **Claude Code**:直接在对话中输入 `/cmind.feature_spec ...`,slash command 会被识别并触发对应 workflow。
153-
> - **GitHub Copilot CLI**:不支持 slash command(但支持自定义 agent),需要先 `/agent cmind.feature_spec` 切换到目标 agent,然后输入 `start` 让它执行内置的 workflow。
146+
> - **Claude Code**:直接在对话中输入 `/cmind.feature_construct ...`,slash command 会被识别并触发对应 workflow。
147+
> - **GitHub Copilot CLI**:不支持 slash command(但支持自定义 agent),需要先 `/agent cmind.feature_construct` 切换到目标 agent,然后输入 `start` 让它执行内置的 workflow。
154148
155149
CoderMind 会渐进式地在 home-side 运行时目录(`~/.cmind/workspaces/<workspace-id>/data/rpg.json`)里创建 `rpg.json`,并用它把需求、规划产物、生成的代码和依赖信息保持对齐。你的工作区源文件不会被污染。
156150

@@ -192,7 +186,7 @@ CoderMind 会渐进式地在 home-side 运行时目录(`~/.cmind/workspaces/<w
192186

193187
```text
194188
my-project/
195-
├── docs/ # /cmind.feature_spec 的可选需求文档
189+
├── docs/ # /cmind.feature_construct 的可选需求文档
196190
├── .github/ or .claude/ # AI 助手的命令定义和设置
197191
├── .vscode/ # 适用时的 Copilot/VS Code MCP 配置
198192
├── .cmind/ # 包含生成的报告和配置文件
@@ -241,7 +235,7 @@ cmind update
241235

242236
## 即将推出的功能
243237

244-
- **更简化的生成命令**:把当前多步骤的生成流程合并为更少的命令,例如 `/cmind.generate_repo``/cmind.generate_feature``/cmind.plan`
238+
- **更简化的生成命令**:把当前多步骤的生成流程合并为更少的命令,例如 `/cmind.generate_repo``/cmind.generate_feature``/cmind.plan` 已在 0.1.4 中发布
245239
- **多语言支持**:增加对 Go、C++、Rust、JavaScript/TypeScript 等的支持。
246240
- **更多平台集成**:在不同系统上跨 CLI 和 VS Code 扩展工作流支持不同的 AI 编码智能体。
247241

0 commit comments

Comments
 (0)