@undeemed/get-shit-done-codex 1.20.10 → 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 (73) hide show
  1. package/.codex/config.toml +77 -0
  2. package/README.md +53 -42
  3. package/agents/gsd-codebase-mapper.md +3 -3
  4. package/agents/gsd-debugger.md +5 -5
  5. package/agents/gsd-executor.md +14 -14
  6. package/agents/gsd-phase-researcher.md +7 -7
  7. package/agents/gsd-plan-checker.md +10 -10
  8. package/agents/gsd-planner.md +19 -19
  9. package/agents/gsd-project-researcher.md +3 -3
  10. package/agents/gsd-research-synthesizer.md +6 -6
  11. package/agents/gsd-roadmapper.md +7 -7
  12. package/agents/gsd-verifier.md +29 -17
  13. package/bin/install.js +161 -208
  14. package/commands/gsd/add-tests.md +5 -4
  15. package/commands/gsd/complete-milestone.md +6 -6
  16. package/commands/gsd/debug.md +1 -1
  17. package/commands/gsd/map-codebase.md +3 -3
  18. package/commands/gsd/new-milestone.md +1 -1
  19. package/commands/gsd/new-project.md +1 -1
  20. package/commands/gsd/plan-milestone-gaps.md +2 -2
  21. package/commands/gsd/reapply-patches.md +2 -2
  22. package/commands/gsd/research-phase.md +3 -3
  23. package/commands/gsd/verify-work.md +1 -1
  24. package/{AGENTS.md → get-shit-done/AGENTS.md} +1 -1
  25. package/get-shit-done/bin/lib/commands.cjs +1 -1
  26. package/get-shit-done/bin/lib/phase.cjs +2 -2
  27. package/get-shit-done/bin/lib/verify.cjs +8 -8
  28. package/get-shit-done/references/continuation-format.md +16 -16
  29. package/get-shit-done/references/model-profiles.md +1 -1
  30. package/get-shit-done/references/ui-brand.md +2 -2
  31. package/get-shit-done/templates/DEBUG.md +1 -1
  32. package/get-shit-done/templates/UAT.md +3 -3
  33. package/get-shit-done/templates/VALIDATION.md +1 -1
  34. package/get-shit-done/templates/debug-subagent-prompt.md +1 -1
  35. package/get-shit-done/templates/discovery.md +2 -2
  36. package/get-shit-done/templates/phase-prompt.md +1 -1
  37. package/get-shit-done/templates/planner-subagent-prompt.md +3 -3
  38. package/get-shit-done/templates/project.md +1 -1
  39. package/get-shit-done/templates/research.md +1 -1
  40. package/get-shit-done/templates/retrospective.md +13 -7
  41. package/get-shit-done/templates/state.md +2 -2
  42. package/get-shit-done/workflows/add-phase.md +7 -7
  43. package/get-shit-done/workflows/add-tests.md +41 -18
  44. package/get-shit-done/workflows/add-todo.md +2 -2
  45. package/get-shit-done/workflows/audit-milestone.md +5 -5
  46. package/get-shit-done/workflows/check-todos.md +8 -8
  47. package/get-shit-done/workflows/complete-milestone.md +33 -8
  48. package/get-shit-done/workflows/diagnose-issues.md +1 -1
  49. package/get-shit-done/workflows/discovery-phase.md +3 -3
  50. package/get-shit-done/workflows/discuss-phase.md +10 -10
  51. package/get-shit-done/workflows/execute-phase.md +7 -7
  52. package/get-shit-done/workflows/execute-plan.md +3 -3
  53. package/get-shit-done/workflows/health.md +5 -5
  54. package/get-shit-done/workflows/help.md +85 -85
  55. package/get-shit-done/workflows/insert-phase.md +6 -6
  56. package/get-shit-done/workflows/list-phase-assumptions.md +4 -4
  57. package/get-shit-done/workflows/map-codebase.md +2 -2
  58. package/get-shit-done/workflows/new-milestone.md +5 -5
  59. package/get-shit-done/workflows/new-project.md +11 -11
  60. package/get-shit-done/workflows/pause-work.md +1 -1
  61. package/get-shit-done/workflows/plan-milestone-gaps.md +7 -7
  62. package/get-shit-done/workflows/plan-phase.md +12 -12
  63. package/get-shit-done/workflows/progress.md +22 -22
  64. package/get-shit-done/workflows/quick.md +3 -3
  65. package/get-shit-done/workflows/remove-phase.md +6 -6
  66. package/get-shit-done/workflows/research-phase.md +2 -2
  67. package/get-shit-done/workflows/resume-project.md +9 -9
  68. package/get-shit-done/workflows/settings.md +5 -5
  69. package/get-shit-done/workflows/transition.md +10 -10
  70. package/get-shit-done/workflows/update.md +2 -2
  71. package/get-shit-done/workflows/verify-work.md +8 -8
  72. package/package.json +2 -2
  73. package/commands/gsd/new-project.md.bak +0 -1041
