@bhargavvc/sdd-cc 1.30.0 → 1.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (242) hide show
  1. package/README.ja-JP.md +144 -110
  2. package/README.ko-KR.md +143 -107
  3. package/README.md +183 -112
  4. package/README.pt-BR.md +90 -52
  5. package/README.zh-CN.md +141 -101
  6. package/agents/sdd-advisor-researcher.md +23 -0
  7. package/agents/sdd-ai-researcher.md +133 -0
  8. package/agents/sdd-code-fixer.md +516 -0
  9. package/agents/sdd-code-reviewer.md +355 -0
  10. package/agents/sdd-codebase-mapper.md +3 -3
  11. package/agents/sdd-debugger.md +17 -5
  12. package/agents/sdd-doc-verifier.md +201 -0
  13. package/agents/sdd-doc-writer.md +602 -0
  14. package/agents/sdd-domain-researcher.md +153 -0
  15. package/agents/sdd-eval-auditor.md +164 -0
  16. package/agents/sdd-eval-planner.md +154 -0
  17. package/agents/sdd-executor.md +87 -4
  18. package/agents/sdd-framework-selector.md +160 -0
  19. package/agents/sdd-intel-updater.md +314 -0
  20. package/agents/sdd-nyquist-auditor.md +1 -1
  21. package/agents/sdd-phase-researcher.md +71 -4
  22. package/agents/sdd-plan-checker.md +100 -6
  23. package/agents/sdd-planner.md +145 -206
  24. package/agents/sdd-project-researcher.md +25 -2
  25. package/agents/sdd-research-synthesizer.md +3 -3
  26. package/agents/sdd-roadmapper.md +6 -6
  27. package/agents/sdd-security-auditor.md +128 -0
  28. package/agents/sdd-ui-auditor.md +43 -3
  29. package/agents/sdd-ui-checker.md +5 -5
  30. package/agents/sdd-ui-researcher.md +27 -4
  31. package/agents/sdd-user-profiler.md +2 -2
  32. package/agents/sdd-verifier.md +142 -22
  33. package/bin/install.js +2151 -551
  34. package/commands/sdd/add-backlog.md +5 -5
  35. package/commands/sdd/add-tests.md +2 -2
  36. package/commands/sdd/ai-integration-phase.md +36 -0
  37. package/commands/sdd/analyze-dependencies.md +34 -0
  38. package/commands/sdd/audit-fix.md +33 -0
  39. package/commands/sdd/autonomous.md +7 -2
  40. package/commands/sdd/cleanup.md +5 -0
  41. package/commands/sdd/code-review-fix.md +52 -0
  42. package/commands/sdd/code-review.md +55 -0
  43. package/commands/sdd/complete-milestone.md +6 -6
  44. package/commands/sdd/debug.md +22 -9
  45. package/commands/sdd/discuss-phase.md +7 -2
  46. package/commands/sdd/do.md +1 -1
  47. package/commands/sdd/docs-update.md +48 -0
  48. package/commands/sdd/eval-review.md +32 -0
  49. package/commands/sdd/execute-phase.md +4 -0
  50. package/commands/sdd/explore.md +27 -0
  51. package/commands/sdd/fast.md +2 -2
  52. package/commands/sdd/from-sdd2.md +45 -0
  53. package/commands/sdd/help.md +2 -0
  54. package/commands/sdd/import.md +36 -0
  55. package/commands/sdd/intel.md +179 -0
  56. package/commands/sdd/join-discord.md +2 -1
  57. package/commands/sdd/manager.md +1 -0
  58. package/commands/sdd/map-codebase.md +3 -3
  59. package/commands/sdd/new-milestone.md +1 -1
  60. package/commands/sdd/new-project.md +5 -1
  61. package/commands/sdd/new-workspace.md +1 -1
  62. package/commands/sdd/next.md +2 -0
  63. package/commands/sdd/plan-milestone-gaps.md +2 -2
  64. package/commands/sdd/plan-phase.md +6 -1
  65. package/commands/sdd/plant-seed.md +1 -1
  66. package/commands/sdd/profile-user.md +1 -1
  67. package/commands/sdd/quick.md +5 -3
  68. package/commands/sdd/reapply-patches.md +230 -42
  69. package/commands/sdd/research-phase.md +3 -3
  70. package/commands/sdd/review-backlog.md +1 -0
  71. package/commands/sdd/review.md +6 -3
  72. package/commands/sdd/scan.md +26 -0
  73. package/commands/sdd/secure-phase.md +35 -0
  74. package/commands/sdd/ship.md +1 -1
  75. package/commands/sdd/thread.md +5 -5
  76. package/commands/sdd/undo.md +34 -0
  77. package/commands/sdd/verify-work.md +1 -1
  78. package/commands/sdd/workstreams.md +17 -11
  79. package/hooks/dist/sdd-check-update.js +33 -8
  80. package/hooks/dist/sdd-context-monitor.js +17 -8
  81. package/hooks/dist/sdd-phase-boundary.sh +27 -0
  82. package/hooks/dist/sdd-prompt-guard.js +1 -0
  83. package/hooks/dist/sdd-read-guard.js +82 -0
  84. package/hooks/dist/sdd-session-state.sh +33 -0
  85. package/hooks/dist/sdd-statusline.js +137 -15
  86. package/hooks/dist/sdd-validate-commit.sh +47 -0
  87. package/hooks/dist/sdd-workflow-guard.js +4 -4
  88. package/hooks/sdd-check-update.js +139 -0
  89. package/hooks/sdd-context-monitor.js +165 -0
  90. package/hooks/sdd-phase-boundary.sh +27 -0
  91. package/hooks/sdd-prompt-guard.js +97 -0
  92. package/hooks/sdd-read-guard.js +82 -0
  93. package/hooks/sdd-session-state.sh +33 -0
  94. package/hooks/sdd-statusline.js +241 -0
  95. package/hooks/sdd-validate-commit.sh +47 -0
  96. package/hooks/sdd-workflow-guard.js +94 -0
  97. package/package.json +3 -3
  98. package/scripts/build-hooks.js +18 -7
  99. package/scripts/prompt-injection-scan.sh +1 -0
  100. package/scripts/rebrand-gsd-to-sdd.sh +221 -220
  101. package/scripts/run-tests.cjs +5 -1
  102. package/scripts/sync-upstream.sh +1 -1
  103. package/sdd/bin/lib/commands.cjs +79 -17
  104. package/sdd/bin/lib/config.cjs +90 -48
  105. package/sdd/bin/lib/core.cjs +452 -87
  106. package/sdd/bin/lib/docs.cjs +267 -0
  107. package/sdd/bin/lib/frontmatter.cjs +381 -336
  108. package/sdd/bin/lib/init.cjs +110 -16
  109. package/sdd/bin/lib/intel.cjs +660 -0
  110. package/sdd/bin/lib/learnings.cjs +378 -0
  111. package/sdd/bin/lib/milestone.cjs +42 -11
  112. package/sdd/bin/lib/model-profiles.cjs +17 -15
  113. package/sdd/bin/lib/phase.cjs +367 -288
  114. package/sdd/bin/lib/profile-output.cjs +106 -10
  115. package/sdd/bin/lib/roadmap.cjs +146 -115
  116. package/sdd/bin/lib/schema-detect.cjs +238 -0
  117. package/sdd/bin/lib/sdd2-import.cjs +511 -0
  118. package/sdd/bin/lib/security.cjs +124 -3
  119. package/sdd/bin/lib/state.cjs +648 -264
  120. package/sdd/bin/lib/template.cjs +8 -4
  121. package/sdd/bin/lib/verify.cjs +209 -28
  122. package/sdd/bin/lib/workstream.cjs +7 -3
  123. package/sdd/bin/sdd-tools.cjs +184 -12
  124. package/sdd/contexts/dev.md +21 -0
  125. package/sdd/contexts/research.md +22 -0
  126. package/sdd/contexts/review.md +22 -0
  127. package/sdd/references/agent-contracts.md +79 -0
  128. package/sdd/references/ai-evals.md +156 -0
  129. package/sdd/references/ai-frameworks.md +186 -0
  130. package/sdd/references/artifact-types.md +113 -0
  131. package/sdd/references/common-bug-patterns.md +114 -0
  132. package/sdd/references/context-budget.md +49 -0
  133. package/sdd/references/continuation-format.md +25 -25
  134. package/sdd/references/domain-probes.md +125 -0
  135. package/sdd/references/few-shot-examples/plan-checker.md +73 -0
  136. package/sdd/references/few-shot-examples/verifier.md +109 -0
  137. package/sdd/references/gate-prompts.md +100 -0
  138. package/sdd/references/gates.md +70 -0
  139. package/sdd/references/git-integration.md +1 -1
  140. package/sdd/references/ios-scaffold.md +123 -0
  141. package/sdd/references/model-profile-resolution.md +2 -0
  142. package/sdd/references/model-profiles.md +24 -18
  143. package/sdd/references/planner-gap-closure.md +62 -0
  144. package/sdd/references/planner-reviews.md +39 -0
  145. package/sdd/references/planner-revision.md +87 -0
  146. package/sdd/references/planning-config.md +252 -0
  147. package/sdd/references/revision-loop.md +97 -0
  148. package/sdd/references/thinking-models-debug.md +44 -0
  149. package/sdd/references/thinking-models-execution.md +50 -0
  150. package/sdd/references/thinking-models-planning.md +62 -0
  151. package/sdd/references/thinking-models-research.md +50 -0
  152. package/sdd/references/thinking-models-verification.md +55 -0
  153. package/sdd/references/thinking-partner.md +96 -0
  154. package/sdd/references/ui-brand.md +4 -4
  155. package/sdd/references/universal-anti-patterns.md +63 -0
  156. package/sdd/references/verification-overrides.md +227 -0
  157. package/sdd/references/workstream-flag.md +56 -3
  158. package/sdd/templates/AI-SPEC.md +246 -0
  159. package/sdd/templates/DEBUG.md +1 -1
  160. package/sdd/templates/SECURITY.md +61 -0
  161. package/sdd/templates/UAT.md +4 -4
  162. package/sdd/templates/VALIDATION.md +4 -4
  163. package/sdd/templates/claude-md.md +32 -9
  164. package/sdd/templates/config.json +4 -0
  165. package/sdd/templates/debug-subagent-prompt.md +1 -1
  166. package/sdd/templates/dev-preferences.md +1 -1
  167. package/sdd/templates/discovery.md +2 -2
  168. package/sdd/templates/phase-prompt.md +1 -1
  169. package/sdd/templates/planner-subagent-prompt.md +3 -3
  170. package/sdd/templates/project.md +1 -1
  171. package/sdd/templates/research.md +1 -1
  172. package/sdd/templates/state.md +2 -2
  173. package/sdd/workflows/add-phase.md +8 -8
  174. package/sdd/workflows/add-tests.md +12 -9
  175. package/sdd/workflows/add-todo.md +5 -3
  176. package/sdd/workflows/ai-integration-phase.md +284 -0
  177. package/sdd/workflows/analyze-dependencies.md +96 -0
  178. package/sdd/workflows/audit-fix.md +157 -0
  179. package/sdd/workflows/audit-milestone.md +11 -11
  180. package/sdd/workflows/audit-uat.md +2 -2
  181. package/sdd/workflows/autonomous.md +195 -27
  182. package/sdd/workflows/check-todos.md +12 -10
  183. package/sdd/workflows/cleanup.md +2 -0
  184. package/sdd/workflows/code-review-fix.md +497 -0
  185. package/sdd/workflows/code-review.md +515 -0
  186. package/sdd/workflows/complete-milestone.md +56 -22
  187. package/sdd/workflows/diagnose-issues.md +10 -3
  188. package/sdd/workflows/discovery-phase.md +5 -3
  189. package/sdd/workflows/discuss-phase-assumptions.md +24 -6
  190. package/sdd/workflows/discuss-phase-power.md +291 -0
  191. package/sdd/workflows/discuss-phase.md +173 -21
  192. package/sdd/workflows/do.md +23 -21
  193. package/sdd/workflows/docs-update.md +1155 -0
  194. package/sdd/workflows/eval-review.md +155 -0
  195. package/sdd/workflows/execute-phase.md +594 -38
  196. package/sdd/workflows/execute-plan.md +67 -96
  197. package/sdd/workflows/explore.md +139 -0
  198. package/sdd/workflows/fast.md +5 -5
  199. package/sdd/workflows/forensics.md +2 -2
  200. package/sdd/workflows/health.md +4 -4
  201. package/sdd/workflows/help.md +122 -119
  202. package/sdd/workflows/import.md +276 -0
  203. package/sdd/workflows/inbox.md +387 -0
  204. package/sdd/workflows/insert-phase.md +7 -7
  205. package/sdd/workflows/list-phase-assumptions.md +4 -4
  206. package/sdd/workflows/list-workspaces.md +2 -2
  207. package/sdd/workflows/manager.md +35 -32
  208. package/sdd/workflows/map-codebase.md +7 -5
  209. package/sdd/workflows/milestone-summary.md +2 -2
  210. package/sdd/workflows/new-milestone.md +17 -9
  211. package/sdd/workflows/new-project.md +50 -25
  212. package/sdd/workflows/new-workspace.md +7 -5
  213. package/sdd/workflows/next.md +67 -11
  214. package/sdd/workflows/note.md +9 -7
  215. package/sdd/workflows/pause-work.md +75 -12
  216. package/sdd/workflows/plan-milestone-gaps.md +8 -8
  217. package/sdd/workflows/plan-phase.md +294 -42
  218. package/sdd/workflows/plant-seed.md +6 -3
  219. package/sdd/workflows/pr-branch.md +42 -14
  220. package/sdd/workflows/profile-user.md +9 -7
  221. package/sdd/workflows/progress.md +45 -45
  222. package/sdd/workflows/quick.md +195 -47
  223. package/sdd/workflows/remove-phase.md +6 -6
  224. package/sdd/workflows/remove-workspace.md +3 -1
  225. package/sdd/workflows/research-phase.md +2 -2
  226. package/sdd/workflows/resume-project.md +12 -12
  227. package/sdd/workflows/review.md +109 -9
  228. package/sdd/workflows/scan.md +102 -0
  229. package/sdd/workflows/secure-phase.md +166 -0
  230. package/sdd/workflows/session-report.md +2 -2
  231. package/sdd/workflows/settings.md +38 -12
  232. package/sdd/workflows/ship.md +21 -9
  233. package/sdd/workflows/stats.md +1 -1
  234. package/sdd/workflows/transition.md +23 -23
  235. package/sdd/workflows/ui-phase.md +15 -7
  236. package/sdd/workflows/ui-review.md +29 -4
  237. package/sdd/workflows/undo.md +314 -0
  238. package/sdd/workflows/update.md +171 -20
  239. package/sdd/workflows/validate-phase.md +6 -4
  240. package/sdd/workflows/verify-phase.md +210 -6
  241. package/sdd/workflows/verify-work.md +83 -9
  242. package/sdd/commands/sdd/workstreams.md +0 -63
