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
@@ -1,13 +1,13 @@
1
1
  <overview>
2
- Claude-executable plans have a specific format that enables Claude to implement without interpretation. This reference defines what makes a plan executable vs. vague.
2
+ Claude-executable plans have a specific format that enables Opencode agent to implement without interpretation. This reference defines what makes a plan executable vs. vague.
3
3
 
4
- **Key insight:** PLAN.md IS the executable prompt. It contains everything Claude needs to execute the phase, including objective, context references, tasks, verification, success criteria, and output specification.
4
+ **Key insight:** PLAN.md IS the executable prompt. It contains everything Opencode agent needs to execute the phase, including objective, context references, tasks, verification, success criteria, and output specification.
5
5
  </overview>
6
6
 
7
7
  <core_principle>
8
- A plan is Claude-executable when Claude can read the PLAN.md and immediately start implementing without asking clarifying questions.
8
+ A plan is Claude-executable when Opencode agent can read the PLAN.md and immediately start implementing without asking clarifying questions.
9
9
 
10
- If Claude has to guess, interpret, or make assumptions - the task is too vague.
10
+ If Opencode agent has to guess, interpret, or make assumptions - the task is too vague.
11
11
  </core_principle>
12
12
 
13
13
  <frontmatter>
@@ -37,7 +37,7 @@ domain: [optional] # Domain skill if loaded
37
37
  | `autonomous` | Yes | `true` if no checkpoints, `false` if has checkpoints |
38
38
  | `domain` | No | Domain skill if loaded (e.g., `next-js`) |
39
39
 
40
- **Wave is pre-computed:** `/gsd:plan-phase` assigns wave numbers based on `depends_on`. `/gsd:execute-phase` reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
40
+ **Wave is pre-computed:** `/gsd-plan-phase` assigns wave numbers based on `depends_on`. `/gsd-execute-phase` reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
41
41
 
42
42
  **Checkpoint handling:** Plans with `autonomous: false` require user interaction. They run in their assigned wave but pause at checkpoints.
43
43
  </frontmatter>
@@ -88,7 +88,7 @@ Output: [...]
88
88
  </task>
89
89
 
90
90
  <task type="checkpoint:human-verify" gate="blocking">
91
- <what-built>[what Claude automated]</what-built>
91
+ <what-built>[what Opencode agent automated]</what-built>
92
92
  <how-to-verify>[numbered verification steps]</how-to-verify>
93
93
  <resume-signal>[how to continue - "approved" or describe issues]</resume-signal>
94
94
  </task>
@@ -170,7 +170,7 @@ Should be testable without subjective judgment.
170
170
  Tasks have a `type` attribute that determines how they execute:
171
171
 
172
172
  <type name="auto">
173
- **Default task type** - Claude executes autonomously.
173
+ **Default task type** - Opencode agent executes autonomously.
174
174
 
175
175
  **Structure:**
176
176
 
@@ -184,11 +184,11 @@ Tasks have a `type` attribute that determines how they execute:
184
184
  </task>
185
185
  ```
186
186
 
187
- Use for: Everything Claude can do independently (code, tests, builds, file operations).
187
+ Use for: Everything Opencode agent can do independently (code, tests, builds, file operations).
188
188
  </type>
189
189
 
190
190
  <type name="checkpoint:human-action">
191
- **RARELY USED** - Only for actions with NO CLI/API. Claude automates everything possible first.
191
+ **RARELY USED** - Only for actions with NO CLI/API. Opencode agent automates everything possible first.
192
192
 
193
193
  **Structure:**
194
194
 
@@ -196,10 +196,10 @@ Use for: Everything Claude can do independently (code, tests, builds, file opera
196
196
  <task type="checkpoint:human-action" gate="blocking">
197
197
  <action>[Unavoidable manual step - email link, 2FA code]</action>
198
198
  <instructions>
199
- [What Claude already automated]
199
+ [What Opencode agent already automated]
200
200
  [The ONE thing requiring human action]
201
201
  </instructions>
202
- <verification>[What Claude can check afterward]</verification>
202
+ <verification>[What Opencode agent can check afterward]</verification>
203
203
  <resume-signal>[How to continue]</resume-signal>
204
204
  </task>
205
205
  ```
