gsd-opencode 1.4.2 → 1.5.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 (68) hide show
  1. package/bin/install.js +1 -1
  2. package/command/gsd/add-phase.md +13 -11
  3. package/command/gsd/add-todo.md +7 -5
  4. package/command/gsd/check-todos.md +12 -10
  5. package/command/gsd/complete-milestone.md +8 -8
  6. package/command/gsd/consider-issues.md +5 -5
  7. package/command/gsd/create-roadmap.md +6 -6
  8. package/command/gsd/debug.md +2 -2
  9. package/command/gsd/discuss-milestone.md +4 -4
  10. package/command/gsd/discuss-phase.md +2 -2
  11. package/command/gsd/execute-phase.md +4 -4
  12. package/command/gsd/execute-plan.md +3 -3
  13. package/command/gsd/help.md +75 -75
  14. package/command/gsd/insert-phase.md +9 -9
  15. package/command/gsd/list-phase-assumptions.md +2 -2
  16. package/command/gsd/map-codebase.md +5 -5
  17. package/command/gsd/new-milestone.md +3 -3
  18. package/command/gsd/new-project.md +5 -5
  19. package/command/gsd/pause-work.md +3 -3
  20. package/command/gsd/plan-fix.md +6 -6
  21. package/command/gsd/plan-phase.md +5 -5
  22. package/command/gsd/progress.md +23 -23
  23. package/command/gsd/remove-phase.md +9 -7
  24. package/command/gsd/research-phase.md +2 -2
  25. package/command/gsd/resume-work.md +1 -1
  26. package/command/gsd/status.md +6 -6
  27. package/command/gsd/verify-work.md +3 -3
  28. package/get-shit-done/references/checkpoints.md +19 -19
  29. package/get-shit-done/references/continuation-format.md +17 -17
  30. package/get-shit-done/references/git-integration.md +3 -3
  31. package/get-shit-done/references/plan-format.md +23 -23
  32. package/get-shit-done/references/principles.md +5 -5
  33. package/get-shit-done/references/questioning.md +2 -2
  34. package/get-shit-done/references/research-pitfalls.md +2 -2
  35. package/get-shit-done/references/scope-estimation.md +2 -2
  36. package/get-shit-done/templates/DEBUG.md +5 -5
  37. package/get-shit-done/templates/agent-history.md +1 -1
  38. package/get-shit-done/templates/checkpoint-return.md +2 -2
  39. package/get-shit-done/templates/codebase/architecture.md +1 -1
  40. package/get-shit-done/templates/codebase/concerns.md +1 -1
  41. package/get-shit-done/templates/codebase/conventions.md +1 -1
  42. package/get-shit-done/templates/context.md +4 -4
  43. package/get-shit-done/templates/continue-here.md +1 -1
  44. package/get-shit-done/templates/discovery.md +2 -2
  45. package/get-shit-done/templates/milestone-context.md +7 -7
  46. package/get-shit-done/templates/phase-prompt.md +4 -4
  47. package/get-shit-done/templates/project.md +2 -2
  48. package/get-shit-done/templates/research.md +1 -1
  49. package/get-shit-done/templates/state.md +3 -3
  50. package/get-shit-done/templates/uat-issues.md +7 -7
  51. package/get-shit-done/workflows/_archive/execute-phase.md +13 -13
  52. package/get-shit-done/workflows/complete-milestone.md +2 -2
  53. package/get-shit-done/workflows/create-milestone.md +8 -8
  54. package/get-shit-done/workflows/create-roadmap.md +5 -5
  55. package/get-shit-done/workflows/debug.md +3 -3
  56. package/get-shit-done/workflows/discovery-phase.md +3 -3
  57. package/get-shit-done/workflows/discuss-milestone.md +7 -7
  58. package/get-shit-done/workflows/discuss-phase.md +4 -4
  59. package/get-shit-done/workflows/execute-phase.md +4 -4
  60. package/get-shit-done/workflows/execute-plan.md +16 -16
  61. package/get-shit-done/workflows/list-phase-assumptions.md +9 -9
  62. package/get-shit-done/workflows/map-codebase.md +3 -3
  63. package/get-shit-done/workflows/plan-phase.md +11 -11
  64. package/get-shit-done/workflows/research-phase.md +10 -10
  65. package/get-shit-done/workflows/resume-project.md +12 -12
  66. package/get-shit-done/workflows/transition.md +6 -6
  67. package/get-shit-done/workflows/verify-work.md +4 -4
  68. package/package.json +1 -1
@@ -6,12 +6,12 @@ Analyzes plan dependencies to identify independent plans that can run in paralle
6
6
  </purpose>
7
7
 
8
8
  <when_to_use>
9
- Use /gsd:execute-phase when:
9
+ Use /gsd-execute-phase when:
10
10
  - Phase has multiple unexecuted plans (2+)
