docs: update READMEs for v1.28.0 — workstreams, workspaces, forensics, milestone-summary

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-03-22 10:06:59 -06:00
parent 277c446215
commit cdc464bdb9
2 changed files with 44 additions and 2 deletions

View File

@@ -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 <N>` | 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 <name>` | Create a namespaced workstream for parallel milestone work |
| `/gsd:workstreams switch <name>` | Switch active workstream |
| `/gsd:workstreams complete <name>` | 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`

View File

@@ -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 <N>` | 以并行 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 <name>` | 创建命名空间工作流,用于并行里程碑工作 |
| `/gsd:workstreams switch <name>` | 切换当前活跃工作流 |
| `/gsd:workstreams complete <name>` | 完成并合并工作流 |
### 多项目工作区
| 命令 | 作用 |
|------|------|
| `/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`