@@ -208,7 +208,7 @@ Use ONLY for: Email verification links, SMS 2FA codes, manual approvals with no
208
208
 
209
209
  Do NOT use for: Anything with a CLI (Vercel, Stripe, Upstash, Railway, GitHub), builds, tests, file creation, deployments.
210
210
 
211
- **Execution:** Claude automates everything with CLI/API, stops only for truly unavoidable manual steps.
211
+ **Execution:** Opencode agent automates everything with CLI/API, stops only for truly unavoidable manual steps.
212
212
  </type>
213
213
 
214
214
  <type name="checkpoint:human-verify">
@@ -233,7 +233,7 @@ Do NOT use for: Anything with a CLI (Vercel, Stripe, Upstash, Railway, GitHub),
233
233
 
234
234
  Use for: UI/UX verification, visual design checks, animation smoothness, accessibility testing.
235
235
 
236
- **Execution:** Claude builds the feature, stops, provides testing instructions, waits for approval/feedback.
236
+ **Execution:** Opencode agent builds the feature, stops, provides testing instructions, waits for approval/feedback.
237
237
  </type>
238
238
 
239
239
  <type name="checkpoint:decision">
@@ -268,23 +268,23 @@ Use for: UI/UX verification, visual design checks, animation smoothness, accessi
268
268
 
269
269
  Use for: Technology selection, architecture decisions, design choices, feature prioritization.
270
270
 
271
- **Execution:** Claude presents options with balanced pros/cons, waits for decision, proceeds with chosen direction.
271
+ **Execution:** Opencode agent presents options with balanced pros/cons, waits for decision, proceeds with chosen direction.
272
272
  </type>
273
273
 
274
274
  **When to use checkpoints:**
275
275
 
276
- - Visual/UX verification (after Claude builds) → `checkpoint:human-verify`
276
+ - Visual/UX verification (after Opencode agent builds) → `checkpoint:human-verify`
277
277
  - Implementation direction choice → `checkpoint:decision`
278
278
  - Truly unavoidable manual actions (email links, 2FA) → `checkpoint:human-action` (rare)
279
279
 
280
280
  **When NOT to use checkpoints:**
281
281
 
282
- - Anything with CLI/API (Claude automates it) → `type="auto"`
282
+ - Anything with CLI/API (Opencode agent automates it) → `type="auto"`
283
283
  - Deployments (Vercel, Railway, Fly) → `type="auto"` with CLI
284
284
  - Creating resources (Upstash, Stripe, GitHub) → `type="auto"` with CLI/API
285
285
  - File operations, tests, builds → `type="auto"`
286
286
 
287
- **Golden rule:** If Claude CAN automate it, Claude MUST automate it.
287
+ **Golden rule:** If Opencode agent CAN automate it, Opencode agent MUST automate it.
288
288
 
289
289
  **Checkpoint impact on parallelization:**
290
290
  - Plans with checkpoints set `autonomous: false` in frontmatter
@@ -341,7 +341,7 @@ Use @file references to load context for the prompt:
341
341
  </context>
342
342
  ```
343
343
 
344
- Reference files that Claude needs to understand before implementing.
344
+ Reference files that Opencode agent needs to understand before implementing.
345
345
 
346
346
  **Anti-pattern:** Reflexive chaining (02 refs 01, 03 refs 02). Only reference what you actually need.
347
347
  </context_references>
@@ -416,7 +416,7 @@ Claude: "How? What type? What library? Where?"
416
416
  </task>
417
417
  ```
418
418
 