11
11
  - Want "walk away, come back to completed work" execution
12
12
  - Plans have clear dependency boundaries
13
13
 
14
- Use /gsd:execute-plan when:
14
+ Use /gsd-execute-plan when:
15
15
  - Executing a single specific plan
16
16
  - Want sequential, interactive execution
17
17
  - Need checkpoint interactions
@@ -54,8 +54,8 @@ Options:
54
54
 
55
55
  **1. Parse phase argument:**
56
56
  ```bash
57
- # From command argument: /gsd:execute-phase 10
58
- # Or: /gsd:execute-phase .planning/phases/10-parallel-execution/
57
+ # From command argument: /gsd-execute-phase 10
58
+ # Or: /gsd-execute-phase .planning/phases/10-parallel-execution/
59
59
  PHASE_ARG="$1"
60
60
  ```
61
61
 
@@ -98,7 +98,7 @@ echo "Unexecuted: ${#UNEXECUTED[@]} plans"
98
98
  | Condition | Action |
99
99
  |-----------|--------|
100
100
  | 0 unexecuted plans | "All plans complete. Nothing to execute." |
101
- | 1 unexecuted plan | "Single plan - use /gsd:execute-plan instead" |
101
+ | 1 unexecuted plan | "Single plan - use /gsd-execute-plan instead" |
102
102
  | 2+ unexecuted plans | Proceed to dependency analysis |
103
103
 
104
104
  </step>
@@ -363,7 +363,7 @@ cat .planning/config.json 2>/dev/null
363
363
 
364
364
  **If parallelization.enabled is false:**
365
365
  - Fall back to sequential execution
366
- - Use /gsd:execute-plan for each plan in order
366
+ - Use /gsd-execute-plan for each plan in order
367
367
 
368
368
  **Checkpoint handling modes:**
369
369
  - `foreground`: Plans with checkpoints run in foreground (not parallel)
@@ -781,7 +781,7 @@ Since agents commit independently, git will catch conflicts at commit time if th
781
781
  The dependency analysis step should prevent this, but if an agent fails to commit due to conflict:
782
782
  - That agent's status will be "failed"
783
783
  - Other agents continue normally
784
- - User can resolve and retry the failed plan with /gsd:execute-plan
784
+ - User can resolve and retry the failed plan with /gsd-execute-plan
785
785
  </step>
786
786
 
787
787
  <step name="create_phase_summary">
@@ -842,15 +842,15 @@ All {N} plans finished via parallel execution.
842
842
 
843
843
  **Phase {X+1}: {Next Phase Name}** — {Goal from ROADMAP.md}
844
844
 
845
- `/gsd:plan-phase {X+1}`
845
+ `/gsd-plan-phase {X+1}`
846
846
 
847
847
  *`/clear` first → fresh context window*
848
848
 
849
849
  ---
850
850
 
851
851
  **Also available:**
852
- - `/gsd:verify-work {X}` — manual acceptance testing
853
- - `/gsd:discuss-phase {X+1}` — gather context first
852
+ - `/gsd-verify-work {X}` — manual acceptance testing
853
+ - `/gsd-discuss-phase {X+1}` — gather context first
854
854
  ```
855
855
 
856
856
  **If milestone complete:**
@@ -859,7 +859,7 @@ All {N} plans finished via parallel execution.
859
859
 
860
860
  All {N} phases finished.
861
861
 
862
- `/gsd:complete-milestone`
862
+ `/gsd-complete-milestone`
863
863
  ```
864
864
  </step>
865
865
 
@@ -869,7 +869,7 @@ All {N} phases finished.
869
869
 
870
870
  **Agent failure during parallel execution:**
871
871
  - Log failure but continue with other agents
872
- - Failed plans can be retried individually with /gsd:execute-plan
872
+ - Failed plans can be retried individually with /gsd-execute-plan
873
873
  - Do not automatically retry (may cause cascade failures)
874
874
 
875
875
  **Merge conflict detected:**
@@ -877,7 +877,7 @@ All {N} phases finished.
877
877
  - Present conflicting files to user
878
878
  - Options:
879
879
  1. Manual resolution
880
- 2. Re-run sequential with /gsd:execute-plan
880
+ 2. Re-run sequential with /gsd-execute-plan
881
881
 
882
882
  **Max concurrent limit reached:**
883
883
  - Queue excess plans
@@ -573,14 +573,14 @@ Tag: v[X.Y]
573
573
 
574
574
  **Plan Next Milestone** — define v[X.Y+1] features and scope
575
575
 
576
- `/gsd:discuss-milestone`
576
+ `/gsd-discuss-milestone`
577
577
 
578
578
  *`/clear` first → fresh context window*
579
579
 
580
580
  ---
581
581
 