@@ -9,9 +9,9 @@ Display the complete SDD command reference. Output ONLY the reference content. D
9
9
 
10
10
  ## Quick Start
11
11
 
12
- 1. `/sdd:new-project` - Initialize project (includes research, requirements, roadmap)
13
- 2. `/sdd:plan-phase 1` - Create detailed plan for first phase
14
- 3. `/sdd:execute-phase 1` - Execute the phase
12
+ 1. `/sdd-new-project` - Initialize project (includes research, requirements, roadmap)
13
+ 2. `/sdd-plan-phase 1` - Create detailed plan for first phase
14
+ 3. `/sdd-execute-phase 1` - Execute the phase
15
15
 
16
16
  ## Staying Updated
17
17
 
@@ -24,12 +24,12 @@ npx @bhargavvc/sdd-cc@latest
24
24
  ## Core Workflow
25
25
 
26
26
  ```
27
- /sdd:new-project → /sdd:plan-phase → /sdd:execute-phase → repeat
27
+ /sdd-new-project → /sdd-plan-phase → /sdd-execute-phase → repeat
28
28
  ```
29
29
 
30
30
  ### Project Initialization
31
31
 
32
- **`/sdd:new-project`**
32
+ **`/sdd-new-project`**
33
33
  Initialize new project through unified flow.