@@ -17,7 +17,7 @@ Read all files referenced by the invoking prompt's execution_context before star
17
17
  - Read PROJECT.md (existing project, validated requirements, decisions)
18
18
  - Read MILESTONES.md (what shipped previously)
19
19
  - Read STATE.md (pending todos, blockers)
20
- - Check for MILESTONE-CONTEXT.md (from /gsd:discuss-milestone)
20
+ - Check for MILESTONE-CONTEXT.md (from $gsd-discuss-milestone)
21
21
 
22
22
  ## 2. Gather Milestone Goals
23
23
 
@@ -88,7 +88,7 @@ AskUserQuestion: "Research the domain ecosystem for new features before defining
88
88
  - "Research first (Recommended)" — Discover patterns, features, architecture for NEW capabilities
89
89
  - "Skip research" — Go straight to requirements
90
90
 
91
- **Persist choice to config** (so future `/gsd:plan-phase` honors it):
91
+ **Persist choice to config** (so future `$gsd-plan-phase` honors it):
92
92
 
93
93
  ```bash
94
94
  # If "Research first": persist true
@@ -355,11 +355,11 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs: create milestone v[X
355
355
 
356
356
  **Phase [N]: [Phase Name]** — [Goal]
357
357
 
358
- `/gsd:discuss-phase [N]` — gather context and clarify approach
358
+ `$gsd-discuss-phase [N]` — gather context and clarify approach
359
359
 
360
360
  <sub>`/clear` first → fresh context window</sub>
361
361
 
362
- Also: `/gsd:plan-phase [N]` — skip discussion, plan directly
362
+ Also: `$gsd-plan-phase [N]` — skip discussion, plan directly
363
363
  ```
364
364
 
365
365
  </process>
@@ -376,7 +376,7 @@ Also: `/gsd:plan-phase [N]` — skip discussion, plan directly
376
376
  - [ ] User feedback incorporated (if any)
377
377
  - [ ] ROADMAP.md phases continue from previous milestone
378
378
  - [ ] All commits made (if planning docs committed)
379
- - [ ] User knows next step: `/gsd:discuss-phase [N]`
379
+ - [ ] User knows next step: `$gsd-discuss-phase [N]`
380
380
 
381
381
  **Atomic commits:** Each phase commits its artifacts immediately.
382
382
  </success_criteria>
@@ -23,7 +23,7 @@ Check if `--auto` flag is present in $ARGUMENTS.
23
23
 
24
24
  **Document requirement:**
25
25
  Auto mode requires an idea document — either:
26
- - File reference: `/gsd:new-project --auto @prd.md`
26
+ - File reference: `$gsd-new-project --auto @prd.md`
27
27
  - Pasted/written text in the prompt
28
28
 
29
29
  If no document content provided, error:
@@ -32,8 +32,8 @@ If no document content provided, error:
32
32
  Error: --auto requires an idea document.
33
33
 
34
34
  Usage:
35
- /gsd:new-project --auto @your-idea.md
36
- /gsd:new-project --auto [paste or write your idea here]
35
+ $gsd-new-project --auto @your-idea.md
36
+ $gsd-new-project --auto [paste or write your idea here]
37
37
 
38
38
  The document should describe what you want to build.
39
39
  ```
@@ -51,7 +51,7 @@ INIT=$(node ~/.codex/get-shit-done/bin/gsd-tools.cjs init new-project)
51
51
 
52
52
  Parse JSON for: `researcher_model`, `synthesizer_model`, `roadmapper_model`, `commit_docs`, `project_exists`, `has_codebase_map`, `planning_exists`, `has_existing_code`, `has_package_file`, `is_brownfield`, `needs_codebase_map`, `has_git`, `project_path`.
53
53
 
54
- **If `project_exists` is true:** Error — project already initialized. Use `/gsd:progress`.
54
+ **If `project_exists` is true:** Error — project already initialized. Use `$gsd-progress`.
55
55
 
56
56
  **If `has_git` is false:** Initialize git:
57
57
  ```bash