582
582
  **Also available:**
583
- - `/gsd:new-milestone` — create directly if scope is clear
583
+ - `/gsd-new-milestone` — create directly if scope is clear
584
584
 
585
585
  ---
586
586
  ```
@@ -35,7 +35,7 @@ Extract:
35
35
  **Check for milestone context from discuss-milestone:**
36
36
 
37
37
  If `.planning/MILESTONE-CONTEXT.md` exists:
38
- - This contains context from `/gsd:discuss-milestone`
38
+ - This contains context from `/gsd-discuss-milestone`
39
39
  - Extract: features, suggested name, phase mapping, constraints
40
40
  - Use this to pre-populate milestone details (skip prompting for info already gathered)
41
41
 
@@ -47,7 +47,7 @@ If `.planning/MILESTONE-CONTEXT.md` exists:
47
47
  </step>
48
48
 
49
49
  <step name="get_milestone_info">
50
- **If MILESTONE-CONTEXT.md exists (from /gsd:discuss-milestone):**
50
+ **If MILESTONE-CONTEXT.md exists (from /gsd-discuss-milestone):**
51
51
  Use the features, scope, and constraints from the context file.
52
52
  Use the suggested milestone name from `<scope>` section.
53
53
  Use the phase mapping from `<phase_mapping>` section.
@@ -208,7 +208,7 @@ Write new milestone details to `.planning/ROADMAP.md`.
208
208
 
209
209
  **File to update:** `.planning/ROADMAP.md`
210
210
 
211
- The main ROADMAP.md file holds full phase details for the active milestone. Archive files in `milestones/` are created only when a milestone ships (via `/gsd:complete-milestone`).
211
+ The main ROADMAP.md file holds full phase details for the active milestone. Archive files in `milestones/` are created only when a milestone ships (via `/gsd-complete-milestone`).
212
212
 
213
213
  **Process:**
214
214
 
@@ -241,7 +241,7 @@ Write complete phase sections for all phases in this milestone. Each phase gets
241
241
  **Plans**: TBD
242
242
 
243
243
  Plans:
244
- - [ ] [N]-01: TBD (run /gsd:plan-phase [N] to break down)
244
+ - [ ] [N]-01: TBD (run /gsd-plan-phase [N] to break down)
245
245
 
246
246
  #### Phase [N+1]: [Name]
247
247
 
@@ -349,7 +349,7 @@ Delete the temporary milestone context file if it exists:
349
349
  rm -f .planning/MILESTONE-CONTEXT.md
350
350
  ```
351
351
 
352
- This file was a handoff artifact from `/gsd:discuss-milestone`. Now that the milestone is created, the context is persisted in ROADMAP.md and the temporary file is no longer needed.
352
+ This file was a handoff artifact from `/gsd-discuss-milestone`. Now that the milestone is created, the context is persisted in ROADMAP.md and the temporary file is no longer needed.
353
353
  </step>
354
354
 
355
355
  <step name="offer_next">
@@ -366,15 +366,15 @@ Milestone v[X.Y] [Name] created:
366
366
 
367
367
  **Phase [N]: [Name]** — [Goal from ROADMAP.md]
368
368
 
369
- `/gsd:plan-phase [N]`
369
+ `/gsd-plan-phase [N]`
370
370
 
371
371
  *`/clear` first → fresh context window*
372
372
 
373
373
  ---
374
374
 
375
375
  **Also available:**
376
- - `/gsd:discuss-phase [N]` — gather context first
377
- - `/gsd:research-phase [N]` — investigate unknowns
376
+ - `/gsd-discuss-phase [N]` — gather context first
377
+ - `/gsd-research-phase [N]` — investigate unknowns
378
378
  - Review roadmap
379
379
 
380
380
  ---
@@ -293,7 +293,7 @@ mkdir -p .planning/phases
293
293
  Use template from `~/.config/opencode/get-shit-done/templates/roadmap.md`.
294
294
 
295
295
  Initial roadmaps use integer phases (1, 2, 3...).
296
- Decimal phases added later via /gsd:insert-phase command (if it exists).
296
+ Decimal phases added later via /gsd-insert-phase command (if it exists).
297
297
 
298
298
  Write to `.planning/ROADMAP.md` with:
299
299
 
@@ -386,7 +386,7 @@ Resume file: None
386
386
  **Key points:**
387
387
 
388
388
  - Project Reference points to PROJECT.md for full context
389
- - Claude reads PROJECT.md directly for requirements, constraints, decisions
389
+ - Opencode agent reads PROJECT.md directly for requirements, constraints, decisions
390
390
  - This file will be read first in every future operation
391
391
  - This file will be updated after every execution
392
392
 
@@ -430,15 +430,15 @@ Project initialized:
430
430
 
431
431
  **Phase 1: [Name]** — [Goal from ROADMAP.md]