34
34
 
35
35
  One command takes you from idea to ready-for-planning:
@@ -46,21 +46,21 @@ Creates all `.planning/` artifacts:
46
46
  - `ROADMAP.md` — phases mapped to requirements
47
47
  - `STATE.md` — project memory
48
48
 
49
- Usage: `/sdd:new-project`
49
+ Usage: `/sdd-new-project`
50
50
 
51
- **`/sdd:map-codebase`**
51
+ **`/sdd-map-codebase`**
52
52
  Map an existing codebase for brownfield projects.
53
53
 
54
54
  - Analyzes codebase with parallel Explore agents
55
55
  - Creates `.planning/codebase/` with 7 focused documents
56
56
  - Covers stack, architecture, structure, conventions, testing, integrations, concerns
57
- - Use before `/sdd:new-project` on existing codebases
57
+ - Use before `/sdd-new-project` on existing codebases
58
58
 
59
- Usage: `/sdd:map-codebase`
59
+ Usage: `/sdd-map-codebase`
60
60
 
61
61
  ### Phase Planning
62
62
 
63
- **`/sdd:discuss-phase <number>`**
63
+ **`/sdd-discuss-phase <number>`**
64
64
  Help articulate your vision for a phase before planning.
65
65
 
66
66
  - Captures how you imagine this phase working
