@bhargavvc/sdd-cc 1.30.1 → 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.
- package/README.ja-JP.md +144 -110
- package/README.ko-KR.md +143 -107
- package/README.md +183 -112
- package/README.pt-BR.md +90 -52
- package/README.zh-CN.md +141 -101
- package/agents/sdd-advisor-researcher.md +23 -0
- package/agents/sdd-ai-researcher.md +133 -0
- package/agents/sdd-code-fixer.md +516 -0
- package/agents/sdd-code-reviewer.md +355 -0
- package/agents/sdd-codebase-mapper.md +3 -3
- package/agents/sdd-debugger.md +17 -5
- package/agents/sdd-doc-verifier.md +201 -0
- package/agents/sdd-doc-writer.md +602 -0
- package/agents/sdd-domain-researcher.md +153 -0
- package/agents/sdd-eval-auditor.md +164 -0
- package/agents/sdd-eval-planner.md +154 -0
- package/agents/sdd-executor.md +87 -4
- package/agents/sdd-framework-selector.md +160 -0
- package/agents/sdd-intel-updater.md +314 -0
- package/agents/sdd-nyquist-auditor.md +1 -1
- package/agents/sdd-phase-researcher.md +71 -4
- package/agents/sdd-plan-checker.md +100 -6
- package/agents/sdd-planner.md +145 -206
- package/agents/sdd-project-researcher.md +25 -2
- package/agents/sdd-research-synthesizer.md +3 -3
- package/agents/sdd-roadmapper.md +6 -6
- package/agents/sdd-security-auditor.md +128 -0
- package/agents/sdd-ui-auditor.md +43 -3
- package/agents/sdd-ui-checker.md +5 -5
- package/agents/sdd-ui-researcher.md +27 -4
- package/agents/sdd-user-profiler.md +2 -2
- package/agents/sdd-verifier.md +142 -22
- package/bin/install.js +2145 -545
- package/commands/sdd/add-backlog.md +5 -5
- package/commands/sdd/add-tests.md +2 -2
- package/commands/sdd/ai-integration-phase.md +36 -0
- package/commands/sdd/analyze-dependencies.md +34 -0
- package/commands/sdd/audit-fix.md +33 -0
- package/commands/sdd/autonomous.md +7 -2
- package/commands/sdd/cleanup.md +5 -0
- package/commands/sdd/code-review-fix.md +52 -0
- package/commands/sdd/code-review.md +55 -0
- package/commands/sdd/complete-milestone.md +6 -6
- package/commands/sdd/debug.md +22 -9
- package/commands/sdd/discuss-phase.md +7 -2
- package/commands/sdd/do.md +1 -1
- package/commands/sdd/docs-update.md +48 -0
- package/commands/sdd/eval-review.md +32 -0
- package/commands/sdd/execute-phase.md +4 -0
- package/commands/sdd/explore.md +27 -0
- package/commands/sdd/fast.md +2 -2
- package/commands/sdd/from-sdd2.md +45 -0
- package/commands/sdd/help.md +2 -0
- package/commands/sdd/import.md +36 -0
- package/commands/sdd/intel.md +179 -0
- package/commands/sdd/join-discord.md +2 -1
- package/commands/sdd/manager.md +1 -0
- package/commands/sdd/map-codebase.md +3 -3
- package/commands/sdd/new-milestone.md +1 -1
- package/commands/sdd/new-project.md +5 -1
- package/commands/sdd/new-workspace.md +1 -1
- package/commands/sdd/next.md +2 -0
- package/commands/sdd/plan-milestone-gaps.md +2 -2
- package/commands/sdd/plan-phase.md +6 -1
- package/commands/sdd/plant-seed.md +1 -1
- package/commands/sdd/profile-user.md +1 -1
- package/commands/sdd/quick.md +5 -3
- package/commands/sdd/reapply-patches.md +230 -42
- package/commands/sdd/research-phase.md +3 -3
- package/commands/sdd/review-backlog.md +1 -0
- package/commands/sdd/review.md +6 -3
- package/commands/sdd/scan.md +26 -0
- package/commands/sdd/secure-phase.md +35 -0
- package/commands/sdd/ship.md +1 -1
- package/commands/sdd/thread.md +5 -5
- package/commands/sdd/undo.md +34 -0
- package/commands/sdd/verify-work.md +1 -1
- package/commands/sdd/workstreams.md +17 -11
- package/hooks/dist/sdd-check-update.js +33 -8
- package/hooks/dist/sdd-context-monitor.js +17 -8
- package/hooks/dist/sdd-phase-boundary.sh +27 -0
- package/hooks/dist/sdd-prompt-guard.js +1 -0
- package/hooks/dist/sdd-read-guard.js +82 -0
- package/hooks/dist/sdd-session-state.sh +33 -0
- package/hooks/dist/sdd-statusline.js +137 -15
- package/hooks/dist/sdd-validate-commit.sh +47 -0
- package/hooks/dist/sdd-workflow-guard.js +4 -4
- package/hooks/sdd-check-update.js +139 -0
- package/hooks/sdd-context-monitor.js +165 -0
- package/hooks/sdd-phase-boundary.sh +27 -0
- package/hooks/sdd-prompt-guard.js +97 -0
- package/hooks/sdd-read-guard.js +82 -0
- package/hooks/sdd-session-state.sh +33 -0
- package/hooks/sdd-statusline.js +241 -0
- package/hooks/sdd-validate-commit.sh +47 -0
- package/hooks/sdd-workflow-guard.js +94 -0
- package/package.json +3 -3
- package/scripts/build-hooks.js +18 -7
- package/scripts/prompt-injection-scan.sh +1 -0
- package/scripts/rebrand-gsd-to-sdd.sh +221 -220
- package/scripts/run-tests.cjs +5 -1
- package/scripts/sync-upstream.sh +1 -1
- package/sdd/bin/lib/commands.cjs +79 -17
- package/sdd/bin/lib/config.cjs +90 -48
- package/sdd/bin/lib/core.cjs +452 -87
- package/sdd/bin/lib/docs.cjs +267 -0
- package/sdd/bin/lib/frontmatter.cjs +381 -336
- package/sdd/bin/lib/init.cjs +110 -16
- package/sdd/bin/lib/intel.cjs +660 -0
- package/sdd/bin/lib/learnings.cjs +378 -0
- package/sdd/bin/lib/milestone.cjs +42 -11
- package/sdd/bin/lib/model-profiles.cjs +17 -15
- package/sdd/bin/lib/phase.cjs +367 -288
- package/sdd/bin/lib/profile-output.cjs +106 -10
- package/sdd/bin/lib/roadmap.cjs +146 -115
- package/sdd/bin/lib/schema-detect.cjs +238 -0
- package/sdd/bin/lib/sdd2-import.cjs +511 -0
- package/sdd/bin/lib/security.cjs +124 -3
- package/sdd/bin/lib/state.cjs +648 -264
- package/sdd/bin/lib/template.cjs +8 -4
- package/sdd/bin/lib/verify.cjs +209 -28
- package/sdd/bin/lib/workstream.cjs +7 -3
- package/sdd/bin/sdd-tools.cjs +184 -12
- package/sdd/contexts/dev.md +21 -0
- package/sdd/contexts/research.md +22 -0
- package/sdd/contexts/review.md +22 -0
- package/sdd/references/agent-contracts.md +79 -0
- package/sdd/references/ai-evals.md +156 -0
- package/sdd/references/ai-frameworks.md +186 -0
- package/sdd/references/artifact-types.md +113 -0
- package/sdd/references/common-bug-patterns.md +114 -0
- package/sdd/references/context-budget.md +49 -0
- package/sdd/references/continuation-format.md +25 -25
- package/sdd/references/domain-probes.md +125 -0
- package/sdd/references/few-shot-examples/plan-checker.md +73 -0
- package/sdd/references/few-shot-examples/verifier.md +109 -0
- package/sdd/references/gate-prompts.md +100 -0
- package/sdd/references/gates.md +70 -0
- package/sdd/references/git-integration.md +1 -1
- package/sdd/references/ios-scaffold.md +123 -0
- package/sdd/references/model-profile-resolution.md +2 -0
- package/sdd/references/model-profiles.md +24 -18
- package/sdd/references/planner-gap-closure.md +62 -0
- package/sdd/references/planner-reviews.md +39 -0
- package/sdd/references/planner-revision.md +87 -0
- package/sdd/references/planning-config.md +252 -0
- package/sdd/references/revision-loop.md +97 -0
- package/sdd/references/thinking-models-debug.md +44 -0
- package/sdd/references/thinking-models-execution.md +50 -0
- package/sdd/references/thinking-models-planning.md +62 -0
- package/sdd/references/thinking-models-research.md +50 -0
- package/sdd/references/thinking-models-verification.md +55 -0
- package/sdd/references/thinking-partner.md +96 -0
- package/sdd/references/ui-brand.md +4 -4
- package/sdd/references/universal-anti-patterns.md +63 -0
- package/sdd/references/verification-overrides.md +227 -0
- package/sdd/references/workstream-flag.md +56 -3
- package/sdd/templates/AI-SPEC.md +246 -0
- package/sdd/templates/DEBUG.md +1 -1
- package/sdd/templates/SECURITY.md +61 -0
- package/sdd/templates/UAT.md +4 -4
- package/sdd/templates/VALIDATION.md +4 -4
- package/sdd/templates/claude-md.md +32 -9
- package/sdd/templates/config.json +4 -0
- package/sdd/templates/debug-subagent-prompt.md +1 -1
- package/sdd/templates/dev-preferences.md +1 -1
- package/sdd/templates/discovery.md +2 -2
- package/sdd/templates/phase-prompt.md +1 -1
- package/sdd/templates/planner-subagent-prompt.md +3 -3
- package/sdd/templates/project.md +1 -1
- package/sdd/templates/research.md +1 -1
- package/sdd/templates/state.md +2 -2
- package/sdd/workflows/add-phase.md +8 -8
- package/sdd/workflows/add-tests.md +12 -9
- package/sdd/workflows/add-todo.md +5 -3
- package/sdd/workflows/ai-integration-phase.md +284 -0
- package/sdd/workflows/analyze-dependencies.md +96 -0
- package/sdd/workflows/audit-fix.md +157 -0
- package/sdd/workflows/audit-milestone.md +11 -11
- package/sdd/workflows/audit-uat.md +2 -2
- package/sdd/workflows/autonomous.md +195 -27
- package/sdd/workflows/check-todos.md +12 -10
- package/sdd/workflows/cleanup.md +2 -0
- package/sdd/workflows/code-review-fix.md +497 -0
- package/sdd/workflows/code-review.md +515 -0
- package/sdd/workflows/complete-milestone.md +56 -22
- package/sdd/workflows/diagnose-issues.md +10 -3
- package/sdd/workflows/discovery-phase.md +5 -3
- package/sdd/workflows/discuss-phase-assumptions.md +24 -6
- package/sdd/workflows/discuss-phase-power.md +291 -0
- package/sdd/workflows/discuss-phase.md +173 -21
- package/sdd/workflows/do.md +23 -21
- package/sdd/workflows/docs-update.md +1155 -0
- package/sdd/workflows/eval-review.md +155 -0
- package/sdd/workflows/execute-phase.md +594 -38
- package/sdd/workflows/execute-plan.md +67 -96
- package/sdd/workflows/explore.md +139 -0
- package/sdd/workflows/fast.md +5 -5
- package/sdd/workflows/forensics.md +2 -2
- package/sdd/workflows/health.md +4 -4
- package/sdd/workflows/help.md +122 -119
- package/sdd/workflows/import.md +276 -0
- package/sdd/workflows/inbox.md +387 -0
- package/sdd/workflows/insert-phase.md +7 -7
- package/sdd/workflows/list-phase-assumptions.md +4 -4
- package/sdd/workflows/list-workspaces.md +2 -2
- package/sdd/workflows/manager.md +35 -32
- package/sdd/workflows/map-codebase.md +7 -5
- package/sdd/workflows/milestone-summary.md +2 -2
- package/sdd/workflows/new-milestone.md +17 -9
- package/sdd/workflows/new-project.md +50 -25
- package/sdd/workflows/new-workspace.md +7 -5
- package/sdd/workflows/next.md +67 -11
- package/sdd/workflows/note.md +9 -7
- package/sdd/workflows/pause-work.md +75 -12
- package/sdd/workflows/plan-milestone-gaps.md +8 -8
- package/sdd/workflows/plan-phase.md +294 -42
- package/sdd/workflows/plant-seed.md +6 -3
- package/sdd/workflows/pr-branch.md +42 -14
- package/sdd/workflows/profile-user.md +9 -7
- package/sdd/workflows/progress.md +45 -45
- package/sdd/workflows/quick.md +195 -47
- package/sdd/workflows/remove-phase.md +6 -6
- package/sdd/workflows/remove-workspace.md +3 -1
- package/sdd/workflows/research-phase.md +2 -2
- package/sdd/workflows/resume-project.md +12 -12
- package/sdd/workflows/review.md +109 -9
- package/sdd/workflows/scan.md +102 -0
- package/sdd/workflows/secure-phase.md +166 -0
- package/sdd/workflows/session-report.md +2 -2
- package/sdd/workflows/settings.md +38 -12
- package/sdd/workflows/ship.md +21 -9
- package/sdd/workflows/stats.md +1 -1
- package/sdd/workflows/transition.md +23 -23
- package/sdd/workflows/ui-phase.md +15 -7
- package/sdd/workflows/ui-review.md +29 -4
- package/sdd/workflows/undo.md +314 -0
- package/sdd/workflows/update.md +171 -20
- package/sdd/workflows/validate-phase.md +6 -4
- package/sdd/workflows/verify-phase.md +210 -6
- package/sdd/workflows/verify-work.md +83 -9
- package/sdd/commands/sdd/workstreams.md +0 -63
package/sdd/workflows/help.md
CHANGED
|
@@ -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
|
|
13
|
-
2. `/sdd
|
|
14
|
-
3. `/sdd
|
|
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
|
|
27
|
+
/sdd-new-project → /sdd-plan-phase → /sdd-execute-phase → repeat
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
### Project Initialization
|
|
31
31
|
|
|
32
|
-
**`/sdd
|
|
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
|
|
49
|
+
Usage: `/sdd-new-project`
|
|
50
50
|
|
|
51
|
-
**`/sdd
|
|
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
|
|
57
|
+
- Use before `/sdd-new-project` on existing codebases
|
|
58
58
|
|
|
59
|
-
Usage: `/sdd
|
|
59
|
+
Usage: `/sdd-map-codebase`
|
|
60
60
|
|
|
61
61
|
### Phase Planning
|
|
62
62
|
|
|
63
|
-
**`/sdd
|
|
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
|
|
72
|
-
Usage: `/sdd
|
|
73
|
-
Usage: `/sdd
|
|
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
|
|
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
|
|
83
|
+
Usage: `/sdd-research-phase 3`
|
|
84
84
|
|
|
85
|
-
**`/sdd
|
|
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
|
|
92
|
+
Usage: `/sdd-list-phase-assumptions 3`
|
|
93
93
|
|
|
94
|
-
**`/sdd
|
|
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
|
|
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
|
|
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
|
|
119
|
-
Usage: `/sdd
|
|
118
|
+
Usage: `/sdd-execute-phase 5`
|
|
119
|
+
Usage: `/sdd-execute-phase 5 --wave 2`
|
|
120
120
|
|
|
121
121
|
### Smart Router
|
|
122
122
|
|
|
123
|
-
**`/sdd
|
|
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
|
|
129
|
+
- Use when you know what you want but don't know which `/sdd-*` command to run
|
|
130
130
|
|
|
131
|
-
Usage: `/sdd
|
|
132
|
-
Usage: `/sdd
|
|
133
|
-
Usage: `/sdd
|
|
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
|
|
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
|
-
|
|
151
|
+
Granular flags are composable: `--discuss --research --validate` gives the same as `--full`.
|
|
151
152
|
|
|
152
|
-
Usage: `/sdd
|
|
153
|
-
Usage: `/sdd
|
|
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
|
|
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
|
|
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
|
|
169
|
-
Usage: `/sdd
|
|
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
|
|
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
|
|
182
|
+
Usage: `/sdd-add-phase "Add admin dashboard"`
|
|
181
183
|
|
|
182
|
-
**`/sdd
|
|
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
|
|
191
|
+
Usage: `/sdd-insert-phase 7 "Fix critical auth bug"`
|
|
190
192
|
Result: Creates Phase 7.1
|
|
191
193
|
|
|
192
|
-
**`/sdd
|
|
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
|
|
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
|
|
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
|
|
216
|
+
Mirrors `/sdd-new-project` flow for brownfield projects (existing PROJECT.md).
|
|
215
217
|
|
|
216
|
-
Usage: `/sdd
|
|
217
|
-
Usage: `/sdd
|
|
218
|
+
Usage: `/sdd-new-milestone "v2.0 Features"`
|
|
219
|
+
Usage: `/sdd-new-milestone --reset-phase-numbers "v2.0 Features"`
|
|
218
220
|
|
|
219
|
-
**`/sdd
|
|
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
|
|
229
|
+
Usage: `/sdd-complete-milestone 1.0.0`
|
|
228
230
|
|
|
229
231
|
### Progress Tracking
|
|
230
232
|
|
|
231
|
-
**`/sdd
|
|
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
|
|
243
|
+
Usage: `/sdd-progress`
|
|
242
244
|
|
|
243
245
|
### Session Management
|
|
244
246
|
|
|
245
|
-
**`/sdd
|
|
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
|
|
254
|
+
Usage: `/sdd-resume-work`
|
|
253
255
|
|
|
254
|
-
**`/sdd
|
|
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
|
|
263
|
+
Usage: `/sdd-pause-work`
|
|
262
264
|
|
|
263
265
|
### Debugging
|
|
264
266
|
|
|
265
|
-
**`/sdd
|
|
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
|
|
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
|
|
275
|
-
Usage: `/sdd
|
|
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
|
|
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
|
|
288
|
-
Usage: `/sdd
|
|
289
|
-
Usage: `/sdd
|
|
290
|
-
Usage: `/sdd
|
|
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
|
|
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
|
|
304
|
-
Usage: `/sdd
|
|
305
|
+
Usage: `/sdd-add-todo` (infers from conversation)
|
|
306
|
+
Usage: `/sdd-add-todo Add auth token refresh`
|
|
305
307
|
|
|
306
|
-
**`/sdd
|
|
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
|
|
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
|
|
316
|
-
Usage: `/sdd
|
|
317
|
+
Usage: `/sdd-check-todos`
|
|
318
|
+
Usage: `/sdd-check-todos api`
|
|
317
319
|
|
|
318
320
|
### User Acceptance Testing
|
|
319
321
|
|
|
320
|
-
**`/sdd
|
|
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
|
|
330
|
+
Usage: `/sdd-verify-work 3`
|
|
329
331
|
|
|
330
332
|
### Ship Work
|
|
331
333
|
|
|
332
|
-
**`/sdd
|
|
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
|
|
344
|
+
Usage: `/sdd-ship 4` or `/sdd-ship 4 --draft`
|
|
343
345
|
|
|
344
346
|
---
|
|
345
347
|
|
|
346
|
-
**`/sdd
|
|
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
|
|
355
|
+
- Feed reviews back into planning: `/sdd-plan-phase N --reviews`
|
|
353
356
|
|
|
354
|
-
Usage: `/sdd
|
|
357
|
+
Usage: `/sdd-review --phase 3 --all`
|
|
355
358
|
|
|
356
359
|
---
|
|
357
360
|
|
|
358
|
-
**`/sdd
|
|
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
|
|
368
|
+
Usage: `/sdd-pr-branch` or `/sdd-pr-branch main`
|
|
366
369
|
|
|
367
370
|
---
|
|
368
371
|
|
|
369
|
-
**`/sdd
|
|
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
|
|
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
|
|
379
|
+
Usage: `/sdd-plant-seed "add real-time notifications when we build the events system"`
|
|
377
380
|
|
|
378
381
|
---
|
|
379
382
|
|
|
380
|
-
**`/sdd
|
|
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
|
|
390
|
+
Usage: `/sdd-audit-uat`
|
|
388
391
|
|
|
389
392
|
### Milestone Auditing
|
|
390
393
|
|
|
391
|
-
**`/sdd
|
|
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
|
|
402
|
+
Usage: `/sdd-audit-milestone`
|
|
400
403
|
|
|
401
|
-
**`/sdd
|
|
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
|
|
410
|
+
- Ready for `/sdd-plan-phase` on new phases
|
|
408
411
|
|
|
409
|
-
Usage: `/sdd
|
|
412
|
+
Usage: `/sdd-plan-milestone-gaps`
|
|
410
413
|
|
|
411
414
|
### Configuration
|
|
412
415
|
|
|
413
|
-
**`/sdd
|
|
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
|
|
423
|
+
Usage: `/sdd-settings`
|
|
421
424
|
|
|
422
|
-
**`/sdd
|
|
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
|
|
433
|
+
Usage: `/sdd-set-profile budget`
|
|
431
434
|
|
|
432
435
|
### Utility Commands
|
|
433
436
|
|
|
434
|
-
**`/sdd
|
|
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
|
|
445
|
+
Usage: `/sdd-cleanup`
|
|
443
446
|
|
|
444
|
-
**`/sdd
|
|
447
|
+
**`/sdd-help`**
|
|
445
448
|
Show this command reference.
|
|
446
449
|
|
|
447
|
-
**`/sdd
|
|
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
|
|
459
|
+
Usage: `/sdd-update`
|
|
457
460
|
|
|
458
|
-
**`/sdd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
556
|
+
/sdd-new-project # Unified flow: questioning → research → requirements → roadmap
|
|
554
557
|
/clear
|
|
555
|
-
/sdd
|
|
558
|
+
/sdd-plan-phase 1 # Create plans for first phase
|
|
556
559
|
/clear
|
|
557
|
-
/sdd
|
|
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
|
|
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
|
|
570
|
-
/sdd
|
|
571
|
-
/sdd
|
|
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
|
|
580
|
+
/sdd-complete-milestone 1.0.0
|
|
578
581
|
/clear
|
|
579
|
-
/sdd
|
|
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
|
|
586
|
-
/sdd
|
|
587
|
-
/sdd
|
|
588
|
-
/sdd
|
|
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
|
|
597
|
+
/sdd-debug "form submission fails silently" # Start debug session
|
|
595
598
|
# ... investigation happens, context fills up ...
|
|
596
599
|
/clear
|
|
597
|
-
/sdd
|
|
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
|
|
608
|
+
- Run `/sdd-progress` to check where you're up to
|
|
606
609
|
</reference>
|