432
432
 
433
- `/gsd:plan-phase 1`
433
+ `/gsd-plan-phase 1`
434
434
 
435
435
  *`/clear` first → fresh context window*
436
436
 
437
437
  ---
438
438
 
439
439
  **Also available:**
440
- - `/gsd:discuss-phase 1` — gather context first
441
- - `/gsd:research-phase 1` — investigate unknowns
440
+ - `/gsd-discuss-phase 1` — gather context first
441
+ - `/gsd-research-phase 1` — investigate unknowns
442
442
  - Review roadmap
443
443
 
444
444
  ---
@@ -5,7 +5,7 @@ You are the debugger. The user knows what's wrong (behavior), not why (root caus
5
5
  </purpose>
6
6
 
7
7
  <philosophy>
8
- **User = reporter. Claude = investigator.**
8
+ **User = reporter. Opencode agent = investigator.**
9
9
 
10
10
  The user knows:
11
11
  - What they expected to happen
@@ -281,7 +281,7 @@ If ELIMINATED:
281
281
 
282
282
  After significant investigation (5+ evidence entries), check if context is heavy.
283
283
  If so, ensure Current Focus is fully updated and suggest:
284
- "Context filling up. Safe to /clear - run /gsd:debug to resume."
284
+ "Context filling up. Safe to /clear - run /gsd-debug to resume."
285
285
  </step>
286
286
 
287
287
  <step name="resume_from_file">
@@ -391,7 +391,7 @@ Use question:
391
391
  - header: "Next"
392
392
  - question: "What now?"
393
393
  - options:
394
- - "Continue working" - Back to /gsd:progress
394
+ - "Continue working" - Back to /gsd-progress
395
395
  - "Test more" - Verify related functionality
396
396
  - "Done" - End session
397
397
  </step>
@@ -4,7 +4,7 @@ Produces DISCOVERY.md (for Level 2-3) that informs PLAN.md creation.
4
4
 
5
5
  Called from plan-phase.md's mandatory_discovery step with a depth parameter.
6
6
 
7
- NOTE: For comprehensive ecosystem research ("how do experts build this"), use /gsd:research-phase instead, which produces RESEARCH.md.
7
+ NOTE: For comprehensive ecosystem research ("how do experts build this"), use /gsd-research-phase instead, which produces RESEARCH.md.
8
8
  </purpose>
9
9
 
10
10
  <depth_levels>
@@ -256,8 +256,8 @@ Confidence: [level]
256
256
 
257
257
  What's next?
258
258
 
259
- 1. Discuss phase context (/gsd:discuss-phase [current-phase])
260
- 2. Create phase plan (/gsd:plan-phase [current-phase])
259
+ 1. Discuss phase context (/gsd-discuss-phase [current-phase])
260
+ 2. Create phase plan (/gsd-plan-phase [current-phase])
261
261
  3. Refine discovery (dig deeper)
262
262
  4. Review discovery
263
263
 
@@ -24,8 +24,8 @@ Current milestone in progress: v[X.Y] [Name]
24
24
  Phases [N]-[M], [P]% complete
25
25
 
26
26
  Did you want to:
27
- 1. Complete current milestone first (/gsd:complete-milestone)
28
- 2. Add phases to current milestone (/gsd:add-phase)
27
+ 1. Complete current milestone first (/gsd-complete-milestone)
28
+ 2. Add phases to current milestone (/gsd-add-phase)
29
29
  3. Continue anyway - discuss next milestone scope
30
30
 
31
31
  ```
@@ -113,7 +113,7 @@ Use question:
113
113
  - header: "Ready?"
114
114
  - question: "Ready to create the milestone, or explore more?"
115
115
  - options (ALL THREE REQUIRED):
116
- - "Create milestone" - Proceed to /gsd:new-milestone
116
+ - "Create milestone" - Proceed to /gsd-new-milestone
117
117
  - "Ask more questions" - Help me think through this more
118
118
  - "Let me add context" - I have more to share
119
119
 
@@ -142,7 +142,7 @@ cat > .planning/MILESTONE-CONTEXT.md << 'EOF'
142
142
  # Milestone Context
143
143
 
144
144
  **Generated:** [today's date]
145
- **Status:** Ready for /gsd:new-milestone
145
+ **Status:** Ready for /gsd-new-milestone
146
146
 
147
147
  <features>
148
148
  ## Features to Build
@@ -187,7 +187,7 @@ cat > .planning/MILESTONE-CONTEXT.md << 'EOF'
187
187
 
188
188
  ---
189
189
 
190
- *This file is temporary. It will be deleted after /gsd:new-milestone creates the milestone.*
190
+ *This file is temporary. It will be deleted after /gsd-new-milestone creates the milestone.*
191
191
  EOF
192
192
  ```