@@ -68,11 +68,11 @@ Help articulate your vision for a phase before planning.
68
68
  - Use when you have ideas about how something should look/feel
69
69
  - Optional `--batch` asks 2-5 related questions at a time instead of one-by-one
70
70
 
71
- Usage: `/sdd:discuss-phase 2`
72
- Usage: `/sdd:discuss-phase 2 --batch`
73
- Usage: `/sdd:discuss-phase 2 --batch=3`
71
+ Usage: `/sdd-discuss-phase 2`
72
+ Usage: `/sdd-discuss-phase 2 --batch`
73
+ Usage: `/sdd-discuss-phase 2 --batch=3`
74
74
 
75
- **`/sdd:research-phase <number>`**
75
+ **`/sdd-research-phase <number>`**
76
76
  Comprehensive ecosystem research for niche/complex domains.
77
77
 
78
78
  - Discovers standard stack, architecture patterns, pitfalls
@@ -80,18 +80,18 @@ Comprehensive ecosystem research for niche/complex domains.
80
80
  - Use for 3D, games, audio, shaders, ML, and other specialized domains
81
81
  - Goes beyond "which library" to ecosystem knowledge
82
82
 
83
- Usage: `/sdd:research-phase 3`
83
+ Usage: `/sdd-research-phase 3`
84
84
 
85
- **`/sdd:list-phase-assumptions <number>`**
85
+ **`/sdd-list-phase-assumptions <number>`**
86
86
  See what Claude is planning to do before it starts.
87
87
 
88
88
  - Shows Claude's intended approach for a phase
89
89
  - Lets you course-correct if Claude misunderstood your vision
90
90
  - No files created - conversational output only
91
91
 
92
- Usage: `/sdd:list-phase-assumptions 3`
92
+ Usage: `/sdd-list-phase-assumptions 3`
93
93
 
94
- **`/sdd:plan-phase <number>`**
94
+ **`/sdd-plan-phase <number>`**
95
95
  Create detailed execution plan for a specific phase.
96
96
 
97
97
  - Generates `.planning/phases/XX-phase-name/XX-YY-PLAN.md`
@@ -99,14 +99,14 @@ Create detailed execution plan for a specific phase.
99
99
  - Includes verification criteria and success measures
100
100
  - Multiple plans per phase supported (XX-01, XX-02, etc.)
101
101
 
102
- Usage: `/sdd:plan-phase 1`
102
+ Usage: `/sdd-plan-phase 1`
103
103
  Result: Creates `.planning/phases/01-foundation/01-01-PLAN.md`
104
104
 
105
105
  **PRD Express Path:** Pass `--prd path/to/requirements.md` to skip discuss-phase entirely. Your PRD becomes locked decisions in CONTEXT.md. Useful when you already have clear acceptance criteria.
106
106
 
107
107
  ### Execution
108
108
 
109
- **`/sdd:execute-phase <phase-number>`**
109
+ **`/sdd-execute-phase <phase-number>`**
110
110
  Execute all plans in a phase, or run a specific wave.
111
111
 
112
112
  - Groups plans by wave (from frontmatter), executes waves sequentially
@@ -115,26 +115,26 @@ Execute all plans in a phase, or run a specific wave.
115
115
  - Verifies phase goal after all plans complete
116
116
  - Updates REQUIREMENTS.md, ROADMAP.md, STATE.md
117
117
 
118
- Usage: `/sdd:execute-phase 5`
119
- Usage: `/sdd:execute-phase 5 --wave 2`
118
+ Usage: `/sdd-execute-phase 5`
119
+ Usage: `/sdd-execute-phase 5 --wave 2`
120
120
 
121
121
  ### Smart Router
122
122
 
123
- **`/sdd:do <description>`**
123
+ **`/sdd-do <description>`**
124
124
  Route freeform text to the right SDD command automatically.
125
125
 
126
126
  - Analyzes natural language input to find the best matching SDD command
127
127
  - Acts as a dispatcher — never does the work itself
128
128
  - Resolves ambiguity by asking you to pick between top matches
129
- - Use when you know what you want but don't know which `/sdd:*` command to run
129
+ - Use when you know what you want but don't know which `/sdd-*` command to run
130
130
 
131
- Usage: `/sdd:do fix the login button`
132
- Usage: `/sdd:do refactor the auth system`
133
- Usage: `/sdd:do I want to start a new milestone`
131
+ Usage: `/sdd-do fix the login button`
132
+ Usage: `/sdd-do refactor the auth system`
133
+ Usage: `/sdd-do I want to start a new milestone`
134
134
 
135
135
  ### Quick Mode
136
136
 
137
- **`/sdd:quick [--full] [--discuss] [--research]`**
137
+ **`/sdd-quick [--full] [--validate] [--discuss] [--research]`**
138
138
  Execute small, ad-hoc tasks with SDD guarantees but skip optional agents.
139
139
 
140
140
  Quick mode uses the same system with a shorter path:
@@ -143,53 +143,55 @@ Quick mode uses the same system with a shorter path:
143
143
  - Updates STATE.md tracking (not ROADMAP.md)
144
144
 
145
145
  Flags enable additional quality steps:
146
+ - `--full` — Complete quality pipeline: discussion + research + plan-checking + verification
147
+ - `--validate` — Plan-checking (max 2 iterations) and post-execution verification only
146
148
  - `--discuss` — Lightweight discussion to surface gray areas before planning
147
149
  - `--research` — Focused research agent investigates approaches before planning
148
- - `--full` — Adds plan-checking (max 2 iterations) and post-execution verification
149
150
 
150
- Flags are composable: `--discuss --research --full` gives the complete quality pipeline for a single task.
151
+ Granular flags are composable: `--discuss --research --validate` gives the same as `--full`.
151
152
 
152
- Usage: `/sdd:quick`
153
- Usage: `/sdd:quick --research --full`
153
+ Usage: `/sdd-quick`
154
+ Usage: `/sdd-quick --full`
155
+ Usage: `/sdd-quick --research --validate`
154
156
  Result: Creates `.planning/quick/NNN-slug/PLAN.md`, `.planning/quick/NNN-slug/SUMMARY.md`
155
157
 
156
158
  ---
157
159
 
158
- **`/sdd:fast [description]`**
160
+ **`/sdd-fast [description]`**
159
161
  Execute a trivial task inline — no subagents, no planning files, no overhead.
160
162
 
161
163
  For tasks too small to justify planning: typo fixes, config changes, forgotten commits, simple additions. Runs in the current context, makes the change, commits, and logs to STATE.md.
162
164
 
163
165
  - No PLAN.md or SUMMARY.md created
164
166
  - No subagent spawned (runs inline)
165
- - ≤ 3 file edits — redirects to `/sdd:quick` if task is non-trivial
167
+ - ≤ 3 file edits — redirects to `/sdd-quick` if task is non-trivial
166
168
  - Atomic commit with conventional message
167
169
 
168
- Usage: `/sdd:fast "fix the typo in README"`
169
- Usage: `/sdd:fast "add .env to gitignore"`
170
+ Usage: `/sdd-fast "fix the typo in README"`
171
+ Usage: `/sdd-fast "add .env to gitignore"`
170
172
 
171
173
  ### Roadmap Management
172
174
 
173
- **`/sdd:add-phase <description>`**
175
+ **`/sdd-add-phase <description>`**
174
176
  Add new phase to end of current milestone.
175
177
 
176
178
  - Appends to ROADMAP.md
177
179
  - Uses next sequential number
178
180
  - Updates phase directory structure
179
181
 
180
- Usage: `/sdd:add-phase "Add admin dashboard"`
182
+ Usage: `/sdd-add-phase "Add admin dashboard"`
181
183
 
182
- **`/sdd:insert-phase <after> <description>`**
184
+ **`/sdd-insert-phase <after> <description>`**
183
185
  Insert urgent work as decimal phase between existing phases.
184
186
 
185
187
  - Creates intermediate phase (e.g., 7.1 between 7 and 8)
186
188
  - Useful for discovered work that must happen mid-milestone
187
189
  - Maintains phase ordering
188
190
 
189
- Usage: `/sdd:insert-phase 7 "Fix critical auth bug"`
191
+ Usage: `/sdd-insert-phase 7 "Fix critical auth bug"`
190
192
  Result: Creates Phase 7.1
191
193
 
192
- **`/sdd:remove-phase <number>`**
194
+ **`/sdd-remove-phase <number>`**
193
195
  Remove a future phase and renumber subsequent phases.
194
196
 
195
197
  - Deletes phase directory and all references
@@ -197,12 +199,12 @@ Remove a future phase and renumber subsequent phases.
197
199
  - Only works on future (unstarted) phases
198
200
  - Git commit preserves historical record
199
201
 
200
- Usage: `/sdd:remove-phase 17`
202
+ Usage: `/sdd-remove-phase 17`
201
203
  Result: Phase 17 deleted, phases 18-20 become 17-19
202
204
 
203
205
  ### Milestone Management
204
206
 
205
- **`/sdd:new-milestone <name>`**
207
+ **`/sdd-new-milestone <name>`**
206
208
  Start a new milestone through unified flow.
207
209
 
208
210
  - Deep questioning to understand what you're building next
@@ -211,12 +213,12 @@ Start a new milestone through unified flow.
211
213
  - Roadmap creation with phase breakdown
212
214
  - Optional `--reset-phase-numbers` flag restarts numbering at Phase 1 and archives old phase dirs first for safety
213
215
 
214
- Mirrors `/sdd:new-project` flow for brownfield projects (existing PROJECT.md).
216
+ Mirrors `/sdd-new-project` flow for brownfield projects (existing PROJECT.md).
215
217
 
216
- Usage: `/sdd:new-milestone "v2.0 Features"`
217
- Usage: `/sdd:new-milestone --reset-phase-numbers "v2.0 Features"`
218
+ Usage: `/sdd-new-milestone "v2.0 Features"`
219
+ Usage: `/sdd-new-milestone --reset-phase-numbers "v2.0 Features"`
218
220
 
219
- **`/sdd:complete-milestone <version>`**
221
+ **`/sdd-complete-milestone <version>`**
220
222
  Archive completed milestone and prepare for next version.
221
223
 
222
224
  - Creates MILESTONES.md entry with stats
@@ -224,11 +226,11 @@ Archive completed milestone and prepare for next version.
224
226
  - Creates git tag for the release
225
227
  - Prepares workspace for next version
226
228
 
227
- Usage: `/sdd:complete-milestone 1.0.0`
229
+ Usage: `/sdd-complete-milestone 1.0.0`
228
230
 
229
231
  ### Progress Tracking
230
232
 
231
- **`/sdd:progress`**
233
+ **`/sdd-progress`**
232
234
  Check project status and intelligently route to next action.
233
235
 