419
- Claude can implement this immediately.
419
+ Opencode agent can implement this immediately.
420
420
  </just_right>
421
421
 
422
422
  <note_on_tdd>
@@ -426,7 +426,7 @@ If email validation warrants TDD, create a TDD plan for it. See `./tdd.md` for T
426
426
  </note_on_tdd>
427
427
 
428
428
  <too_detailed>
429
- Writing the actual code in the plan. Trust Claude to implement from clear instructions.
429
+ Writing the actual code in the plan. Trust Opencode agent to implement from clear instructions.
430
430
  </too_detailed>
431
431
  </specificity_levels>
432
432
 
@@ -438,7 +438,7 @@ Writing the actual code in the plan. Trust Claude to implement from clear instru
438
438
  - "Make it production-ready"
439
439
  - "Add proper error handling"
440
440
 
441
- These require Claude to decide WHAT to do. Specify it.
441
+ These require Opencode agent to decide WHAT to do. Specify it.
442
442
  </vague_actions>
443
443
 
444
444
  <unverifiable_completion>
@@ -457,12 +457,12 @@ These require subjective judgment. Make it objective.
457
457
  - "Follow best practices"
458
458
  - "Like the other endpoints"
459
459
 
460
- Claude doesn't know your standards. Be explicit.
460
+ Opencode agent doesn't know your standards. Be explicit.
461
461
  </missing_context>
462
462
  </anti_patterns>
463
463
 
464
464
  <sizing_tasks>
465
- Good task size: 15-60 minutes of Claude work.
465
+ Good task size: 15-60 minutes of Opencode agent work.
466
466
 
467
467
  **Too small**: "Add import statement for bcrypt" (combine with related task)
468
468
  **Just right**: "Create login endpoint with JWT validation" (focused, specific)
@@ -6,8 +6,8 @@ Core principles for the Gets Shit Done planning system.
6
6
  You are planning for ONE person (the user) and ONE implementer (Claude).
7
7
  - No teams, stakeholders, ceremonies, coordination overhead
8
8
  - User is the visionary/product owner
9
- - Claude is the builder
10
- - Estimate effort in Claude execution time, not human dev time
9
+ - Opencode agent is the builder
10
+ - Estimate effort in Opencode agent execution time, not human dev time
11
11
  </solo_developer_claude>
12
12
 
13
13
  <plans_are_prompts>
@@ -49,7 +49,7 @@ Plans must complete within reasonable context usage.
49
49
 
50
50
  <claude_automates>
51
51
 
52
- If Claude CAN do it via CLI/API/tool, Claude MUST do it.
52
+ If Opencode agent CAN do it via CLI/API/tool, Opencode agent MUST do it.
53
53
 
54
54
  Checkpoints are for:
55
55
  - **Verification** - Human confirms Claude's work (visual, UX)
@@ -129,7 +129,7 @@ Each task gets its own commit immediately after completion:
129
129
  - One final metadata commit per plan: `docs({phase}-{plan}): complete [plan-name]`
130
130
 
131
131
  **Why per-task commits:**
132
- - Git history becomes primary context source for future Claude sessions
132
+ - Git history becomes primary context source for future Opencode agent sessions
133
133
  - `git bisect` finds exact failing task, not just failing plan
134
134
  - Each task independently revertable
135
135
  - Better failure recovery (task 1 committed ✅, retry task 2)
@@ -148,7 +148,7 @@ NEVER include:
148
148
  - Team structures, RACI matrices
149
149
  - Stakeholder management
150
150
  - Sprint ceremonies
151
- - Human dev time estimates (hours, days, weeks—Claude works differently)
151
+ - Human dev time estimates (hours, days, weeks—Opencode agent works differently)
152
152
  - Change management processes
153
153
  - Documentation for documentation's sake
154
154
 
@@ -85,7 +85,7 @@ Use question:
85
85
  **BAD — Corporate speak:**