193
193
  </step>
@@ -214,7 +214,7 @@ Context saved to `.planning/MILESTONE-CONTEXT.md`
214
214
 
215
215
  **Create Milestone v[X.Y]** — [Theme Name]
216
216
 
217
- `/gsd:new-milestone`
217
+ `/gsd-new-milestone`
218
218
 
219
219
  *`/clear` first → fresh context window*
220
220
 
@@ -232,5 +232,5 @@ Context saved to `.planning/MILESTONE-CONTEXT.md`
232
232
  - Features explored with clarifying questions
233
233
  - Scope synthesized from features (not asked abstractly)
234
234
  - **MILESTONE-CONTEXT.md created** with features, scope, and phase mapping
235
- - Context handed off to /gsd:new-milestone
235
+ - Context handed off to /gsd-new-milestone
236
236
  </success_criteria>
@@ -5,7 +5,7 @@ You are a thinking partner, not an interviewer. The user is the visionary — yo
5
5
  </purpose>
6
6
 
7
7
  <philosophy>
8
- **User = founder/visionary. Claude = builder.**
8
+ **User = founder/visionary. Opencode agent = builder.**
9
9
 
10
10
  The user doesn't know (and shouldn't need to know):
11
11
  - Codebase patterns (you read the code)
@@ -42,7 +42,7 @@ fi
42
42
  ```
43
43
  Error: Phase ${PHASE} not found in roadmap.
44
44
 
45
- Use /gsd:progress to see available phases.
45
+ Use /gsd-progress to see available phases.
46
46
  ```
47
47
 
48
48
  Exit workflow.
@@ -190,14 +190,14 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-CONTEXT.md
190
190
 
191
191
  **Phase ${PHASE}: [Name]** — [Goal from ROADMAP.md]
192
192
 
193
- `/gsd:plan-phase ${PHASE}`
193
+ `/gsd-plan-phase ${PHASE}`
194
194
 
195
195
  *`/clear` first → fresh context window*
196
196
 
197
197
  ---
198
198
 
199
199
  **Also available:**
200
- - `/gsd:research-phase ${PHASE}` — investigate unknowns
200
+ - `/gsd-research-phase ${PHASE}` — investigate unknowns
201
201
  - Review/edit CONTEXT.md before continuing
202
202
 
203
203
  ---
@@ -102,7 +102,7 @@ waves = {
102
102
  }
103
103
  ```
104
104
 
105
- **No dependency analysis needed.** Wave numbers are pre-computed during `/gsd:plan-phase`.
105
+ **No dependency analysis needed.** Wave numbers are pre-computed during `/gsd-plan-phase`.
106
106
 
107
107
  Report wave structure to user:
108
108
  ```
@@ -314,7 +314,7 @@ Present next steps based on milestone status:
314
314
 
315
315
  **Phase {X+1}: {Name}** — {Goal}
316
316
 
317
- `/gsd:plan-phase {X+1}`
317
+ `/gsd-plan-phase {X+1}`
318
318
 
319
319
  *`/clear` first for fresh context*
320
320
  ```
@@ -325,7 +325,7 @@ MILESTONE COMPLETE!
325
325
 
326
326
  All {N} phases executed.
327
327
 
328
- `/gsd:complete-milestone`
328
+ `/gsd-complete-milestone`
329
329
  ```
330
330
  </step>
331
331
 
@@ -380,7 +380,7 @@ Each subagent: Fresh 200k context
380
380
 
381
381
  If phase execution was interrupted (context limit, user exit, error):
382
382
 
383
- 1. Run `/gsd:execute-phase {phase}` again
383
+ 1. Run `/gsd-execute-phase {phase}` again
384
384
  2. discover_plans finds completed SUMMARYs
385
385
  3. Skips completed plans
386
386
  4. Resumes from first incomplete plan
@@ -1069,7 +1069,7 @@ TASK_COMMITS+=("Task ${TASK_NUM}: ${TASK_COMMIT}")
1069
1069
  - Each task independently revertable
1070
1070
  - Git bisect finds exact failing task
1071
1071
  - Git blame traces line to specific task context
1072
- - Clear history for Claude in future sessions
1072
+ - Clear history for Opencode agent in future sessions
1073
1073
  - Better observability for AI-automated workflow
1074
1074
 
1075
1075
  </task_commit>
@@ -1077,7 +1077,7 @@ TASK_COMMITS+=("Task ${TASK_NUM}: ${TASK_COMMIT}")
1077
1077
  <step name="checkpoint_protocol">
1078
1078
  When encountering `type="checkpoint:*"`:
1079
1079
 
1080
- **Critical: Claude automates everything with CLI/API before checkpoints.** Checkpoints are for verification and decisions, not manual work.
1080
+ **Critical: Opencode agent automates everything with CLI/API before checkpoints.** Checkpoints are for verification and decisions, not manual work.
1081
1081
 