234
236
  - Shows visual progress bar and completion percentage
@@ -238,45 +240,45 @@ Check project status and intelligently route to next action.
238
240
  - Offers to execute next plan or create it if missing
239
241
  - Detects 100% milestone completion
240
242
 
241
- Usage: `/sdd:progress`
243
+ Usage: `/sdd-progress`
242
244
 
243
245
  ### Session Management
244
246
 
245
- **`/sdd:resume-work`**
247
+ **`/sdd-resume-work`**
246
248
  Resume work from previous session with full context restoration.
247
249
 
248
250
  - Reads STATE.md for project context
249
251
  - Shows current position and recent progress
250
252
  - Offers next actions based on project state
251
253
 
252
- Usage: `/sdd:resume-work`
254
+ Usage: `/sdd-resume-work`
253
255
 
254
- **`/sdd:pause-work`**
256
+ **`/sdd-pause-work`**
255
257
  Create context handoff when pausing work mid-phase.
256
258
 
257
259
  - Creates .continue-here file with current state
258
260
  - Updates STATE.md session continuity section
259
261
  - Captures in-progress work context
260
262
 
261
- Usage: `/sdd:pause-work`
263
+ Usage: `/sdd-pause-work`
262
264
 
263
265
  ### Debugging
264
266
 
265
- **`/sdd:debug [issue description]`**
267
+ **`/sdd-debug [issue description]`**
266
268
  Systematic debugging with persistent state across context resets.
267
269
 
268
270
  - Gathers symptoms through adaptive questioning
269
271
  - Creates `.planning/debug/[slug].md` to track investigation
270
272
  - Investigates using scientific method (evidence → hypothesis → test)
271
- - Survives `/clear` — run `/sdd:debug` with no args to resume
273
+ - Survives `/clear` — run `/sdd-debug` with no args to resume
272
274
  - Archives resolved issues to `.planning/debug/resolved/`
273
275
 
274
- Usage: `/sdd:debug "login button doesn't work"`
275
- Usage: `/sdd:debug` (resume active session)
276
+ Usage: `/sdd-debug "login button doesn't work"`
277
+ Usage: `/sdd-debug` (resume active session)
276
278
 
277
279
  ### Quick Notes
278
280
 
279
- **`/sdd:note <text>`**
281
+ **`/sdd-note <text>`**
280
282
  Zero-friction idea capture — one command, instant save, no questions.
281
283
 
282
284
  - Saves timestamped note to `.planning/notes/` (or `~/.claude/notes/` globally)
@@ -284,14 +286,14 @@ Zero-friction idea capture — one command, instant save, no questions.
284
286
  - Promote converts a note into a structured todo
285
287
  - Works without a project (falls back to global scope)
286
288
 
287
- Usage: `/sdd:note refactor the hook system`
288
- Usage: `/sdd:note list`
289
- Usage: `/sdd:note promote 3`
290
- Usage: `/sdd:note --global cross-project idea`
289
+ Usage: `/sdd-note refactor the hook system`
290
+ Usage: `/sdd-note list`
291
+ Usage: `/sdd-note promote 3`
292
+ Usage: `/sdd-note --global cross-project idea`
291
293
 
292
294
  ### Todo Management
293
295
 
294
- **`/sdd:add-todo [description]`**
296
+ **`/sdd-add-todo [description]`**
295
297
  Capture idea or task as todo from current conversation.
296
298
 
297
299
  - Extracts context from conversation (or uses provided description)
@@ -300,24 +302,24 @@ Capture idea or task as todo from current conversation.
300
302
  - Checks for duplicates before creating
301
303
  - Updates STATE.md todo count
302
304
 
303
- Usage: `/sdd:add-todo` (infers from conversation)
304
- Usage: `/sdd:add-todo Add auth token refresh`
305
+ Usage: `/sdd-add-todo` (infers from conversation)
306
+ Usage: `/sdd-add-todo Add auth token refresh`
305
307
 
306
- **`/sdd:check-todos [area]`**
308
+ **`/sdd-check-todos [area]`**
307
309
  List pending todos and select one to work on.
308
310
 
309
311
  - Lists all pending todos with title, area, age
310
- - Optional area filter (e.g., `/sdd:check-todos api`)
312
+ - Optional area filter (e.g., `/sdd-check-todos api`)
311
313
  - Loads full context for selected todo
312
314
  - Routes to appropriate action (work now, add to phase, brainstorm)
313
315
  - Moves todo to done/ when work begins
314
316
 
315
- Usage: `/sdd:check-todos`
316
- Usage: `/sdd:check-todos api`
317
+ Usage: `/sdd-check-todos`
318
+ Usage: `/sdd-check-todos api`
317
319
 
318
320
  ### User Acceptance Testing
319
321
 
320
- **`/sdd:verify-work [phase]`**
322
+ **`/sdd-verify-work [phase]`**
321
323
  Validate built features through conversational UAT.
322
324
 
323
325
  - Extracts testable deliverables from SUMMARY.md files
@@ -325,11 +327,11 @@ Validate built features through conversational UAT.
325
327
  - Automatically diagnoses failures and creates fix plans
326
328
  - Ready for re-execution if issues found
327
329
 
328
- Usage: `/sdd:verify-work 3`
330
+ Usage: `/sdd-verify-work 3`
329
331
 
330
332
  ### Ship Work
331
333
 
332
- **`/sdd:ship [phase]`**
334
+ **`/sdd-ship [phase]`**
333
335
  Create a PR from completed phase work with an auto-generated body.
334
336
 
335
337
  - Pushes branch to remote
@@ -339,56 +341,57 @@ Create a PR from completed phase work with an auto-generated body.
339
341
 
340
342
  Prerequisites: Phase verified, `gh` CLI installed and authenticated.
341
343
 