@@ -68,12 +68,12 @@ Use AskUserQuestion:
68
68
  - header: "Codebase"
69
69
  - question: "I detected existing code in this directory. Would you like to map the codebase first?"
70
70
  - options:
71
- - "Map codebase first" — Run /gsd:map-codebase to understand existing architecture (Recommended)
71
+ - "Map codebase first" — Run $gsd-map-codebase to understand existing architecture (Recommended)
72
72
  - "Skip mapping" — Proceed with project initialization
73
73
 
74
74
  **If "Map codebase first":**
75
75
  ```
76
- Run `/gsd:map-codebase` first, then return to `/gsd:new-project`
76
+ Run `$gsd-map-codebase` first, then return to `$gsd-new-project`
77
77
  ```
78
78
  Exit command.
79
79
 
@@ -493,7 +493,7 @@ Create `.planning/config.json` with all settings:
493
493
  node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "chore: add project config" --files .planning/config.json
494
494
  ```
495
495
 
496
- **Note:** Run `/gsd:settings` anytime to update these preferences.
496
+ **Note:** Run `$gsd-settings` anytime to update these preferences.
497
497
 
498
498
  ## 5.5. Resolve Model Profile
499
499
 
@@ -1050,7 +1050,7 @@ Present completion summary:
1050
1050
  ╚══════════════════════════════════════════╝
1051
1051
  ```
1052
1052
 
1053
- Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
1053
+ Exit skill and invoke SlashCommand("$gsd-discuss-phase 1 --auto")
1054
1054
 
1055
1055
  **If interactive mode:**
1056
1056
 
@@ -1061,14 +1061,14 @@ Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
1061
1061
 
1062
1062
  **Phase 1: [Phase Name]** — [Goal from ROADMAP.md]
1063
1063
 
1064
- /gsd:discuss-phase 1 — gather context and clarify approach
1064
+ $gsd-discuss-phase 1 — gather context and clarify approach
1065
1065
 
1066
1066
  <sub>/clear first → fresh context window</sub>
1067
1067
 
1068
1068
  ---
1069
1069
 
1070
1070
  **Also available:**
1071
- - /gsd:plan-phase 1 — skip discussion, plan directly
1071
+ - $gsd-plan-phase 1 — skip discussion, plan directly
1072
1072
 
1073
1073
  ───────────────────────────────────────────────────────────────
1074
1074
  ```
@@ -1109,7 +1109,7 @@ Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
1109
1109
  - [ ] ROADMAP.md created with phases, requirement mappings, success criteria
1110
1110
  - [ ] STATE.md initialized
1111
1111
  - [ ] REQUIREMENTS.md traceability updated
1112
- - [ ] User knows next step is `/gsd:discuss-phase 1`
1112
+ - [ ] User knows next step is `$gsd-discuss-phase 1`
1113
1113
 
1114
1114
  **Atomic commits:** Each phase commits its artifacts immediately. If context is lost, artifacts persist.
1115
1115
 
@@ -107,7 +107,7 @@ Current state:
107
107
  - Status: [in_progress/blocked]
108
108
  - Committed as WIP
109
109
 
110
- To resume: /gsd:resume-work
110
+ To resume: $gsd-resume-work
111
111
 
112
112
  ```
113
113
  </step>
@@ -1,5 +1,5 @@
1
1
  <purpose>
2
- Create all phases necessary to close gaps identified by `/gsd:audit-milestone`. Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase. One command creates all fix phases — no manual `/gsd:add-phase` per gap.
2
+ Create all phases necessary to close gaps identified by `$gsd-audit-milestone`. Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase. One command creates all fix phases — no manual `$gsd-add-phase` per gap.
3
3
  </purpose>
4
4
 
5
5
  <required_reading>
@@ -22,7 +22,7 @@ Parse YAML frontmatter to extract structured gaps:
22
22
 
23
23
  If no audit file exists or has no gaps, error:
24
24
  ```
25
- No audit gaps found. Run `/gsd:audit-milestone` first.
25
+ No audit gaps found. Run `$gsd-audit-milestone` first.
26
26
  ```
27
27
 
28
28
  ## 2. Prioritize Gaps
@@ -164,22 +164,22 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs(roadmap): add gap clo
164
164
 
165
165
  **Plan first gap closure phase**
166
166
 
167
- `/gsd:plan-phase {N}`
167
+ `$gsd-plan-phase {N}`
168
168
 
169
169
  <sub>`/clear` first → fresh context window</sub>