86
86
  - "What are your success criteria?"
87
87
  - "What's your budget?"
88
- - "Have you done X before?" (irrelevant — Claude builds)
88
+ - "Have you done X before?" (irrelevant — Opencode agent builds)
89
89
 
90
90
  **GOOD — Concrete options that help them think:**
91
91
  - header: "Done"
@@ -155,7 +155,7 @@ Loop until "Create PROJECT.md" selected.
155
155
  - **Corporate speak** - "What are your success criteria?" "Who are your stakeholders?"
156
156
  - **Rushing** - Minimizing questions to get to "the work"
157
157
  - **Assuming** - Filling gaps with assumptions instead of asking
158
- - **User skills** - NEVER ask about user's technical experience. Claude builds — user's skills are irrelevant.
158
+ - **User skills** - NEVER ask about user's technical experience. Opencode agent builds — user's skills are irrelevant.
159
159
  - **Premature constraints** - Asking about tech stack before understanding the idea
160
160
  - **Shallow acceptance** - Taking vague answers without probing for specifics
161
161
  </anti_patterns>
@@ -58,13 +58,13 @@ Search queries (use WebSearch):
58
58
 
59
59
  <pitfall_tool_variations>
60
60
  **What**: Conflating capabilities across different tools/environments
61
- **Example**: "Claude Desktop supports X" ≠ "OpenCode supports X"
61
+ **Example**: "OpenCode or Desktop supports X" ≠ "OpenCode supports X"
62
62
  **Why it happens**: Not explicitly checking each environment separately
63
63
  **Prevention**:
