From cdc464bdb9d1721300cb0e7e603873fced628273 Mon Sep 17 00:00:00 2001 From: Lex Christopherson Date: Sun, 22 Mar 2026 10:06:59 -0600 Subject: [PATCH] =?UTF-8?q?docs:=20update=20READMEs=20for=20v1.28.0=20?= =?UTF-8?q?=E2=80=94=20workstreams,=20workspaces,=20forensics,=20milestone?= =?UTF-8?q?-summary?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 23 ++++++++++++++++++++++- README.zh-CN.md | 23 ++++++++++++++++++++++- 2 files changed, 44 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 2dbb4020c..949a23a4c 100644 --- a/README.md +++ b/README.md @@ -503,7 +503,7 @@ You're never locked in. The system adapts. |---------|--------------| | `/gsd:new-project [--auto]` | Full initialization: questions → research → requirements → roadmap | | `/gsd:discuss-phase [N] [--auto] [--analyze]` | Capture implementation decisions before planning (`--analyze` adds trade-off analysis) | -| `/gsd:plan-phase [N] [--auto]` | Research + plan + verify for a phase | +| `/gsd:plan-phase [N] [--auto] [--reviews]` | Research + plan + verify for a phase (`--reviews` loads codebase review findings) | | `/gsd:execute-phase ` | Execute all plans in parallel waves, verify when complete | | `/gsd:verify-work [N]` | Manual user acceptance testing ¹ | | `/gsd:ship [N] [--draft]` | Create PR from verified phase work with auto-generated body | @@ -512,6 +512,25 @@ You're never locked in. The system adapts. | `/gsd:audit-milestone` | Verify milestone achieved its definition of done | | `/gsd:complete-milestone` | Archive milestone, tag release | | `/gsd:new-milestone [name]` | Start next version: questions → research → requirements → roadmap | +| `/gsd:milestone-summary` | Generate onboarding summary from completed milestone artifacts | +| `/gsd:forensics` | Post-mortem investigation of failed or stuck workflows | + +### Workstreams + +| Command | What it does | +|---------|--------------| +| `/gsd:workstreams list` | Show all workstreams and their status | +| `/gsd:workstreams create ` | Create a namespaced workstream for parallel milestone work | +| `/gsd:workstreams switch ` | Switch active workstream | +| `/gsd:workstreams complete ` | Complete and merge a workstream | + +### Multi-Project Workspaces + +| Command | What it does | +|---------|--------------| +| `/gsd:new-workspace` | Create isolated workspace with repo copies (worktrees or clones) | +| `/gsd:list-workspaces` | Show all GSD workspaces and their status | +| `/gsd:remove-workspace` | Remove workspace and clean up worktrees | ### UI Design @@ -633,6 +652,8 @@ These spawn additional agents during planning/execution. They improve quality bu | `workflow.verifier` | `true` | Confirms must-haves were delivered after execution | | `workflow.auto_advance` | `false` | Auto-chain discuss → plan → execute without stopping | | `workflow.research_before_questions` | `false` | Run research before discussion questions instead of after | +| `workflow.skip_discuss` | `false` | Skip discuss-phase entirely in autonomous mode | +| `workflow.discuss_mode` | `null` | Control discuss-phase behavior (`assumptions` uses inferred defaults) | Use `/gsd:settings` to toggle these, or override per-invocation: - `/gsd:plan-phase --skip-research` diff --git a/README.zh-CN.md b/README.zh-CN.md index 8e964ebc6..77e6109b9 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -499,7 +499,7 @@ lmn012o feat(08-02): create registration endpoint |------|------| | `/gsd:new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 | | `/gsd:discuss-phase [N] [--auto] [--analyze]` | 在规划前收集实现决策（`--analyze` 增加权衡分析） | -| `/gsd:plan-phase [N] [--auto]` | 为某个阶段执行研究 + 规划 + 验证 | +| `/gsd:plan-phase [N] [--auto] [--reviews]` | 为某个阶段执行研究 + 规划 + 验证（`--reviews` 加载代码库审查结果） | | `/gsd:execute-phase ` | 以并行 wave 执行全部计划，完成后验证 | | `/gsd:verify-work [N]` | 人工用户验收测试 ¹ | | `/gsd:ship [N] [--draft]` | 从已验证的阶段工作创建 PR，自动生成 PR 描述 | @@ -508,6 +508,25 @@ lmn012o feat(08-02): create registration endpoint | `/gsd:audit-milestone` | 验证里程碑是否达到完成定义 | | `/gsd:complete-milestone` | 归档里程碑并打 release tag | | `/gsd:new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 | +| `/gsd:milestone-summary` | 从已完成的里程碑产物生成项目概览，用于团队上手 | +| `/gsd:forensics` | 对失败或卡住的工作流进行事后调查 | + +### 工作流（Workstreams） + +| 命令 | 作用 | +|------|------| +| `/gsd:workstreams list` | 显示所有工作流及其状态 | +| `/gsd:workstreams create ` | 创建命名空间工作流，用于并行里程碑工作 | +| `/gsd:workstreams switch ` | 切换当前活跃工作流 | +| `/gsd:workstreams complete ` | 完成并合并工作流 | + +### 多项目工作区 + +| 命令 | 作用 | +|------|------| +| `/gsd:new-workspace` | 创建隔离工作区，包含仓库副本（worktree 或 clone） | +| `/gsd:list-workspaces` | 显示所有 GSD 工作区及其状态 | +| `/gsd:remove-workspace` | 移除工作区并清理 worktree | ### UI 设计 @@ -626,6 +645,8 @@ GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd:new-pr | `workflow.verifier` | `true` | 执行后确认“必须交付项”是否已经落地 | | `workflow.auto_advance` | `false` | 自动串联 discuss → plan → execute，不中途停下 | | `workflow.research_before_questions` | `false` | 在讨论提问前先运行研究，而非之后 | +| `workflow.skip_discuss` | `false` | 在自主模式下完全跳过讨论阶段 | +| `workflow.discuss_mode` | `null` | 控制讨论阶段行为（`assumptions` 使用推断默认值） | 可以用 `/gsd:settings` 开关这些项，也可以在单次命令里覆盖： - `/gsd:plan-phase --skip-research`