170
170
 
171
171
  ---
172
172
 
173
173
  **Also available:**
174
- - `/gsd:execute-phase {N}` — if plans already exist
174
+ - `$gsd-execute-phase {N}` — if plans already exist
175
175
  - `cat .planning/ROADMAP.md` — see updated roadmap
176
176
 
177
177
  ---
178
178
 
179
179
  **After all gap phases complete:**
180
180
 
181
- `/gsd:audit-milestone` — re-audit to verify gaps closed
182
- `/gsd:complete-milestone {version}` — archive when audit passes
181
+ `$gsd-audit-milestone` — re-audit to verify gaps closed
182
+ `$gsd-complete-milestone {version}` — archive when audit passes
183
183
  ```
184
184
 
185
185
  </process>
@@ -270,5 +270,5 @@ becomes:
270
270
  - [ ] Coverage count updated in REQUIREMENTS.md
271
271
  - [ ] Phase directories created
272
272
  - [ ] Changes committed (includes REQUIREMENTS.md)
273
- - [ ] User knows to run `/gsd:plan-phase` next
273
+ - [ ] User knows to run `$gsd-plan-phase` next
274
274
  </success_criteria>
@@ -22,7 +22,7 @@ Parse JSON for: `researcher_model`, `planner_model`, `checker_model`, `research_
22
22
 
23
23
  **File paths (for <files_to_read> blocks):** `state_path`, `roadmap_path`, `requirements_path`, `context_path`, `research_path`, `verification_path`, `uat_path`. These are null if files don't exist.
24
24
 
25
- **If `planning_exists` is false:** Error — run `/gsd:new-project` first.
25
+ **If `planning_exists` is false:** Error — run `$gsd-new-project` first.
26
26
 
27
27
  ## 2. Parse and Normalize Arguments
28
28
 
@@ -61,7 +61,7 @@ Use AskUserQuestion:
61
61
  - "Run discuss-phase first" — Capture design decisions before planning
62
62
 
63
63
  If "Continue without context": Proceed to step 5.
64
- If "Run discuss-phase first": Display `/gsd:discuss-phase {X}` and exit workflow.
64
+ If "Run discuss-phase first": Display `$gsd-discuss-phase {X}` and exit workflow.
65
65
 
66
66
  ## 5. Handle Research
67
67
 
@@ -96,7 +96,7 @@ Answer: "What do I need to know to PLAN this phase well?"
96
96
  </objective>
97
97
 
98
98
  <files_to_read>
99
- - {context_path} (USER DECISIONS from /gsd:discuss-phase)
99
+ - {context_path} (USER DECISIONS from $gsd-discuss-phase)
100
100
  - {requirements_path} (Project requirements)
101
101
  - {state_path} (Project decisions and history)
102
102
  </files_to_read>
@@ -197,7 +197,7 @@ Planner prompt:
197
197
  - {state_path} (Project State)
198
198
  - {roadmap_path} (Roadmap)
199
199
  - {requirements_path} (Requirements)
200
- - {context_path} (USER DECISIONS from /gsd:discuss-phase)
200
+ - {context_path} (USER DECISIONS from $gsd-discuss-phase)
201
201
  - {research_path} (Technical Research)
202
202
  - {verification_path} (Verification Gaps - if --gaps)
203
203
  - {uat_path} (UAT Gaps - if --gaps)
@@ -210,7 +210,7 @@ Planner prompt:
210
210
  </planning_context>
211
211
 
212
212
  <downstream_consumer>
213
- Output consumed by /gsd:execute-phase. Plans need:
213
+ Output consumed by $gsd-execute-phase. Plans need:
214
214
  - Frontmatter (wave, depends_on, files_modified, autonomous)
215
215
  - Tasks in XML format
216
216
  - Verification criteria