64
64
  ```xml
65
65
  <verification_checklist>
66
- □ Claude Desktop capabilities
67
66
  □ OpenCode capabilities
67
+ □ OpenCode or Desktop capabilities
68
68
  □ VS Code extension capabilities
69
69
  □ API/SDK capabilities
70
70
  Document which environment supports which features
@@ -2,7 +2,7 @@
2
2
  Plans must maintain consistent quality from first task to last. This requires understanding quality degradation and splitting aggressively.
3
3
 
4
4
  <quality_insight>
5
- Claude degrades when it *perceives* context pressure and enters "completion mode."
5
+ Opencode agent degrades when it *perceives* context pressure and enters "completion mode."
6
6
 
7
7
  | Context Usage | Quality | Claude's State |
8
8
  |---------------|---------|----------------|
@@ -11,7 +11,7 @@ Claude degrades when it *perceives* context pressure and enters "completion mode
11
11
  | 50-70% | DEGRADING | Efficiency mode begins |
12
12
  | 70%+ | POOR | Rushed, minimal |
13
13
 
14
- **The 40-50% inflection point:** Claude sees context mounting and thinks "I'd better conserve now." Result: "I'll complete the remaining tasks more concisely" = quality crash.
14
+ **The 40-50% inflection point:** Opencode agent sees context mounting and thinks "I'd better conserve now." Result: "I'll complete the remaining tasks more concisely" = quality crash.
15
15
 
16
16
  **The rule:** Stop BEFORE quality degrades, not at context limit.
17
17
  </quality_insight>
@@ -67,8 +67,8 @@ files_changed: []
67
67
 
68
68
  **Current Focus:**
69
69
  - OVERWRITE entirely on each update
70
- - Always reflects what Claude is doing RIGHT NOW
71
- - If Claude reads this after /clear, it knows exactly where to resume
70
+ - Always reflects what Opencode agent is doing RIGHT NOW
71
+ - If Opencode agent reads this after /clear, it knows exactly where to resume
72
72
  - Fields: hypothesis, test, expecting, next_action
73
73
 
74
74
  **Symptoms:**
@@ -99,7 +99,7 @@ files_changed: []
99
99
 
100
100
  <lifecycle>
101
101
 
102
- **Creation:** Immediately when /gsd:debug is called
102
+ **Creation:** Immediately when /gsd-debug is called
103
103
  - Create file with trigger from user input
104
104
  - Set status to "gathering"
105
105
  - Current Focus: next_action = "gather symptoms"
@@ -135,7 +135,7 @@ files_changed: []
135
135
 
136
136
  <resume_behavior>
137
137
 
138
- When Claude reads this file after /clear:
138
+ When Opencode agent reads this file after /clear:
139
139
 
140
140
  1. Parse frontmatter → know status
141
141
  2. Read Current Focus → know exactly what was happening
@@ -143,7 +143,7 @@ When Claude reads this file after /clear:
143
143
  4. Read Evidence → know what's been learned
144
144
  5. Continue from next_action
145
145
 
146
- The file IS the debugging brain. Claude should be able to resume perfectly from any interruption point.
146
+ The file IS the debugging brain. Opencode agent should be able to resume perfectly from any interruption point.
147
147
 
148
148
  </resume_behavior>
149
149
 
@@ -230,7 +230,7 @@ jq '.entries[] | select(.status == "spawned" and .parallel_group != null)' .plan
230
230
 
231
231
  ### Resume Command
232
232
 
233
- `/gsd:resume-task` accepts:
233
+ `/gsd-resume-task` accepts:
234
234
  - No argument: Resume most recent interrupted agent
235
235
  - Agent ID: Resume specific agent
236
236
  - `--batch`: Resume entire parallel group
@@ -63,7 +63,7 @@ Type "approved" or describe issues to fix.
63
63
  ### Checkpoint Details
64
64
 
65
65
  **Automation attempted:**
66
- [What Claude tried to do]
66
+ [What Opencode agent tried to do]
67
67
 
68
68
  **Error encountered:**
69
69
  [Exact error message or auth failure]
@@ -73,7 +73,7 @@ Type "approved" or describe issues to fix.
73
73
  2. [Step 2]
74
74
 
75
75
  **I'll verify after:**
76
- [How Claude will confirm completion]
76
+ [How Opencode agent will confirm completion]
77
77
 
78
78
  ### Awaiting
79
79
 
@@ -238,7 +238,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
238
238
  - Implementation details of specific features
239
239
 
240
240
  **File paths ARE welcome:**
241
- Include file paths as concrete examples of abstractions. Use backtick formatting: `src/services/user.ts`. This makes the architecture document actionable for Claude when planning.
241
+ Include file paths as concrete examples of abstractions. Use backtick formatting: `src/services/user.ts`. This makes the architecture document actionable for Opencode agent when planning.
242
242
 
243
243
  **When filling this template:**
244
244
  - Read main entry points (index, server, main)
@@ -302,7 +302,7 @@ Template for `.planning/codebase/CONCERNS.md` - captures known issues and areas
302
302
  - Estimating risk of changes
303
303
  - Understanding where to be careful
304
304
  - Prioritizing improvements
305
- - Onboarding new Claude contexts
305
+ - Onboarding new Opencode agent contexts
306
306
  - Planning refactoring work
307
307
 
308
308
  **How this gets populated:**
@@ -2,7 +2,7 @@
2
2
 
3
3
  Template for `.planning/codebase/CONVENTIONS.md` - captures coding style and patterns.
4
4
 
5
- **Purpose:** Document how code is written in this codebase. Prescriptive guide for Claude to match existing style.
5
+ **Purpose:** Document how code is written in this codebase. Prescriptive guide for Opencode agent to match existing style.
6
6
 
7
7
  ---
8
8
 
@@ -116,10 +116,10 @@ The user is the visionary. They know:
116
116
  - References to things they like
117
117
 
118
118
  The user does NOT know (and shouldn't be asked):
119
- - Codebase patterns (Claude reads the code)
120
- - Technical risks (Claude identifies during research)
121
- - Implementation constraints (Claude figures out)
122
- - Success metrics (Claude infers from the work)
119
+ - Codebase patterns (Opencode agent reads the code)
120
+ - Technical risks (Opencode agent identifies during research)
121
+ - Implementation constraints (Opencode agent figures out)
122
+ - Success metrics (Opencode agent infers from the work)
123
123
 
124
124
  **Content should read like:**
125
125
  - A founder describing their product vision
@@ -71,7 +71,7 @@ Required YAML frontmatter:
71
71
  </yaml_fields>
72
72
 
73
73
  <guidelines>
74
- - Be specific enough that a fresh Claude instance understands immediately
74
+ - Be specific enough that a fresh Opencode agent instance understands immediately
75
75
  - Include WHY decisions were made, not just what
76
76
  - The `<next_action>` should be actionable without reading anything else
77
77
  - This file gets DELETED after resume - it's not permanent storage
@@ -4,7 +4,7 @@ Template for `.planning/phases/XX-name/DISCOVERY.md` - shallow research for libr
4
4
 
5
5
  **Purpose:** Answer "which library/option should we use" questions during mandatory discovery in plan-phase.
6
6
 
7
- For deep ecosystem research ("how do experts build this"), use `/gsd:research-phase` which produces RESEARCH.md.
7
+ For deep ecosystem research ("how do experts build this"), use `/gsd-research-phase` which produces RESEARCH.md.
8
8
 
9
9
  ---
10
10
 
@@ -142,5 +142,5 @@ Create `.planning/phases/XX-name/DISCOVERY.md`:
142
142
  - Niche/complex domains (3D, games, audio, shaders)
143
143
  - Need ecosystem knowledge, not just library choice
144
144
  - "How do experts build this" questions
145
- - Use `/gsd:research-phase` for these
145
+ - Use `/gsd-research-phase` for these
146
146
  </guidelines>
@@ -2,7 +2,7 @@
2
2
 
3
3
  Template for `.planning/MILESTONE-CONTEXT.md` - temporary handoff file from discuss-milestone to create-milestone.
4
4
 
5
- **Purpose:** Persist milestone discussion context so `/clear` can be used between commands. This file is consumed by `/gsd:new-milestone` and deleted after the milestone is created.
5
+ **Purpose:** Persist milestone discussion context so `/clear` can be used between commands. This file is consumed by `/gsd-new-milestone` and deleted after the milestone is created.
6
6
 
7
7
  ---
8
8
 
@@ -12,7 +12,7 @@ Template for `.planning/MILESTONE-CONTEXT.md` - temporary handoff file from disc
12
12
  # Milestone Context
13
13
 
14
14
  **Generated:** [date]
15
- **Status:** Ready for /gsd:new-milestone
15
+ **Status:** Ready for /gsd-new-milestone
16
16
 
17
17
  <features>
18
18
  ## Features to Build
@@ -64,7 +64,7 @@ Template for `.planning/MILESTONE-CONTEXT.md` - temporary handoff file from disc
64
64
 
65
65
  ---
66
66
 
67
- *This file is temporary. It will be deleted after /gsd:new-milestone creates the milestone.*
67
+ *This file is temporary. It will be deleted after /gsd-new-milestone creates the milestone.*
68
68
  ```