342
- Usage: `/sdd:ship 4` or `/sdd:ship 4 --draft`
344
+ Usage: `/sdd-ship 4` or `/sdd-ship 4 --draft`
343
345
 
344
346
  ---
345
347
 
346
- **`/sdd:review --phase N [--gemini] [--claude] [--codex] [--all]`**
348
+ **`/sdd-review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--opencode] [--qwen] [--cursor] [--all]`**
347
349
  Cross-AI peer review — invoke external AI CLIs to independently review phase plans.
348
350
 
349
- - Detects available CLIs (gemini, claude, codex)
351
+ - Detects available CLIs (gemini, claude, codex, coderabbit)
350
352
  - Each CLI reviews plans independently with the same structured prompt
353
+ - CodeRabbit reviews the current git diff (not a prompt) — may take up to 5 minutes
351
354
  - Produces REVIEWS.md with per-reviewer feedback and consensus summary
352
- - Feed reviews back into planning: `/sdd:plan-phase N --reviews`
355
+ - Feed reviews back into planning: `/sdd-plan-phase N --reviews`
353
356
 
354
- Usage: `/sdd:review --phase 3 --all`
357
+ Usage: `/sdd-review --phase 3 --all`
355
358
 
356
359
  ---
357
360
 
358
- **`/sdd:pr-branch [target]`**
361
+ **`/sdd-pr-branch [target]`**
359
362
  Create a clean branch for pull requests by filtering out .planning/ commits.
360
363
 
361
364
  - Classifies commits: code-only (include), planning-only (exclude), mixed (include sans .planning/)
362
365
  - Cherry-picks code commits onto a clean branch
363
366
  - Reviewers see only code changes, no SDD artifacts
364
367
 
365
- Usage: `/sdd:pr-branch` or `/sdd:pr-branch main`
368
+ Usage: `/sdd-pr-branch` or `/sdd-pr-branch main`
366
369
 
367
370
  ---
368
371
 
369
- **`/sdd:plant-seed [idea]`**
372
+ **`/sdd-plant-seed [idea]`**
370
373
  Capture a forward-looking idea with trigger conditions for automatic surfacing.
371
374
 
372
375
  - Seeds preserve WHY, WHEN to surface, and breadcrumbs to related code
373
- - Auto-surfaces during `/sdd:new-milestone` when trigger conditions match
376
+ - Auto-surfaces during `/sdd-new-milestone` when trigger conditions match
374
377
  - Better than deferred items — triggers are checked, not forgotten
375
378
 
376
- Usage: `/sdd:plant-seed "add real-time notifications when we build the events system"`
379
+ Usage: `/sdd-plant-seed "add real-time notifications when we build the events system"`
377
380
 
378
381
  ---
379
382
 
380
- **`/sdd:audit-uat`**
383
+ **`/sdd-audit-uat`**
381
384
  Cross-phase audit of all outstanding UAT and verification items.
382
385
  - Scans every phase for pending, skipped, blocked, and human_needed items
383
386
  - Cross-references against codebase to detect stale documentation
384
387
  - Produces prioritized human test plan grouped by testability
385
388
  - Use before starting a new milestone to clear verification debt
386
389
 
387
- Usage: `/sdd:audit-uat`
390
+ Usage: `/sdd-audit-uat`
388
391
 
389
392
  ### Milestone Auditing
390
393
 
391
- **`/sdd:audit-milestone [version]`**
394
+ **`/sdd-audit-milestone [version]`**
392
395
  Audit milestone completion against original intent.
393
396
 
394
397
  - Reads all phase VERIFICATION.md files
@@ -396,30 +399,30 @@ Audit milestone completion against original intent.
396
399
  - Spawns integration checker for cross-phase wiring
397
400
  - Creates MILESTONE-AUDIT.md with gaps and tech debt
398
401
 
399
- Usage: `/sdd:audit-milestone`
402
+ Usage: `/sdd-audit-milestone`
400
403
 
401
- **`/sdd:plan-milestone-gaps`**
404
+ **`/sdd-plan-milestone-gaps`**
402
405
  Create phases to close gaps identified by audit.
403
406
 
404
407
  - Reads MILESTONE-AUDIT.md and groups gaps into phases
405
408
  - Prioritizes by requirement priority (must/should/nice)
406
409
  - Adds gap closure phases to ROADMAP.md
407
- - Ready for `/sdd:plan-phase` on new phases
410
+ - Ready for `/sdd-plan-phase` on new phases
408
411
 
409
- Usage: `/sdd:plan-milestone-gaps`
412
+ Usage: `/sdd-plan-milestone-gaps`
410
413
 
411
414
  ### Configuration
412
415
 
413
- **`/sdd:settings`**
416
+ **`/sdd-settings`**
414
417
  Configure workflow toggles and model profile interactively.
415
418
 
416
419
  - Toggle researcher, plan checker, verifier agents
417
420
  - Select model profile (quality/balanced/budget/inherit)
418
421
  - Updates `.planning/config.json`
419
422
 
420
- Usage: `/sdd:settings`
423
+ Usage: `/sdd-settings`
421
424
 
422
- **`/sdd:set-profile <profile>`**
425
+ **`/sdd-set-profile <profile>`**
423
426
  Quick switch model profile for SDD agents.
424
427
 
425
428
  - `quality` — Opus everywhere except verification
@@ -427,11 +430,11 @@ Quick switch model profile for SDD agents.
427
430
  - `budget` — Sonnet for writing, Haiku for research/verification
428
431
  - `inherit` — Use current session model for all agents (OpenCode `/model`)
429
432
 
430
- Usage: `/sdd:set-profile budget`
433
+ Usage: `/sdd-set-profile budget`
431
434
 
432
435
  ### Utility Commands
433
436
 