@@ -264,7 +264,7 @@ Checker prompt:
264
264
  - {PHASE_DIR}/*-PLAN.md (Plans to verify)
265
265
  - {roadmap_path} (Roadmap)
266
266
  - {requirements_path} (Requirements)
267
- - {context_path} (USER DECISIONS from /gsd:discuss-phase)
267
+ - {context_path} (USER DECISIONS from $gsd-discuss-phase)
268
268
  - {research_path} (Technical Research — includes Validation Architecture)
269
269
  </files_to_read>
270
270
 
@@ -311,7 +311,7 @@ Revision prompt:
311
311
 
312
312
  <files_to_read>
313
313
  - {PHASE_DIR}/*-PLAN.md (Existing plans)
314
- - {context_path} (USER DECISIONS from /gsd:discuss-phase)
314
+ - {context_path} (USER DECISIONS from $gsd-discuss-phase)
315
315
  </files_to_read>
316
316
 
317
317
  **Checker issues:** {structured_issues_from_checker}
@@ -393,7 +393,7 @@ Task(
393
393
  4. When spawning executor agents, use subagent_type='gsd-executor' with the existing @file pattern from the workflow
394
394
  5. When spawning verifier agents, use subagent_type='gsd-verifier'
395
395
  6. Preserve the classifyHandoffIfNeeded workaround (spot-check on that specific error)
396
- 7. Do NOT use the Skill tool or /gsd: commands
396
+ 7. Do NOT use the Skill tool or $gsd- commands
397
397
  </instructions>
398
398
  ",
399
399
  subagent_type="general-purpose",
@@ -410,14 +410,14 @@ Task(
410
410
 
411
411
  Auto-advance pipeline finished.
412
412
 
413
- Next: /gsd:discuss-phase ${NEXT_PHASE} --auto
413
+ Next: $gsd-discuss-phase ${NEXT_PHASE} --auto
414
414
  ```
415
415
  - **GAPS FOUND / VERIFICATION FAILED** → Display result, stop chain:
416
416
  ```
417
417
  Auto-advance stopped: Execution needs review.
418
418
 
419
419
  Review the output above and continue manually:
420
- /gsd:execute-phase ${PHASE}
420
+ $gsd-execute-phase ${PHASE}
421
421
  ```
422
422
 
423
423
  **If neither `--auto` nor config enabled:**
@@ -448,7 +448,7 @@ Verification: {Passed | Passed with override | Skipped}
448
448
 
449
449
  **Execute Phase {X}** — run all {N} plans
450
450
 
451
- /gsd:execute-phase {X}
451
+ $gsd-execute-phase {X}
452
452
 
453
453
  <sub>/clear first → fresh context window</sub>
454
454
 
@@ -456,7 +456,7 @@ Verification: {Passed | Passed with override | Skipped}
456
456
 
457
457
  **Also available:**
458
458
  - cat .planning/phases/{phase-dir}/*-PLAN.md — review plans
459
- - /gsd:plan-phase {X} --research — re-research first
459
+ - $gsd-plan-phase {X} --research — re-research first
460
460
 
461
461
  ───────────────────────────────────────────────────────────────
462
462
  </offer_next>
@@ -22,18 +22,18 @@ If `project_exists` is false (no `.planning/` directory):
22
22
  ```
23
23
  No planning structure found.
24
24
 
25
- Run /gsd:new-project to start a new project.
25
+ Run $gsd-new-project to start a new project.
26
26
  ```
27
27
 
28
28
  Exit.
29
29
 
30
- If missing STATE.md: suggest `/gsd:new-project`.
30
+ If missing STATE.md: suggest `$gsd-new-project`.
31
31
 
32
32
  **If ROADMAP.md missing but PROJECT.md exists:**
33
33
 
34
34
  This means a milestone was completed and archived. Go to **Route F** (between milestones).
35
35
 
36
- If missing both ROADMAP.md and PROJECT.md: suggest `/gsd:new-project`.
36
+ If missing both ROADMAP.md and PROJECT.md: suggest `$gsd-new-project`.
37
37
  </step>
38
38
 
39
39
  <step name="load">
@@ -117,10 +117,10 @@ CONTEXT: [✓ if has_context | - if not]
117
117
  - [e.g. jq -r '.blockers[].text' from state-snapshot]
118
118
 
119
119
  ## Pending Todos
120
- - [count] pending — /gsd:check-todos to review
120
+ - [count] pending — $gsd-check-todos to review
121
121
 
122
122
  ## Active Debug Sessions
123
- - [count] active — /gsd:debug to continue
123
+ - [count] active — $gsd-debug to continue
124
124
  (Only show this section if count > 0)
125
125
 
126
126
  ## What's Next
@@ -179,7 +179,7 @@ Read its `<objective>` section.
179
179
 
180
180
  **{phase}-{plan}: [Plan Name]** — [objective summary from PLAN.md]
181
181
 
182
- `/gsd:execute-phase {phase}`
182
+ `$gsd-execute-phase {phase}`
183
183
 
184
184
  <sub>`/clear` first → fresh context window</sub>
185
185
 
@@ -202,7 +202,7 @@ Check if `{phase_num}-CONTEXT.md` exists in phase directory.
202
202
  **Phase {N}: {Name}** — {Goal from ROADMAP.md}
203
203
  <sub>✓ Context gathered, ready to plan</sub>
204
204
 
205
- `/gsd:plan-phase {phase-number}`
205
+ `$gsd-plan-phase {phase-number}`
206
206
 
207
207
  <sub>`/clear` first → fresh context window</sub>
208
208
 
@@ -218,15 +218,15 @@ Check if `{phase_num}-CONTEXT.md` exists in phase directory.
218
218
 
219
219
  **Phase {N}: {Name}** — {Goal from ROADMAP.md}
220
220
 
221
- `/gsd:discuss-phase {phase}` — gather context and clarify approach
221
+ `$gsd-discuss-phase {phase}` — gather context and clarify approach
222
222
 
223
223
  <sub>`/clear` first → fresh context window</sub>
224
224
 
225
225
  ---
226
226
 
227
227
  **Also available:**
228
- - `/gsd:plan-phase {phase}` — skip discussion, plan directly
229
- - `/gsd:list-phase-assumptions {phase}` — see Codex's assumptions
228
+ - `$gsd-plan-phase {phase}` — skip discussion, plan directly
229
+ - `$gsd-list-phase-assumptions {phase}` — see Codex's assumptions
230
230
 
231
231
  ---
232
232
  ```
@@ -244,15 +244,15 @@ UAT.md exists with gaps (diagnosed issues). User needs to plan fixes.
244
244
 
245
245
  **{phase_num}-UAT.md** has {N} gaps requiring fixes.
246
246
 
247
- `/gsd:plan-phase {phase} --gaps`
247
+ `$gsd-plan-phase {phase} --gaps`
248
248
 
249
249
  <sub>`/clear` first → fresh context window</sub>
250
250
 
251
251
  ---
252
252
 
253
253
  **Also available:**
254
- - `/gsd:execute-phase {phase}` — execute phase plans
255
- - `/gsd:verify-work {phase}` — run more UAT testing
254
+ - `$gsd-execute-phase {phase}` — execute phase plans
255
+ - `$gsd-verify-work {phase}` — run more UAT testing
256
256
 
257
257
  ---
258
258
  ```
@@ -291,15 +291,15 @@ Read ROADMAP.md to get the next phase's name and goal.
291
291
 
292
292
  **Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
293
293
 
294
- `/gsd:discuss-phase {Z+1}` — gather context and clarify approach
294
+ `$gsd-discuss-phase {Z+1}` — gather context and clarify approach
295
295
 
296
296
  <sub>`/clear` first → fresh context window</sub>
297
297
 
298
298
  ---
299
299
 
300
300
  **Also available:**
301
- - `/gsd:plan-phase {Z+1}` — skip discussion, plan directly
302
- - `/gsd:verify-work {Z}` — user acceptance test before continuing
301
+ - `$gsd-plan-phase {Z+1}` — skip discussion, plan directly
302
+ - `$gsd-verify-work {Z}` — user acceptance test before continuing
303
303
 
304
304
  ---
305
305
  ```
@@ -319,14 +319,14 @@ All {N} phases finished!
319
319
 
320
320
  **Complete Milestone** — archive and prepare for next
321
321
 
322
- `/gsd:complete-milestone`
322
+ `$gsd-complete-milestone`
323
323
 
324
324
  <sub>`/clear` first → fresh context window</sub>
325
325
 
326
326
  ---
327
327
 
328
328
  **Also available:**
329
- - `/gsd:verify-work` — user acceptance test before completing milestone
329
+ - `$gsd-verify-work` — user acceptance test before completing milestone
330
330
 
331
331
  ---
332
332
  ```
@@ -350,7 +350,7 @@ Ready to plan the next milestone.
350
350
 
351
351
  **Start Next Milestone** — questioning → research → requirements → roadmap
352
352
 
353
- `/gsd:new-milestone`
353
+ `$gsd-new-milestone`
354
354
 
355
355
  <sub>`/clear` first → fresh context window</sub>
356
356
 
@@ -362,10 +362,10 @@ Ready to plan the next milestone.
362
362
  <step name="edge_cases">
363
363
  **Handle edge cases:**
364
364
 
365
- - Phase complete but next phase not planned → offer `/gsd:plan-phase [next]`
365
+ - Phase complete but next phase not planned → offer `$gsd-plan-phase [next]`
366
366
  - All work complete → offer milestone completion
367
367
  - Blockers present → highlight before offering to continue
368
- - Handoff file exists → mention it, offer `/gsd:resume-work`
368
+ - Handoff file exists → mention it, offer `$gsd-resume-work`
369
369
  </step>
370
370
 
371
371
  </process>
@@ -375,7 +375,7 @@ Ready to plan the next milestone.
375
375
  - [ ] Rich context provided (recent work, decisions, issues)
376
376
  - [ ] Current position clear with visual progress
377
377
  - [ ] What's next clearly explained
378
- - [ ] Smart routing: /gsd:execute-phase if plans exist, /gsd:plan-phase if not
378
+ - [ ] Smart routing: $gsd-execute-phase if plans exist, $gsd-plan-phase if not
379
379
  - [ ] User confirms before any action
380
380
  - [ ] Seamless handoff to appropriate gsd command
381
381
  </success_criteria>
@@ -48,7 +48,7 @@ INIT=$(node ~/.codex/get-shit-done/bin/gsd-tools.cjs init quick "$DESCRIPTION")
48
48
 
49
49
  Parse JSON for: `planner_model`, `executor_model`, `checker_model`, `verifier_model`, `commit_docs`, `next_num`, `slug`, `date`, `timestamp`, `quick_dir`, `task_dir`, `roadmap_exists`, `planning_exists`.
50
50
 
51
- **If `roadmap_exists` is false:** Error — Quick mode requires an active project with ROADMAP.md. Run `/gsd:new-project` first.
51
+ **If `roadmap_exists` is false:** Error — Quick mode requires an active project with ROADMAP.md. Run `$gsd-new-project` first.
52
52
 
53
53
  Quick tasks can run mid-phase - validation only checks ROADMAP.md exists, not phase status.
54
54
 
@@ -416,7 +416,7 @@ Commit: ${commit_hash}
416
416
 
417
417
  ---
418
418
 
419
- Ready for next task: /gsd:quick
419
+ Ready for next task: $gsd-quick
420
420
  ```
421
421
 
422
422
  **If NOT `$FULL_MODE`:**
@@ -432,7 +432,7 @@ Commit: ${commit_hash}
432
432
 
433
433
  ---
434
434
 
435
- Ready for next task: /gsd:quick
435
+ Ready for next task: $gsd-quick
436
436
  ```
437
437
 
438
438
  </process>
@@ -11,15 +11,15 @@ Read all files referenced by the invoking prompt's execution_context before star
11
11
  <step name="parse_arguments">
12
12
  Parse the command arguments:
13
13
  - Argument is the phase number to remove (integer or decimal)
14
- - Example: `/gsd:remove-phase 17` → phase = 17
15
- - Example: `/gsd:remove-phase 16.1` → phase = 16.1
14
+ - Example: `$gsd-remove-phase 17` → phase = 17
15
+ - Example: `$gsd-remove-phase 16.1` → phase = 16.1
16
16
 
17
17
  If no argument provided:
18
18
 
19
19
  ```
20
20
  ERROR: Phase number required
21
- Usage: /gsd:remove-phase <phase-number>
22
- Example: /gsd:remove-phase 17
21
+ Usage: $gsd-remove-phase <phase-number>
22
+ Example: $gsd-remove-phase 17
23
23
  ```
24
24
 
25
25
  Exit.
@@ -52,7 +52,7 @@ Only future phases can be removed:
52
52
  - Current phase: {current}
53
53
  - Phase {target} is current or completed
54
54
 
55
- To abandon current work, use /gsd:pause-work instead.
55
+ To abandon current work, use $gsd-pause-work instead.
56
56
  ```
57
57
 
58
58
  Exit.
@@ -125,7 +125,7 @@ Changes:
125
125
  ## What's Next
126
126
 
127
127
  Would you like to:
128
- - `/gsd:progress` — see updated roadmap status
128
+ - `$gsd-progress` — see updated roadmap status
129
129
  - Continue with current phase
130
130
  - Review roadmap
131
131
 
@@ -1,7 +1,7 @@
1
1
  <purpose>
2
2
  Research how to implement a phase. Spawns gsd-phase-researcher with phase context.
3
3
 
4
- Standalone research command. For most workflows, use `/gsd:plan-phase` which integrates research automatically.
4
+ Standalone research command. For most workflows, use `$gsd-plan-phase` which integrates research automatically.
5
5
  </purpose>
6
6
 
7
7
  <process>
@@ -47,7 +47,7 @@ Research implementation approach for Phase {phase}: {name}
47
47
  </objective>
48
48
 
49
49
  <files_to_read>
50
- - {context_path} (USER DECISIONS from /gsd:discuss-phase)
50
+ - {context_path} (USER DECISIONS from $gsd-discuss-phase)
51
51
  - {requirements_path} (Project requirements)
52
52
  - {state_path} (Project decisions and history)
53
53
  </files_to_read>
@@ -27,7 +27,7 @@ Parse JSON for: `state_exists`, `roadmap_exists`, `project_exists`, `planning_ex
27
27
 
28
28
  **If `state_exists` is true:** Proceed to load_state
29
29
  **If `state_exists` is false but `roadmap_exists` or `project_exists` is true:** Offer to reconstruct STATE.md
30
- **If `planning_exists` is false:** This is a new project - route to /gsd:new-project
30
+ **If `planning_exists` is false:** This is a new project - route to $gsd-new-project
31
31
  </step>
32
32
 
33
33
  <step name="load_state">
@@ -124,7 +124,7 @@ Present complete project status to user:
124
124
  Resume with: Task tool (resume parameter with agent ID)
125
125
 
126
126
  [If pending todos exist:]
127
- 📋 [N] pending todos — /gsd:check-todos to review
127
+ 📋 [N] pending todos — $gsd-check-todos to review
128
128
 
129
129
  [If blockers exist:]
130
130
  ⚠️ Carried concerns:
@@ -180,11 +180,11 @@ What would you like to do?
180
180
  [Primary action based on state - e.g.:]
181
181
  1. Resume interrupted agent [if interrupted agent found]
182
182
  OR
183
- 1. Execute phase (/gsd:execute-phase {phase})
183
+ 1. Execute phase ($gsd-execute-phase {phase})
184
184
  OR
185
- 1. Discuss Phase 3 context (/gsd:discuss-phase 3) [if CONTEXT.md missing]
185
+ 1. Discuss Phase 3 context ($gsd-discuss-phase 3) [if CONTEXT.md missing]
186
186
  OR
187
- 1. Plan Phase 3 (/gsd:plan-phase 3) [if CONTEXT.md exists or discuss option declined]
187
+ 1. Plan Phase 3 ($gsd-plan-phase 3) [if CONTEXT.md exists or discuss option declined]
188
188
 
189
189
  [Secondary options:]
190
190
  2. Review current phase status
@@ -215,7 +215,7 @@ Based on user selection, route to appropriate workflow:
215
215
 
216
216
  **{phase}-{plan}: [Plan Name]** — [objective from PLAN.md]
217
217
 
218
- `/gsd:execute-phase {phase}`
218
+ `$gsd-execute-phase {phase}`
219
219
 
220
220
  <sub>`/clear` first → fresh context window</sub>
221
221
 
@@ -229,15 +229,15 @@ Based on user selection, route to appropriate workflow:
229
229
 
230
230
  **Phase [N]: [Name]** — [Goal from ROADMAP.md]
231
231
 
232
- `/gsd:plan-phase [phase-number]`
232
+ `$gsd-plan-phase [phase-number]`
233
233
 
234
234
  <sub>`/clear` first → fresh context window</sub>
235
235
 
236
236
  ---
237
237
 
238
238
  **Also available:**
239
- - `/gsd:discuss-phase [N]` — gather context first
240
- - `/gsd:research-phase [N]` — investigate unknowns
239
+ - `$gsd-discuss-phase [N]` — gather context first
240
+ - `$gsd-research-phase [N]` — investigate unknowns
241
241
 
242
242
  ---
243
243
  ```
@@ -192,13 +192,13 @@ Display:
192
192
  | Git Branching | {None/Per Phase/Per Milestone} |
193
193
  | Saved as Defaults | {Yes/No} |
194
194
 
195
- These settings apply to future /gsd:plan-phase and /gsd:execute-phase runs.
195
+ These settings apply to future $gsd-plan-phase and $gsd-execute-phase runs.
196
196
 
197
197
  Quick commands:
198
- - /gsd:set-profile <profile> — switch model profile
199
- - /gsd:plan-phase --research — force research
200
- - /gsd:plan-phase --skip-research — skip research
201
- - /gsd:plan-phase --skip-verify — skip plan check
198
+ - $gsd-set-profile <profile> — switch model profile
199
+ - $gsd-plan-phase --research — force research
200
+ - $gsd-plan-phase --skip-research — skip research
201
+ - $gsd-plan-phase --skip-verify — skip plan check
202
202
  ```
203
203
  </step>
204
204