69
69
 
70
70
  <guidelines>
@@ -73,11 +73,11 @@ Template for `.planning/MILESTONE-CONTEXT.md` - temporary handoff file from disc
73
73
  The file exists only to pass context from `discuss-milestone` to `create-milestone` across a `/clear` boundary.
74
74
 
75
75
  **Lifecycle:**
76
- 1. `/gsd:discuss-milestone` creates this file at end of discussion
76
+ 1. `/gsd-discuss-milestone` creates this file at end of discussion
77
77
  2. User runs `/clear` (safe now - context is persisted)
78
- 3. `/gsd:new-milestone` reads this file
79
- 4. `/gsd:new-milestone` uses context to populate milestone
80
- 5. `/gsd:new-milestone` deletes this file after successful creation
78
+ 3. `/gsd-new-milestone` reads this file
79
+ 4. `/gsd-new-milestone` uses context to populate milestone
80
+ 5. `/gsd-new-milestone` deletes this file after successful creation
81
81
 
82
82
  **Content should include:**
83
83
  - Features identified (the core of what to build)
@@ -85,7 +85,7 @@ Output: [What artifacts will be created]
85
85
  </task>
86
86
 
87
87
  <task type="checkpoint:human-verify" gate="blocking">
88
- <what-built>[What Claude just built that needs verification]</what-built>
88
+ <what-built>[What Opencode agent just built that needs verification]</what-built>
89
89
  <how-to-verify>