1082
1082
  **Display checkpoint clearly:**
1083
1083
 
@@ -1129,7 +1129,7 @@ Options:
1129
1129
  **For checkpoint:human-action (1% - rare, only for truly unavoidable manual steps):**
1130
1130
 
1131
1131
  ```
1132
- I automated: [what Claude already did via CLI/API]
1132
+ I automated: [what Opencode agent already did via CLI/API]
1133
1133
 
1134
1134
  Need your help with: [the ONE thing with no CLI/API - email link, 2FA code]
1135
1135
 
@@ -1224,7 +1224,7 @@ You will NOT be resumed. A new agent continues from where you stopped, using you
1224
1224
 
1225
1225
  **How to know if you were spawned:**
1226
1226
 
1227
- If you're reading this workflow because an orchestrator spawned you (vs running directly from /gsd:execute-plan), the orchestrator's prompt will include checkpoint return instructions. Follow those instructions when you hit a checkpoint.
1227
+ If you're reading this workflow because an orchestrator spawned you (vs running directly from /gsd-execute-plan), the orchestrator's prompt will include checkpoint return instructions. Follow those instructions when you hit a checkpoint.
1228
1228
 
1229
1229
  **If running in main context (not spawned):**
1230
1230
 
@@ -1609,18 +1609,18 @@ Use question:
1609
1609
  - header: "Phase Issues"
1610
1610
  - question: "[N] issues were logged during this phase. Review now?"
1611
1611
  - options:
1612
- - "Review issues" - Analyze with /gsd:consider-issues
1612
+ - "Review issues" - Analyze with /gsd-consider-issues
1613
1613
  - "Continue" - Address later, proceed to next work
1614
1614
 
1615
1615
  **If "Review issues" selected:**
1616
- - Invoke: `[removed - use /command syntax]("/gsd:consider-issues")`
1616
+ - Invoke: `[removed - use /command syntax]("/gsd-consider-issues")`
1617
1617
  - After consider-issues completes, return to offer_next
1618
1618
 
1619
1619
  **If "Continue" selected or no issues found:**
1620
1620
  - Proceed to offer_next step
1621
1621
 
1622
1622
  **In YOLO mode:**
1623
- - Note issues were logged but don't prompt: `📋 [N] issues logged this phase (review later with /gsd:consider-issues)`
1623
+ - Note issues were logged but don't prompt: `📋 [N] issues logged this phase (review later with /gsd-consider-issues)`
1624
1624
  - Continue to offer_next automatically
1625
1625
  </step>
1626
1626
 
@@ -1683,14 +1683,14 @@ Summary: .planning/phases/{phase-dir}/{phase}-{plan}-SUMMARY.md
1683
1683
 
1684
1684
  **{phase}-{next-plan}: [Plan Name]** — [objective from next PLAN.md]
1685
1685
 
1686
- `/gsd:execute-plan .planning/phases/{phase-dir}/{phase}-{next-plan}-PLAN.md`
1686
+ `/gsd-execute-plan .planning/phases/{phase-dir}/{phase}-{next-plan}-PLAN.md`
1687
1687
 
1688
1688
  *`/clear` first → fresh context window*
1689
1689
 
1690
1690
  ---
1691
1691
 
1692
1692
  **Also available:**
1693
- - `/gsd:verify-work {phase}-{plan}` — manual acceptance testing before continuing
1693
+ - `/gsd-verify-work {phase}-{plan}` — manual acceptance testing before continuing
1694
1694
  - Review what was built before continuing
1695
1695
 
1696
1696
  ---
@@ -1744,16 +1744,16 @@ All {Y} plans finished.
1744
1744
 
1745
1745
  **Phase {Z+1}: {Next Phase Name}** — {Goal from ROADMAP.md}
1746
1746
 
1747
- `/gsd:plan-phase {Z+1}`
1747
+ `/gsd-plan-phase {Z+1}`
1748
1748
 
1749
1749
  *`/clear` first → fresh context window*
1750
1750
 
1751
1751
  ---
1752
1752
 
1753
1753
  **Also available:**
1754
- - `/gsd:verify-work {Z}` — manual acceptance testing before continuing
1755
- - `/gsd:discuss-phase {Z+1}` — gather context first
1756
- - `/gsd:research-phase {Z+1}` — investigate unknowns
1754
+ - `/gsd-verify-work {Z}` — manual acceptance testing before continuing
1755
+ - `/gsd-discuss-phase {Z+1}` — gather context first
1756
+ - `/gsd-research-phase {Z+1}` — investigate unknowns
1757
1757
  - Review phase accomplishments before continuing
1758
1758
 
1759
1759
  ---
@@ -1784,15 +1784,15 @@ Milestone is 100% done.
1784
1784
 
1785
1785
  **Complete Milestone** — archive and prepare for next
1786
1786
 
1787
- `/gsd:complete-milestone`
1787
+ `/gsd-complete-milestone`
1788
1788
 
1789
1789
  *`/clear` first → fresh context window*
1790
1790
 
1791
1791
  ---
1792
1792
 
1793
1793
  **Also available:**
1794
- - `/gsd:verify-work` — manual acceptance testing before completing milestone
1795
- - `/gsd:add-phase <description>` — add another phase before completing
1794
+ - `/gsd-verify-work` — manual acceptance testing before completing milestone
1795
+ - `/gsd-add-phase <description>` — add another phase before completing
1796
1796
  - Review accomplishments before archiving
1797
1797
 
1798
1798
  ---
@@ -1,7 +1,7 @@
1
1
  <purpose>
2
2
  Surface Claude's assumptions about a phase before planning, enabling users to correct misconceptions early.
3
3
 
4
- Key difference from discuss-phase: This is ANALYSIS of what Claude thinks, not INTAKE of what user knows. No file output - purely conversational to prompt discussion.
4
+ Key difference from discuss-phase: This is ANALYSIS of what Opencode agent thinks, not INTAKE of what user knows. No file output - purely conversational to prompt discussion.
5
5
  </purpose>
6
6
 
7
7
  <process>
@@ -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.
@@ -53,13 +53,13 @@ Continue to analyze_phase.
53
53
  Based on roadmap description and project context, identify assumptions across five areas:
54
54
 
55
55
  **1. Technical Approach:**
56
- What libraries, frameworks, patterns, or tools would Claude use?
56
+ What libraries, frameworks, patterns, or tools would Opencode agent use?
57
57
  - "I'd use X library because..."
58
58
  - "I'd follow Y pattern because..."
59
59
  - "I'd structure this as Z because..."
60
60
 
61
61
  **2. Implementation Order:**
62
- What would Claude build first, second, third?
62
+ What would Opencode agent build first, second, third?
63
63
  - "I'd start with X because it's foundational"
64
64
  - "Then Y because it depends on X"
65
65
  - "Finally Z because..."
@@ -71,13 +71,13 @@ What's included vs excluded in Claude's interpretation?
71
71
  - "Boundary ambiguities: G could go either way"
72
72
 
73
73
  **4. Risk Areas:**
74
- Where does Claude expect complexity or challenges?
74
+ Where does Opencode agent expect complexity or challenges?
75
75
  - "The tricky part is X because..."
76
76
  - "Potential issues: Y, Z"
77
77
  - "I'd watch out for..."
78
78
 
79
79
  **5. Dependencies:**
80
- What does Claude assume exists or needs to be in place?
80
+ What does Opencode agent assume exists or needs to be in place?
81
81
  - "This assumes X from previous phases"
82
82
  - "External dependencies: Y, Z"
83
83
  - "This will be consumed by..."
@@ -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
  ```
