@undeemed/get-shit-done-codex 1.21.0 → 1.22.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 (71) hide show
  1. package/README.md +33 -45
  2. package/agents/gsd-codebase-mapper.md +3 -3
  3. package/agents/gsd-debugger.md +5 -5
  4. package/agents/gsd-executor.md +14 -14
  5. package/agents/gsd-phase-researcher.md +7 -7
  6. package/agents/gsd-plan-checker.md +10 -10
  7. package/agents/gsd-planner.md +19 -19
  8. package/agents/gsd-project-researcher.md +3 -3
  9. package/agents/gsd-research-synthesizer.md +6 -6
  10. package/agents/gsd-roadmapper.md +7 -7
  11. package/agents/gsd-verifier.md +29 -17
  12. package/bin/install.js +54 -198
  13. package/commands/gsd/add-tests.md +5 -4
  14. package/commands/gsd/complete-milestone.md +6 -6
  15. package/commands/gsd/debug.md +1 -1
  16. package/commands/gsd/map-codebase.md +3 -3
  17. package/commands/gsd/new-milestone.md +1 -1
  18. package/commands/gsd/new-project.md +1 -1
  19. package/commands/gsd/plan-milestone-gaps.md +2 -2
  20. package/commands/gsd/reapply-patches.md +2 -2
  21. package/commands/gsd/research-phase.md +3 -3
  22. package/commands/gsd/verify-work.md +1 -1
  23. package/get-shit-done/bin/lib/commands.cjs +1 -1
  24. package/get-shit-done/bin/lib/phase.cjs +2 -2
  25. package/get-shit-done/bin/lib/verify.cjs +8 -8
  26. package/get-shit-done/references/continuation-format.md +16 -16
  27. package/get-shit-done/references/model-profiles.md +1 -1
  28. package/get-shit-done/references/ui-brand.md +2 -2
  29. package/get-shit-done/templates/DEBUG.md +1 -1
  30. package/get-shit-done/templates/UAT.md +3 -3
  31. package/get-shit-done/templates/VALIDATION.md +1 -1
  32. package/get-shit-done/templates/debug-subagent-prompt.md +1 -1
  33. package/get-shit-done/templates/discovery.md +2 -2
  34. package/get-shit-done/templates/phase-prompt.md +1 -1
  35. package/get-shit-done/templates/planner-subagent-prompt.md +3 -3
  36. package/get-shit-done/templates/project.md +1 -1
  37. package/get-shit-done/templates/research.md +1 -1
  38. package/get-shit-done/templates/retrospective.md +13 -7
  39. package/get-shit-done/templates/state.md +2 -2
  40. package/get-shit-done/workflows/add-phase.md +7 -7
  41. package/get-shit-done/workflows/add-tests.md +41 -18
  42. package/get-shit-done/workflows/add-todo.md +2 -2
  43. package/get-shit-done/workflows/audit-milestone.md +5 -5
  44. package/get-shit-done/workflows/check-todos.md +8 -8
  45. package/get-shit-done/workflows/complete-milestone.md +33 -8
  46. package/get-shit-done/workflows/diagnose-issues.md +1 -1
  47. package/get-shit-done/workflows/discovery-phase.md +3 -3
  48. package/get-shit-done/workflows/discuss-phase.md +10 -10
  49. package/get-shit-done/workflows/execute-phase.md +7 -7
  50. package/get-shit-done/workflows/execute-plan.md +3 -3
  51. package/get-shit-done/workflows/health.md +5 -5
  52. package/get-shit-done/workflows/help.md +85 -85
  53. package/get-shit-done/workflows/insert-phase.md +6 -6
  54. package/get-shit-done/workflows/list-phase-assumptions.md +4 -4
  55. package/get-shit-done/workflows/map-codebase.md +2 -2
  56. package/get-shit-done/workflows/new-milestone.md +5 -5
  57. package/get-shit-done/workflows/new-project.md +11 -11
  58. package/get-shit-done/workflows/pause-work.md +1 -1
  59. package/get-shit-done/workflows/plan-milestone-gaps.md +7 -7
  60. package/get-shit-done/workflows/plan-phase.md +12 -12
  61. package/get-shit-done/workflows/progress.md +22 -22
  62. package/get-shit-done/workflows/quick.md +3 -3
  63. package/get-shit-done/workflows/remove-phase.md +6 -6
  64. package/get-shit-done/workflows/research-phase.md +2 -2
  65. package/get-shit-done/workflows/resume-project.md +9 -9
  66. package/get-shit-done/workflows/settings.md +5 -5
  67. package/get-shit-done/workflows/transition.md +10 -10
  68. package/get-shit-done/workflows/update.md +2 -2
  69. package/get-shit-done/workflows/verify-work.md +8 -8
  70. package/package.json +1 -1
  71. package/commands/gsd/new-project.md.bak +0 -1041