90
90
  1. Run: [command to start dev server/app]
91
91
  2. Visit: [URL to check]
@@ -132,7 +132,7 @@ After completion, create `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
132
132
  | `autonomous` | Yes | `true` if no checkpoints, `false` if has checkpoints |
133
133
  | `domain` | No | Domain skill if loaded (e.g., `next-js`) |
134
134
 
135
- **Wave is pre-computed:** Wave numbers are assigned during `/gsd:plan-phase`. Execute-phase reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
135
+ **Wave is pre-computed:** Wave numbers are assigned during `/gsd-plan-phase`. Execute-phase reads `wave` directly from frontmatter and groups plans by wave number. No runtime dependency analysis needed.
136
136
 
137
137
  ---
138
138
 
@@ -274,7 +274,7 @@ See `~/.config/opencode/get-shit-done/references/tdd.md` for TDD plan structure.
274
274
 
275
275
  | Type | Use For | Autonomy |
276
276
  |------|---------|----------|
277
- | `auto` | Everything Claude can do independently | Fully autonomous |
277
+ | `auto` | Everything Opencode agent can do independently | Fully autonomous |
278
278
  | `checkpoint:human-verify` | Visual/functional verification | Pauses, returns to orchestrator |
279
279
  | `checkpoint:decision` | Implementation choices | Pauses, returns to orchestrator |
280
280
  | `checkpoint:human-action` | Truly unavoidable manual steps (rare) | Pauses, returns to orchestrator |
@@ -455,7 +455,7 @@ files_modified: [...]
455
455
 
456
456
  ## Guidelines
457
457
 
458
- - Always use XML structure for Claude parsing
458
+ - Always use XML structure for Opencode agent parsing
459
459
  - Include `wave`, `depends_on`, `files_modified`, `autonomous` in every plan
460
460
  - Prefer vertical slices over horizontal layers
461
461
  - Only reference prior SUMMARYs when genuinely needed
@@ -147,7 +147,7 @@ PROJECT.md evolves throughout the project lifecycle.
147
147
 
148
148
  For existing codebases:
149
149
 
150
- 1. **Map codebase first** via `/gsd:map-codebase`
150
+ 1. **Map codebase first** via `/gsd-map-codebase`
151
151
 
152
152
  2. **Infer Validated requirements** from existing code:
153
153
  - What does the codebase actually do?
@@ -179,6 +179,6 @@ See: .planning/PROJECT.md (updated [date])
179
179
  **Current focus:** [Current phase name]
180
180
  ```
181
181
 
182
- This ensures Claude reads current PROJECT.md context.
182
+ This ensures Opencode agent reads current PROJECT.md context.
183
183
 
184
184
  </state_reference>
@@ -2,7 +2,7 @@
2
2
 
3
3
  Template for `.planning/phases/XX-name/{phase}-RESEARCH.md` - comprehensive ecosystem research before planning.
4
4
 
5
- **Purpose:** Document what Claude needs to know to implement a phase well - not just "which library" but "how do experts build this."
5
+ **Purpose:** Document what Opencode agent needs to know to implement a phase well - not just "which library" but "how do experts build this."
6
6
 
7
7
  ---
8
8
 