@@ -15,7 +15,7 @@ Each agent has fresh context and focuses on specific aspects. Output is concise
15
15
  Include enough detail to be useful as reference. Prioritize practical examples (especially code patterns) over arbitrary brevity. A 200-line TESTING.md with real patterns is more valuable than a 74-line summary.
16
16
 
17
17
  **Always include file paths:**
18
- Documents are reference material for Claude when planning/executing. Vague descriptions like "UserService handles users" are not actionable. Always include actual file paths formatted with backticks: `src/services/user.ts`. This allows Claude to navigate directly to relevant code without re-searching. Do NOT include line numbers (they go stale), just file paths.
18
+ Documents are reference material for Opencode agent when planning/executing. Vague descriptions like "UserService handles users" are not actionable. Always include actual file paths formatted with backticks: `src/services/user.ts`. This allows Opencode agent to navigate directly to relevant code without re-searching. Do NOT include line numbers (they go stale), just file paths.
19
19
  </philosophy>
20
20
 
21
21
  <process>
@@ -403,14 +403,14 @@ Created .planning/codebase/:
403
403
 
404
404
  **Initialize project** — use codebase context for planning
405
405
 
406
- `/gsd:new-project`
406
+ `/gsd-new-project`
407
407
 
408
408
  *`/clear` first → fresh context window*
409
409
 
410
410
  ---
411
411
 
412
412
  **Also available:**
413
- - Re-run mapping: `/gsd:map-codebase`
413
+ - Re-run mapping: `/gsd-map-codebase`
414
414
  - Review specific file: `cat .planning/codebase/STACK.md`
415
415
  - Edit any document before proceeding
416
416
 
@@ -32,7 +32,7 @@ Decimal phases enable urgent work insertion without renumbering:
32
32
  <purpose>