@@ -321,7 +321,7 @@ grep "^status:" "$PHASE_DIR"/*-VERIFICATION.md | cut -d: -f2 | tr -d ' '
321
321
  |--------|--------|
322
322
  | `passed` | → update_roadmap |
323
323
  | `human_needed` | Present items for human testing, get approval or feedback |
324
- | `gaps_found` | Present gap summary, offer `/gsd:plan-phase {phase} --gaps` |
324
+ | `gaps_found` | Present gap summary, offer `$gsd-plan-phase {phase} --gaps` |
325
325
 
326
326
  **If human_needed:**
327
327
  ```
@@ -347,15 +347,15 @@ All automated checks passed. {N} items need human testing:
347
347
  ---
348
348
  ## ▶ Next Up
349
349
 
350
- `/gsd:plan-phase {X} --gaps`
350
+ `$gsd-plan-phase {X} --gaps`
351
351
 
352
352
  <sub>`/clear` first → fresh context window</sub>
353
353
 
354
354
  Also: `cat {phase_dir}/{phase_num}-VERIFICATION.md` — full report
355
- Also: `/gsd:verify-work {X}` — manual testing first
355
+ Also: `$gsd-verify-work {X}` — manual testing first
356
356
  ```
357
357
 
358
- Gap closure cycle: `/gsd:plan-phase {X} --gaps` reads VERIFICATION.md → creates gap plans with `gap_closure: true` → user runs `/gsd:execute-phase {X} --gaps-only` → verifier re-runs.
358
+ Gap closure cycle: `$gsd-plan-phase {X} --gaps` reads VERIFICATION.md → creates gap plans with `gap_closure: true` → user runs `$gsd-execute-phase {X} --gaps-only` → verifier re-runs.
359
359
  </step>
360
360
 
361
361
  <step name="update_roadmap">
@@ -381,7 +381,7 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs(phase-{X}): complete
381
381
 
382
382
  <step name="offer_next">
383
383
 
384
- **Exception:** If `gaps_found`, the `verify_phase_goal` step already presents the gap-closure path (`/gsd:plan-phase {X} --gaps`). No additional routing needed — skip auto-advance.
384
+ **Exception:** If `gaps_found`, the `verify_phase_goal` step already presents the gap-closure path (`$gsd-plan-phase {X} --gaps`). No additional routing needed — skip auto-advance.
385
385
 
386
386
  **No-transition check (spawned by auto-advance chain):**
387
387
 
@@ -429,7 +429,7 @@ Read and follow `~/.codex/get-shit-done/workflows/transition.md`, passing throug
429
429
 
430
430
  **If neither `--auto` nor `AUTO_CFG` is true:**
431
431
 
432
- The workflow ends. The user runs `/gsd:progress` or invokes the transition workflow manually.
432
+ The workflow ends. The user runs `$gsd-progress` or invokes the transition workflow manually.
433
433
  </step>
434
434
 
435
435
  </process>
@@ -447,7 +447,7 @@ Orchestrator: ~10-15% context. Subagents: fresh 200k each. No polling (Task bloc
447
447
  </failure_handling>
448
448
 
449
449
  <resumption>
450
- Re-run `/gsd:execute-phase {phase}` → discover_plans finds completed SUMMARYs → skips them → resumes from first incomplete plan → continues wave execution.
450
+ Re-run `$gsd-execute-phase {phase}` → discover_plans finds completed SUMMARYs → skips them → resumes from first incomplete plan → continues wave execution.
451
451
 
452
452
  STATE.md tracks: last completed plan, current wave, pending checkpoints.
453
453
  </resumption>
@@ -423,9 +423,9 @@ ls -1 .planning/phases/[current-phase-dir]/*-SUMMARY.md 2>/dev/null | wc -l
423
423
 
424
424
  | Condition | Route | Action |
425
425
  |-----------|-------|--------|
426
- | summaries < plans | **A: More plans** | Find next PLAN without SUMMARY. Yolo: auto-continue. Interactive: show next plan, suggest `/gsd:execute-phase {phase}` + `/gsd:verify-work`. STOP here. |
427
- | summaries = plans, current < highest phase | **B: Phase done** | Show completion, suggest `/gsd:plan-phase {Z+1}` + `/gsd:verify-work {Z}` + `/gsd:discuss-phase {Z+1}` |
428
- | summaries = plans, current = highest phase | **C: Milestone done** | Show banner, suggest `/gsd:complete-milestone` + `/gsd:verify-work` + `/gsd:add-phase` |
426
+ | summaries < plans | **A: More plans** | Find next PLAN without SUMMARY. Yolo: auto-continue. Interactive: show next plan, suggest `$gsd-execute-phase {phase}` + `$gsd-verify-work`. STOP here. |
427
+ | summaries = plans, current < highest phase | **B: Phase done** | Show completion, suggest `$gsd-plan-phase {Z+1}` + `$gsd-verify-work {Z}` + `$gsd-discuss-phase {Z+1}` |
428
+ | summaries = plans, current = highest phase | **C: Milestone done** | Show banner, suggest `$gsd-complete-milestone` + `$gsd-verify-work` + `$gsd-add-phase` |
429
429
 
430
430
  All routes: `/clear` first for fresh context.
431
431
  </step>
@@ -62,10 +62,10 @@ Errors: N | Warnings: N | Info: N
62
62
  ## Errors
63
63
 
64
64
  - [E001] config.json: JSON parse error at line 5
65
- Fix: Run /gsd:health --repair to reset to defaults
65
+ Fix: Run $gsd-health --repair to reset to defaults
66
66
 
67
67
  - [E002] PROJECT.md not found
68
- Fix: Run /gsd:new-project to create
68
+ Fix: Run $gsd-new-project to create
69
69
  ```
70
70
 
71
71
  **If warnings exist:**
@@ -73,7 +73,7 @@ Errors: N | Warnings: N | Info: N
73
73
  ## Warnings
74
74
 
75
75
  - [W001] STATE.md references phase 5, but only phases 1-3 exist
76
- Fix: Run /gsd:health --repair to regenerate
76
+ Fix: Run $gsd-health --repair to regenerate
77
77
 
78
78
  - [W005] Phase directory "1-setup" doesn't follow NN-name format
79
79
  Fix: Rename to match pattern (e.g., 01-setup)
@@ -90,7 +90,7 @@ Errors: N | Warnings: N | Info: N
90
90
  **Footer (if repairable issues exist and --repair was NOT used):**
91
91
  ```
92
92
  ---
93
- N issues can be auto-repaired. Run: /gsd:health --repair
93
+ N issues can be auto-repaired. Run: $gsd-health --repair
94
94
  ```
95
95
  </step>
96
96
 
@@ -100,7 +100,7 @@ N issues can be auto-repaired. Run: /gsd:health --repair
100
100
  Ask user if they want to run repairs:
101
101
 
102
102
  ```
103
- Would you like to run /gsd:health --repair to fix N issues automatically?
103
+ Would you like to run $gsd-health --repair to fix N issues automatically?
104
104
  ```
105
105
 
106
106
  If yes, re-run with --repair flag and display results.
@@ -9,9 +9,9 @@ Display the complete GSD command reference. Output ONLY the reference content. D
9
9
 
10
10
  ## Quick Start
11
11
 
12
- 1. `/gsd:new-project` - Initialize project (includes research, requirements, roadmap)
13
- 2. `/gsd:plan-phase 1` - Create detailed plan for first phase
14
- 3. `/gsd:execute-phase 1` - Execute the phase
12
+ 1. `$gsd-new-project` - Initialize project (includes research, requirements, roadmap)
13
+ 2. `$gsd-plan-phase 1` - Create detailed plan for first phase
14
+ 3. `$gsd-execute-phase 1` - Execute the phase
15
15
 
16
16
  ## Staying Updated
17
17
 
@@ -24,12 +24,12 @@ npx get-shit-done-cc@latest
24
24
  ## Core Workflow
25
25
 
26
26
  ```
27
- /gsd:new-project → /gsd:plan-phase → /gsd:execute-phase → repeat
27
+ $gsd-new-project → $gsd-plan-phase → $gsd-execute-phase → repeat
28
28
  ```
29
29
 
30
30
  ### Project Initialization
31
31
 
32
- **`/gsd:new-project`**
32
+ **`$gsd-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,30 +46,30 @@ Creates all `.planning/` artifacts:
46
46
  - `ROADMAP.md` — phases mapped to requirements
47
47
  - `STATE.md` — project memory
48
48
 
49
- Usage: `/gsd:new-project`
49
+ Usage: `$gsd-new-project`
50
50
 
51
- **`/gsd:map-codebase`**
51
+ **`$gsd-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 `/gsd:new-project` on existing codebases
57
+ - Use before `$gsd-new-project` on existing codebases
58
58
 
59
- Usage: `/gsd:map-codebase`
59
+ Usage: `$gsd-map-codebase`
60
60
 
61
61
  ### Phase Planning
62
62
 
63
- **`/gsd:discuss-phase <number>`**
63
+ **`$gsd-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
67
67
  - Creates CONTEXT.md with your vision, essentials, and boundaries
68
68
  - Use when you have ideas about how something should look/feel
69
69
 
70
- Usage: `/gsd:discuss-phase 2`
70
+ Usage: `$gsd-discuss-phase 2`
71
71
 
72
- **`/gsd:research-phase <number>`**
72
+ **`$gsd-research-phase <number>`**
73
73
  Comprehensive ecosystem research for niche/complex domains.
74
74
 
75
75
  - Discovers standard stack, architecture patterns, pitfalls
@@ -77,18 +77,18 @@ Comprehensive ecosystem research for niche/complex domains.
77
77
  - Use for 3D, games, audio, shaders, ML, and other specialized domains
78
78
  - Goes beyond "which library" to ecosystem knowledge
79
79
 
80
- Usage: `/gsd:research-phase 3`
80
+ Usage: `$gsd-research-phase 3`
81
81
 
82
- **`/gsd:list-phase-assumptions <number>`**
82
+ **`$gsd-list-phase-assumptions <number>`**
83
83
  See what Codex is planning to do before it starts.
84
84
 
85
85
  - Shows Codex's intended approach for a phase
86
86
  - Lets you course-correct if Codex misunderstood your vision
87
87
  - No files created - conversational output only
88
88
 
89
- Usage: `/gsd:list-phase-assumptions 3`
89
+ Usage: `$gsd-list-phase-assumptions 3`
90
90
 
91
- **`/gsd:plan-phase <number>`**
91
+ **`$gsd-plan-phase <number>`**
92
92
  Create detailed execution plan for a specific phase.
93
93
 
94
94
  - Generates `.planning/phases/XX-phase-name/XX-YY-PLAN.md`
@@ -96,14 +96,14 @@ Create detailed execution plan for a specific phase.
96
96
  - Includes verification criteria and success measures
97
97
  - Multiple plans per phase supported (XX-01, XX-02, etc.)
98
98
 
99
- Usage: `/gsd:plan-phase 1`
99
+ Usage: `$gsd-plan-phase 1`
100
100
  Result: Creates `.planning/phases/01-foundation/01-01-PLAN.md`
101
101
 
102
102
  **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.
103
103
 
104
104
  ### Execution
105
105
 
106
- **`/gsd:execute-phase <phase-number>`**
106
+ **`$gsd-execute-phase <phase-number>`**
107
107
  Execute all plans in a phase.
108
108
 
109
109
  - Groups plans by wave (from frontmatter), executes waves sequentially
@@ -111,11 +111,11 @@ Execute all plans in a phase.
111
111
  - Verifies phase goal after all plans complete
112
112
  - Updates REQUIREMENTS.md, ROADMAP.md, STATE.md
113
113
 
114
- Usage: `/gsd:execute-phase 5`
114
+ Usage: `$gsd-execute-phase 5`
115
115
 
116
116
  ### Quick Mode
117
117
 
118
- **`/gsd:quick`**
118
+ **`$gsd-quick`**
119
119
  Execute small, ad-hoc tasks with GSD guarantees but skip optional agents.
120
120
 
121
121
  Quick mode uses the same system with a shorter path:
@@ -125,31 +125,31 @@ Quick mode uses the same system with a shorter path:
125
125
 
126
126
  Use when you know exactly what to do and the task is small enough to not need research or verification.
127
127
 
128
- Usage: `/gsd:quick`
128
+ Usage: `$gsd-quick`
129
129
  Result: Creates `.planning/quick/NNN-slug/PLAN.md`, `.planning/quick/NNN-slug/SUMMARY.md`
130
130
 
131
131
  ### Roadmap Management
132
132
 
133
- **`/gsd:add-phase <description>`**
133
+ **`$gsd-add-phase <description>`**
134
134
  Add new phase to end of current milestone.
135
135
 
136
136
  - Appends to ROADMAP.md
137
137
  - Uses next sequential number
138
138
  - Updates phase directory structure
139
139
 
140
- Usage: `/gsd:add-phase "Add admin dashboard"`
140
+ Usage: `$gsd-add-phase "Add admin dashboard"`
141
141
 
142
- **`/gsd:insert-phase <after> <description>`**
142
+ **`$gsd-insert-phase <after> <description>`**
143
143
  Insert urgent work as decimal phase between existing phases.
144
144
 
145
145
  - Creates intermediate phase (e.g., 7.1 between 7 and 8)
146
146
  - Useful for discovered work that must happen mid-milestone
147
147
  - Maintains phase ordering
148
148
 
149
- Usage: `/gsd:insert-phase 7 "Fix critical auth bug"`
149
+ Usage: `$gsd-insert-phase 7 "Fix critical auth bug"`
150
150
  Result: Creates Phase 7.1
151
151
 
152
- **`/gsd:remove-phase <number>`**
152
+ **`$gsd-remove-phase <number>`**
153
153
  Remove a future phase and renumber subsequent phases.
154
154
 
155
155
  - Deletes phase directory and all references
@@ -157,12 +157,12 @@ Remove a future phase and renumber subsequent phases.
157
157
  - Only works on future (unstarted) phases
158
158
  - Git commit preserves historical record
159
159
 
160
- Usage: `/gsd:remove-phase 17`
160
+ Usage: `$gsd-remove-phase 17`
161
161
  Result: Phase 17 deleted, phases 18-20 become 17-19
162
162
 
163
163
  ### Milestone Management
164
164
 
165
- **`/gsd:new-milestone <name>`**
165
+ **`$gsd-new-milestone <name>`**
166
166
  Start a new milestone through unified flow.
167
167
 
168
168
  - Deep questioning to understand what you're building next
@@ -170,11 +170,11 @@ Start a new milestone through unified flow.
170
170
  - Requirements definition with scoping
171
171
  - Roadmap creation with phase breakdown
172
172
 
173
- Mirrors `/gsd:new-project` flow for brownfield projects (existing PROJECT.md).
173
+ Mirrors `$gsd-new-project` flow for brownfield projects (existing PROJECT.md).
174
174
 
175
- Usage: `/gsd:new-milestone "v2.0 Features"`
175
+ Usage: `$gsd-new-milestone "v2.0 Features"`
176
176
 
177
- **`/gsd:complete-milestone <version>`**
177
+ **`$gsd-complete-milestone <version>`**
178
178
  Archive completed milestone and prepare for next version.
179
179
 
180
180
  - Creates MILESTONES.md entry with stats
@@ -182,11 +182,11 @@ Archive completed milestone and prepare for next version.
182
182
  - Creates git tag for the release
183
183
  - Prepares workspace for next version
184
184
 
185
- Usage: `/gsd:complete-milestone 1.0.0`
185
+ Usage: `$gsd-complete-milestone 1.0.0`
186
186
 
187
187
  ### Progress Tracking
188
188
 
189
- **`/gsd:progress`**
189
+ **`$gsd-progress`**
190
190
  Check project status and intelligently route to next action.
191
191
 
192
192
  - Shows visual progress bar and completion percentage
@@ -196,45 +196,45 @@ Check project status and intelligently route to next action.
196
196
  - Offers to execute next plan or create it if missing
197
197
  - Detects 100% milestone completion
198
198
 
199
- Usage: `/gsd:progress`
199
+ Usage: `$gsd-progress`
200
200
 
201
201
  ### Session Management
202
202
 
203
- **`/gsd:resume-work`**
203
+ **`$gsd-resume-work`**
204
204
  Resume work from previous session with full context restoration.
205
205
 
206
206
  - Reads STATE.md for project context
207
207
  - Shows current position and recent progress
208
208
  - Offers next actions based on project state
209
209
 
210
- Usage: `/gsd:resume-work`
210
+ Usage: `$gsd-resume-work`
211
211
 
212
- **`/gsd:pause-work`**
212
+ **`$gsd-pause-work`**
213
213
  Create context handoff when pausing work mid-phase.
214
214
 
215
215
  - Creates .continue-here file with current state
216
216
  - Updates STATE.md session continuity section
217
217
  - Captures in-progress work context
218
218
 
219
- Usage: `/gsd:pause-work`
219
+ Usage: `$gsd-pause-work`
220
220
 
221
221
  ### Debugging
222
222
 
223
- **`/gsd:debug [issue description]`**
223
+ **`$gsd-debug [issue description]`**
224
224
  Systematic debugging with persistent state across context resets.
225
225
 
226
226
  - Gathers symptoms through adaptive questioning
227
227
  - Creates `.planning/debug/[slug].md` to track investigation
228
228
  - Investigates using scientific method (evidence → hypothesis → test)
229
- - Survives `/clear` — run `/gsd:debug` with no args to resume
229
+ - Survives `/clear` — run `$gsd-debug` with no args to resume
230
230
  - Archives resolved issues to `.planning/debug/resolved/`
231
231
 
232
- Usage: `/gsd:debug "login button doesn't work"`
233
- Usage: `/gsd:debug` (resume active session)
232
+ Usage: `$gsd-debug "login button doesn't work"`
233
+ Usage: `$gsd-debug` (resume active session)
234
234
 
235
235
  ### Todo Management
236
236
 
237
- **`/gsd:add-todo [description]`**
237
+ **`$gsd-add-todo [description]`**
238
238
  Capture idea or task as todo from current conversation.
239
239
 
240
240
  - Extracts context from conversation (or uses provided description)
@@ -243,24 +243,24 @@ Capture idea or task as todo from current conversation.
243
243
  - Checks for duplicates before creating
244
244
  - Updates STATE.md todo count
245
245
 
246
- Usage: `/gsd:add-todo` (infers from conversation)
247
- Usage: `/gsd:add-todo Add auth token refresh`
246
+ Usage: `$gsd-add-todo` (infers from conversation)
247
+ Usage: `$gsd-add-todo Add auth token refresh`
248
248
 
249
- **`/gsd:check-todos [area]`**
249
+ **`$gsd-check-todos [area]`**
250
250
  List pending todos and select one to work on.
251
251
 
252
252
  - Lists all pending todos with title, area, age
253
- - Optional area filter (e.g., `/gsd:check-todos api`)
253
+ - Optional area filter (e.g., `$gsd-check-todos api`)
254
254
  - Loads full context for selected todo
255
255
  - Routes to appropriate action (work now, add to phase, brainstorm)
256
256
  - Moves todo to done/ when work begins
257
257
 
258
- Usage: `/gsd:check-todos`
259
- Usage: `/gsd:check-todos api`
258
+ Usage: `$gsd-check-todos`
259
+ Usage: `$gsd-check-todos api`
260
260
 
261
261
  ### User Acceptance Testing
262
262
 
263
- **`/gsd:verify-work [phase]`**
263
+ **`$gsd-verify-work [phase]`**
264
264
  Validate built features through conversational UAT.
265
265
 
266
266
  - Extracts testable deliverables from SUMMARY.md files
@@ -268,11 +268,11 @@ Validate built features through conversational UAT.
268
268
  - Automatically diagnoses failures and creates fix plans
269
269
  - Ready for re-execution if issues found
270
270
 
271
- Usage: `/gsd:verify-work 3`
271
+ Usage: `$gsd-verify-work 3`
272
272
 
273
273
  ### Milestone Auditing
274
274
 
275
- **`/gsd:audit-milestone [version]`**
275
+ **`$gsd-audit-milestone [version]`**
276
276
  Audit milestone completion against original intent.
277
277
 
278
278
  - Reads all phase VERIFICATION.md files
@@ -280,41 +280,41 @@ Audit milestone completion against original intent.
280
280
  - Spawns integration checker for cross-phase wiring
281
281
  - Creates MILESTONE-AUDIT.md with gaps and tech debt
282
282
 
283
- Usage: `/gsd:audit-milestone`
283
+ Usage: `$gsd-audit-milestone`
284
284
 
285
- **`/gsd:plan-milestone-gaps`**
285
+ **`$gsd-plan-milestone-gaps`**
286
286
  Create phases to close gaps identified by audit.
287
287
 
288
288
  - Reads MILESTONE-AUDIT.md and groups gaps into phases
289
289
  - Prioritizes by requirement priority (must/should/nice)
290
290
  - Adds gap closure phases to ROADMAP.md
291
- - Ready for `/gsd:plan-phase` on new phases
291
+ - Ready for `$gsd-plan-phase` on new phases
292
292
 
293
- Usage: `/gsd:plan-milestone-gaps`
293
+ Usage: `$gsd-plan-milestone-gaps`
294
294
 
295
295
  ### Configuration
296
296
 
297
- **`/gsd:settings`**
297
+ **`$gsd-settings`**
298
298
  Configure workflow toggles and model profile interactively.
299
299
 
300
300
  - Toggle researcher, plan checker, verifier agents
301
301
  - Select model profile (quality/balanced/budget)
302
302
  - Updates `.planning/config.json`
303
303
 
304
- Usage: `/gsd:settings`
304
+ Usage: `$gsd-settings`
305
305
 
306
- **`/gsd:set-profile <profile>`**
306
+ **`$gsd-set-profile <profile>`**
307
307
  Quick switch model profile for GSD agents.
308
308
 
309
309
  - `quality` — Opus everywhere except verification
310
310
  - `balanced` — Opus for planning, Sonnet for execution (default)
311
311
  - `budget` — Sonnet for writing, Haiku for research/verification
312
312
 
313
- Usage: `/gsd:set-profile budget`
313
+ Usage: `$gsd-set-profile budget`
314
314
 
315
315
  ### Utility Commands
316
316
 
317
- **`/gsd:cleanup`**
317
+ **`$gsd-cleanup`**
318
318
  Archive accumulated phase directories from completed milestones.
319
319
 
320
320
  - Identifies phases from completed milestones still in `.planning/phases/`
@@ -322,12 +322,12 @@ Archive accumulated phase directories from completed milestones.
322
322
  - Moves phase dirs to `.planning/milestones/v{X.Y}-phases/`
323
323
  - Use after multiple milestones to reduce `.planning/phases/` clutter
324
324
 
325
- Usage: `/gsd:cleanup`
325
+ Usage: `$gsd-cleanup`
326
326
 
327
- **`/gsd:help`**
327
+ **`$gsd-help`**
328
328
  Show this command reference.
329
329
 
330
- **`/gsd:update`**
330
+ **`$gsd-update`**
331
331
  Update GSD to latest version with changelog preview.
332
332
 
333
333
  - Shows installed vs latest version comparison
@@ -336,15 +336,15 @@ Update GSD to latest version with changelog preview.
336
336
  - Confirms before running install
337
337
  - Better than raw `npx get-shit-done-cc`
338
338
 
339
- Usage: `/gsd:update`
339
+ Usage: `$gsd-update`
340
340
 
341
- **`/gsd:join-discord`**
341
+ **`$gsd-join-discord`**
342
342
  Join the GSD Discord community.
343
343
 
344
344
  - Get help, share what you're building, stay updated
345
345
  - Connect with other GSD users
346
346
 
347
- Usage: `/gsd:join-discord`
347
+ Usage: `$gsd-join-discord`
348
348
 
349
349
  ## Files & Structure
350
350
 
@@ -363,7 +363,7 @@ Usage: `/gsd:join-discord`
363
363
  ├── milestones/
364
364
  │ ├── v1.0-ROADMAP.md # Archived roadmap snapshot
365
365
  │ ├── v1.0-REQUIREMENTS.md # Archived requirements
366
- │ └── v1.0-phases/ # Archived phase dirs (via /gsd:cleanup or --archive-phases)
366
+ │ └── v1.0-phases/ # Archived phase dirs (via $gsd-cleanup or --archive-phases)
367
367
  │ ├── 01-foundation/
368
368
  │ └── 02-core-features/
369
369
  ├── codebase/ # Codebase map (brownfield projects)
@@ -385,7 +385,7 @@ Usage: `/gsd:join-discord`
385
385
 
386
386
  ## Workflow Modes
387
387
 
388
- Set during `/gsd:new-project`:
388
+ Set during `$gsd-new-project`:
389
389
 
390
390
  **Interactive Mode**
391
391
 
@@ -433,51 +433,51 @@ Example config:
433
433
  **Starting a new project:**
434
434
 
435
435
  ```
436
- /gsd:new-project # Unified flow: questioning → research → requirements → roadmap
436
+ $gsd-new-project # Unified flow: questioning → research → requirements → roadmap
437
437
  /clear
438
- /gsd:plan-phase 1 # Create plans for first phase
438
+ $gsd-plan-phase 1 # Create plans for first phase
439
439
  /clear
440
- /gsd:execute-phase 1 # Execute all plans in phase
440
+ $gsd-execute-phase 1 # Execute all plans in phase
441
441
  ```
442
442
 
443
443
  **Resuming work after a break:**
444
444
 
445
445
  ```
446
- /gsd:progress # See where you left off and continue
446
+ $gsd-progress # See where you left off and continue
447
447
  ```
448
448
 
449
449
  **Adding urgent mid-milestone work:**
450
450
 
451
451
  ```
452
- /gsd:insert-phase 5 "Critical security fix"
453
- /gsd:plan-phase 5.1
454
- /gsd:execute-phase 5.1
452
+ $gsd-insert-phase 5 "Critical security fix"
453
+ $gsd-plan-phase 5.1
454
+ $gsd-execute-phase 5.1
455
455
  ```
456
456
 
457
457
  **Completing a milestone:**
458
458
 
459
459
  ```
460
- /gsd:complete-milestone 1.0.0
460
+ $gsd-complete-milestone 1.0.0
461
461
  /clear
462
- /gsd:new-milestone # Start next milestone (questioning → research → requirements → roadmap)
462
+ $gsd-new-milestone # Start next milestone (questioning → research → requirements → roadmap)
463
463
  ```
464
464
 
465
465
  **Capturing ideas during work:**
466
466
 
467
467
  ```
468
- /gsd:add-todo # Capture from conversation context
469
- /gsd:add-todo Fix modal z-index # Capture with explicit description
470
- /gsd:check-todos # Review and work on todos
471
- /gsd:check-todos api # Filter by area
468
+ $gsd-add-todo # Capture from conversation context
469
+ $gsd-add-todo Fix modal z-index # Capture with explicit description
470
+ $gsd-check-todos # Review and work on todos
471
+ $gsd-check-todos api # Filter by area
472
472
  ```
473
473
 
474
474
  **Debugging an issue:**
475
475
 
476
476
  ```
477
- /gsd:debug "form submission fails silently" # Start debug session
477
+ $gsd-debug "form submission fails silently" # Start debug session
478
478
  # ... investigation happens, context fills up ...
479
479
  /clear
480
- /gsd:debug # Resume from where you left off
480
+ $gsd-debug # Resume from where you left off
481
481
  ```
482
482
 
483
483
  ## Getting Help
@@ -485,5 +485,5 @@ Example config:
485
485
  - Read `.planning/PROJECT.md` for project vision
486
486
  - Read `.planning/STATE.md` for current context
487
487
  - Check `.planning/ROADMAP.md` for phase status
488
- - Run `/gsd:progress` to check where you're up to
488
+ - Run `$gsd-progress` to check where you're up to
489
489
  </reference>
@@ -13,7 +13,7 @@ Parse the command arguments:
13
13
  - First argument: integer phase number to insert after
14
14
  - Remaining arguments: phase description
15
15
 
16
- Example: `/gsd:insert-phase 72 Fix critical auth bug`
16
+ Example: `$gsd-insert-phase 72 Fix critical auth bug`
17
17
  -> after = 72
18
18
  -> description = "Fix critical auth bug"
19
19
 
@@ -21,8 +21,8 @@ If arguments missing:
21
21
 
22
22
  ```
23
23
  ERROR: Both phase number and description required
24
- Usage: /gsd:insert-phase <after> <description>
25
- Example: /gsd:insert-phase 72 Fix critical auth bug
24
+ Usage: $gsd-insert-phase <after> <description>
25
+ Example: $gsd-insert-phase 72 Fix critical auth bug
26
26
  ```
27
27
 
28
28
  Exit.
@@ -92,7 +92,7 @@ Project state updated: .planning/STATE.md
92
92
 
93
93
  **Phase {decimal_phase}: {description}** -- urgent insertion
94
94
 
95
- `/gsd:plan-phase {decimal_phase}`
95
+ `$gsd-plan-phase {decimal_phase}`
96
96
 
97
97
  <sub>`/clear` first -> fresh context window</sub>
98
98
 
@@ -110,11 +110,11 @@ Project state updated: .planning/STATE.md
110
110
 
111
111
  <anti_patterns>
112
112
 
113
- - Don't use this for planned work at end of milestone (use /gsd:add-phase)
113
+ - Don't use this for planned work at end of milestone (use $gsd-add-phase)
114
114
  - Don't insert before Phase 1 (decimal 0.1 makes no sense)
115
115
  - Don't renumber existing phases
116
116
  - Don't modify the target phase content
117
- - Don't create plans yet (that's /gsd:plan-phase)
117
+ - Don't create plans yet (that's $gsd-plan-phase)
118
118
  - Don't commit changes (user decides when to commit)
119
119
  </anti_patterns>
120
120
 
@@ -14,8 +14,8 @@ Phase number: $ARGUMENTS (required)
14
14
  ```
15
15
  Error: Phase number required.
16
16
 
17
- Usage: /gsd:list-phase-assumptions [phase-number]
18
- Example: /gsd:list-phase-assumptions 3
17
+ Usage: $gsd-list-phase-assumptions [phase-number]
18
+ Example: $gsd-list-phase-assumptions 3
19
19
  ```
20
20
 
21
21
  Exit workflow.
@@ -153,8 +153,8 @@ Present next steps:
153
153
 
154
154
  ```
155
155
  What's next?
156
- 1. Discuss context (/gsd:discuss-phase ${PHASE}) - Let me ask you questions to build comprehensive context
157
- 2. Plan this phase (/gsd:plan-phase ${PHASE}) - Create detailed execution plans
156
+ 1. Discuss context ($gsd-discuss-phase ${PHASE}) - Let me ask you questions to build comprehensive context
157
+ 2. Plan this phase ($gsd-plan-phase ${PHASE}) - Create detailed execution plans
158
158
  3. Re-examine assumptions - I'll analyze again with your corrections
159
159
  4. Done for now
160
160
  ```
@@ -285,14 +285,14 @@ Created .planning/codebase/:
285
285
 
286
286
  **Initialize project** — use codebase context for planning
287
287
 
288
- `/gsd:new-project`
288
+ `$gsd-new-project`
289
289
 
290
290
  <sub>`/clear` first → fresh context window</sub>
291
291
 
292
292
  ---
293
293
 
294
294
  **Also available:**
295
- - Re-run mapping: `/gsd:map-codebase`
295
+ - Re-run mapping: `$gsd-map-codebase`
296
296
  - Review specific file: `cat .planning/codebase/STACK.md`
297
297
  - Edit any document before proceeding
298
298