@@ -127,7 +127,7 @@ Points to PROJECT.md for full context. Includes:
127
127
  - Current focus (which phase)
128
128
  - Last update date (triggers re-read if stale)
129
129
 
130
- Claude reads PROJECT.md directly for requirements, constraints, and decisions.
130
+ Opencode agent reads PROJECT.md directly for requirements, constraints, and decisions.
131
131
 
132
132
  ### Current Position
133
133
  Where we are right now:
@@ -158,10 +158,10 @@ Updated after each plan completion.
158
158
  - Effort estimate if known
159
159
  - Helps phase planning identify what to address
160
160
 
161
- **Pending Todos:** Ideas captured via /gsd:add-todo
161
+ **Pending Todos:** Ideas captured via /gsd-add-todo
162
162
  - Count of pending todos
163
163
  - Reference to .planning/todos/pending/
164
- - Brief list if few, count if many (e.g., "5 pending todos — see /gsd:check-todos")
164
+ - Brief list if few, count if many (e.g., "5 pending todos — see /gsd-check-todos")
165
165
 
166
166
  **Blockers/Concerns:** From "Next Phase Readiness" sections
167
167
  - Issues that affect future work
@@ -2,7 +2,7 @@
2
2
 
3
3
  Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped issues discovered during user acceptance testing.
4
4
 
5
- **Purpose:** Capture issues found during /gsd:verify-work. Unlike global ISSUES.md (for deferred enhancements), this file tracks bugs and problems in specific delivered work.
5
+ **Purpose:** Capture issues found during /gsd-verify-work. Unlike global ISSUES.md (for deferred enhancements), this file tracks bugs and problems in specific delivered work.
6
6
 
7
7
  **Location:** Same directory as the SUMMARY.md being tested.
8
8
 
@@ -15,7 +15,7 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped
15
15
 
16
16
  **Tested:** [date]
17
17
  **Source:** [path to SUMMARY.md that was tested]
18
- **Tester:** User via /gsd:verify-work
18
+ **Tester:** User via /gsd-verify-work
19
19
 
20
20
  ## Open Issues
21
21
 
@@ -36,7 +36,7 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped
36
36
 
37
37
  ## Resolved Issues
38
38
 
39
- [Moved here after /gsd:plan-fix executes and fixes are verified]
39
+ [Moved here after /gsd-plan-fix executes and fixes are verified]
40
40
 
41
41
  ### UAT-001: [Brief description]
42
42
  **Resolved:** [date] - Fixed in [phase]-[plan]-FIX.md
@@ -76,7 +76,7 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped
76
76
 
77
77
  **Tested:** 2025-01-15
78
78
  **Source:** .planning/phases/05-auth/05-02-SUMMARY.md
79
- **Tester:** User via /gsd:verify-work
79
+ **Tester:** User via /gsd-verify-work
80
80
 
81
81
  ## Open Issues
82
82
 
@@ -119,7 +119,7 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped
119
119
 
120
120
  <guidelines>
121
121
  **When to create:**
122
- - First time /gsd:verify-work finds an issue for a plan
122
+ - First time /gsd-verify-work finds an issue for a plan
123
123
  - One file per plan tested
124
124
 
125
125
  **Location:**
@@ -131,8 +131,8 @@ Template for `.planning/phases/XX-name/{phase}-{plan}-ISSUES.md` - phase-scoped
131
131
  - UAT ISSUES.md: Actual problems found during testing
132
132
 
133
133
  **Workflow:**
134
- 1. /gsd:verify-work creates this file with issues
135
- 2. /gsd:plan-fix reads this file and creates FIX.md plan
134
+ 1. /gsd-verify-work creates this file with issues
135
+ 2. /gsd-plan-fix reads this file and creates FIX.md plan
136
136
  3. After FIX.md executes, issues move to "Resolved" section
137
137
  4. File becomes historical record of what was found and fixed
138
138