33
33
  Create executable phase prompts (PLAN.md files) optimized for parallel execution.
34
34
 
35
- PLAN.md IS the prompt that Claude executes. Plans are grouped into execution waves based on dependencies - independent plans run in parallel, dependent plans wait for predecessors.
35
+ PLAN.md IS the prompt that Opencode agent executes. Plans are grouped into execution waves based on dependencies - independent plans run in parallel, dependent plans wait for predecessors.
36
36
  </purpose>
37
37
 
38
38
  <planning_principles>
@@ -136,7 +136,7 @@ Read any existing PLAN.md or DISCOVERY.md in the phase directory.
136
136
 
137
137
  If roadmap flagged `Research: Likely`, Level 0 (skip) is not available.
138
138
 
139
- For niche domains (3D, games, audio, shaders, ML), suggest `/gsd:research-phase` before plan-phase.
139
+ For niche domains (3D, games, audio, shaders, ML), suggest `/gsd-research-phase` before plan-phase.
140
140
  </step>
141
141
 
142
142
  <step name="read_project_history">
@@ -217,19 +217,19 @@ Understand:
217
217
  - Phase goal (from roadmap)
218
218
  - What exists already (scan codebase if mid-project)
219
219
  - Dependencies met (previous phases complete?)
220
- - Any {phase}-RESEARCH.md (from /gsd:research-phase)
220
+ - Any {phase}-RESEARCH.md (from /gsd-research-phase)
221
221
  - Any DISCOVERY.md (from mandatory discovery)
222
- - Any {phase}-CONTEXT.md (from /gsd:discuss-phase)
222
+ - Any {phase}-CONTEXT.md (from /gsd-discuss-phase)
223
223
 
224
224
  ```bash
225
225
  # If mid-project, understand current state
226
226
  ls -la src/ 2>/dev/null
227
227
  cat package.json 2>/dev/null | head -20
228
228
 
229
- # Check for ecosystem research (from /gsd:research-phase)
229
+ # Check for ecosystem research (from /gsd-research-phase)
230
230
  cat .planning/phases/XX-name/${PHASE}-RESEARCH.md 2>/dev/null
231
231
 
232
- # Check for phase context (from /gsd:discuss-phase)
232
+ # Check for phase context (from /gsd-discuss-phase)
233
233
  cat .planning/phases/XX-name/${PHASE}-CONTEXT.md 2>/dev/null
234
234
  ```
235
235
 
@@ -237,7 +237,7 @@ cat .planning/phases/XX-name/${PHASE}-CONTEXT.md 2>/dev/null
237
237
 
238
238
  **If CONTEXT.md exists:** Honor vision, prioritize essential, respect boundaries, incorporate specifics.
239
239
 
240
- **If neither exist:** Suggest /gsd:research-phase for niche domains, /gsd:discuss-phase for simpler domains, or proceed with roadmap only.
240
+ **If neither exist:** Suggest /gsd-research-phase for niche domains, /gsd-discuss-phase for simpler domains, or proceed with roadmap only.
241
241
  </step>
242
242
 
243
243
  <step name="break_into_tasks">
@@ -560,7 +560,7 @@ domain: [optional]
560
560
  ---
561
561
  ```
562
562
 
563
- **Wave is pre-computed:** Wave numbers are assigned during planning (see `assign_waves` step). `/gsd:execute-phase` reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
563
+ **Wave is pre-computed:** Wave numbers are assigned during planning (see `assign_waves` step). `/gsd-execute-phase` reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
564
564
 
565
565
  **Context section - parallel-aware:**
566
566
 
@@ -638,12 +638,12 @@ Wave 2: {plan-03}
638
638
  [If 1 plan created:]
639
639
  **{phase}-01: [Plan Name]** - [objective summary]
640
640
 
641
- `/gsd:execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md`
641
+ `/gsd-execute-plan .planning/phases/XX-name/{phase}-01-PLAN.md`
642
642
 
643
643
  [If 2+ plans created:]
644
644
  **Phase {X}: [Phase Name]** - {N} plans in {M} waves
645
645
 
646
- `/gsd:execute-phase {X}`
646
+ `/gsd-execute-phase {X}`
647
647
 
648
648
  *`/clear` first - fresh context window*
649
649
 
@@ -651,7 +651,7 @@ Wave 2: {plan-03}
651
651
 
652
652
  **Also available:**
653
653
  - Review/adjust plans before executing
654
- [If 2+ plans: - `/gsd:execute-plan {phase}-01-PLAN.md` - run plans one at a time]
654
+ [If 2+ plans: - `/gsd-execute-plan {phase}-01-PLAN.md` - run plans one at a time]
655
655
  [If 2+ plans: - View all plans: `ls .planning/phases/XX-name/*-PLAN.md`]
656
656
 
657
657
  ---