434
- **`/sdd:cleanup`**
437
+ **`/sdd-cleanup`**
435
438
  Archive accumulated phase directories from completed milestones.
436
439
 
437
440
  - Identifies phases from completed milestones still in `.planning/phases/`
@@ -439,12 +442,12 @@ Archive accumulated phase directories from completed milestones.
439
442
  - Moves phase dirs to `.planning/milestones/v{X.Y}-phases/`
440
443
  - Use after multiple milestones to reduce `.planning/phases/` clutter
441
444
 
442
- Usage: `/sdd:cleanup`
445
+ Usage: `/sdd-cleanup`
443
446
 
444
- **`/sdd:help`**
447
+ **`/sdd-help`**
445
448
  Show this command reference.
446
449
 
447
- **`/sdd:update`**
450
+ **`/sdd-update`**
448
451
  Update SDD to latest version with changelog preview.
449
452
 
450
453
  - Shows installed vs latest version comparison
@@ -453,15 +456,15 @@ Update SDD to latest version with changelog preview.
453
456
  - Confirms before running install
454
457
  - Better than raw `npx @bhargavvc/sdd-cc`
455
458
 
456
- Usage: `/sdd:update`
459
+ Usage: `/sdd-update`
457
460
 
458
- **`/sdd:join-discord`**
461
+ **`/sdd-join-discord`**
459
462
  Join the SDD Discord community.
460
463
 
461
464
  - Get help, share what you're building, stay updated
462
465
  - Connect with other SDD users
463
466
 
464
- Usage: `/sdd:join-discord`
467
+ Usage: `/sdd-join-discord`
465
468
 
466
469
  ## Files & Structure
467
470
 
@@ -480,7 +483,7 @@ Usage: `/sdd:join-discord`
480
483
  ├── milestones/
481
484
  │ ├── v1.0-ROADMAP.md # Archived roadmap snapshot
482
485
  │ ├── v1.0-REQUIREMENTS.md # Archived requirements
483
- │ └── v1.0-phases/ # Archived phase dirs (via /sdd:cleanup or --archive-phases)
486
+ │ └── v1.0-phases/ # Archived phase dirs (via /sdd-cleanup or --archive-phases)
484
487
  │ ├── 01-foundation/
485
488
  │ └── 02-core-features/
486
489
  ├── codebase/ # Codebase map (brownfield projects)
@@ -502,7 +505,7 @@ Usage: `/sdd:join-discord`
502
505
 
503
506
  ## Workflow Modes
504
507
 
505
- Set during `/sdd:new-project`:
508
+ Set during `/sdd-new-project`:
506
509
 
507
510
  **Interactive Mode**
508
511
 
@@ -550,51 +553,51 @@ Example config:
550
553
  **Starting a new project:**
551
554
 
552
555
  ```
553
- /sdd:new-project # Unified flow: questioning → research → requirements → roadmap
556
+ /sdd-new-project # Unified flow: questioning → research → requirements → roadmap
554
557
  /clear
555
- /sdd:plan-phase 1 # Create plans for first phase
558
+ /sdd-plan-phase 1 # Create plans for first phase
556
559
  /clear
557
- /sdd:execute-phase 1 # Execute all plans in phase
560
+ /sdd-execute-phase 1 # Execute all plans in phase
558
561
  ```
559
562
 
560
563
  **Resuming work after a break:**
561
564
 
562
565
  ```
563
- /sdd:progress # See where you left off and continue
566
+ /sdd-progress # See where you left off and continue
564
567
  ```
565
568
 
566
569
  **Adding urgent mid-milestone work:**
567
570
 
568
571
  ```
569
- /sdd:insert-phase 5 "Critical security fix"
570
- /sdd:plan-phase 5.1
571
- /sdd:execute-phase 5.1
572
+ /sdd-insert-phase 5 "Critical security fix"
573
+ /sdd-plan-phase 5.1
574
+ /sdd-execute-phase 5.1
572
575
  ```
573
576
 
574
577
  **Completing a milestone:**
575
578
 
576
579
  ```
577
- /sdd:complete-milestone 1.0.0
580
+ /sdd-complete-milestone 1.0.0
578
581
  /clear
579
- /sdd:new-milestone # Start next milestone (questioning → research → requirements → roadmap)
582
+ /sdd-new-milestone # Start next milestone (questioning → research → requirements → roadmap)
580
583
  ```
581
584
 
582
585
  **Capturing ideas during work:**
583
586
 
584
587
  ```
585
- /sdd:add-todo # Capture from conversation context
586
- /sdd:add-todo Fix modal z-index # Capture with explicit description
587
- /sdd:check-todos # Review and work on todos
588
- /sdd:check-todos api # Filter by area
588
+ /sdd-add-todo # Capture from conversation context
589
+ /sdd-add-todo Fix modal z-index # Capture with explicit description
590
+ /sdd-check-todos # Review and work on todos
591
+ /sdd-check-todos api # Filter by area
589
592
  ```
590
593
 
591
594
  **Debugging an issue:**
592
595
 
593
596
  ```
594
- /sdd:debug "form submission fails silently" # Start debug session
597
+ /sdd-debug "form submission fails silently" # Start debug session
595
598
  # ... investigation happens, context fills up ...
596
599
  /clear
597
- /sdd:debug # Resume from where you left off
600
+ /sdd-debug # Resume from where you left off
598
601
  ```
599
602
 
600
603
  ## Getting Help
@@ -602,5 +605,5 @@ Example config:
602
605
  - Read `.planning/PROJECT.md` for project vision
603
606
  - Read `.planning/STATE.md` for current context
604
607
  - Check `.planning/ROADMAP.md` for phase status
605
- - Run `/sdd:progress` to check where you're up to
608
+ - Run `/sdd-progress` to check where you're up to
606
609
  </reference>