gsd-opencode 1.5.0 → 1.5.2

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 (47) hide show
  1. package/command/gsd/add-phase.md +1 -1
  2. package/command/gsd/add-todo.md +2 -2
  3. package/command/gsd/create-roadmap.md +1 -1
  4. package/command/gsd/debug.md +2 -2
  5. package/command/gsd/help.md +2 -2
  6. package/command/gsd/insert-phase.md +1 -1
  7. package/command/gsd/new-project.md +2 -2
  8. package/command/gsd/pause-work.md +1 -1
  9. package/command/gsd/progress.md +6 -6
  10. package/command/gsd/status.md +1 -1
  11. package/get-shit-done/references/checkpoints.md +22 -22
  12. package/get-shit-done/references/continuation-format.md +11 -11
  13. package/get-shit-done/references/git-integration.md +4 -4
  14. package/get-shit-done/references/plan-format.md +24 -24
  15. package/get-shit-done/references/principles.md +14 -14
  16. package/get-shit-done/references/questioning.md +2 -2
  17. package/get-shit-done/references/scope-estimation.md +3 -3
  18. package/get-shit-done/templates/DEBUG.md +6 -6
  19. package/get-shit-done/templates/checkpoint-return.md +2 -2
  20. package/get-shit-done/templates/codebase/architecture.md +1 -1
  21. package/get-shit-done/templates/codebase/concerns.md +1 -1
  22. package/get-shit-done/templates/codebase/conventions.md +1 -1
  23. package/get-shit-done/templates/context.md +4 -4
  24. package/get-shit-done/templates/continue-here.md +1 -1
  25. package/get-shit-done/templates/milestone-context.md +3 -3
  26. package/get-shit-done/templates/phase-prompt.md +3 -3
  27. package/get-shit-done/templates/project.md +1 -1
  28. package/get-shit-done/templates/research.md +2 -2
  29. package/get-shit-done/templates/state.md +1 -1
  30. package/get-shit-done/workflows/_archive/execute-phase.md +1 -1
  31. package/get-shit-done/workflows/complete-milestone.md +1 -1
  32. package/get-shit-done/workflows/create-milestone.md +1 -1
  33. package/get-shit-done/workflows/create-roadmap.md +2 -2
  34. package/get-shit-done/workflows/debug.md +3 -3
  35. package/get-shit-done/workflows/discovery-phase.md +1 -1
  36. package/get-shit-done/workflows/discuss-milestone.md +1 -1
  37. package/get-shit-done/workflows/discuss-phase.md +2 -2
  38. package/get-shit-done/workflows/execute-phase.md +1 -1
  39. package/get-shit-done/workflows/execute-plan.md +6 -6
  40. package/get-shit-done/workflows/list-phase-assumptions.md +7 -7
  41. package/get-shit-done/workflows/map-codebase.md +2 -2
  42. package/get-shit-done/workflows/plan-phase.md +3 -3
  43. package/get-shit-done/workflows/research-phase.md +9 -9
  44. package/get-shit-done/workflows/resume-project.md +2 -2
  45. package/get-shit-done/workflows/transition.md +2 -2
  46. package/get-shit-done/workflows/verify-work.md +1 -1
  47. package/package.json +1 -1
@@ -1,14 +1,14 @@
1
1
  <principles>
2
2
  Core principles for the Gets Shit Done planning system.
3
3
 
4
- <solo_developer_claude>
4
+ <solo_developer_opencode>
5
5
 
6
- You are planning for ONE person (the user) and ONE implementer (Claude).
6
+ You are planning for ONE person (the user) and ONE implementer (OpenCode).
7
7
  - No teams, stakeholders, ceremonies, coordination overhead
8
8
  - User is the visionary/product owner
9
- - Opencode agent is the builder
10
- - Estimate effort in Opencode agent execution time, not human dev time
11
- </solo_developer_claude>
9
+ - OpenCode is the builder
10
+ - Estimate effort in OpenCode execution time, not human dev time
11
+ </solo_developer_opencode>
12
12
 
13
13
  <plans_are_prompts>
14
14
 
@@ -47,20 +47,20 @@ Plans must complete within reasonable context usage.
47
47
  - Better to have many small plans than few large ones
48
48
  </scope_control>
49
49
 
50
- <claude_automates>
50
+ <opencode_automates>
51
51
 
52
- If Opencode agent CAN do it via CLI/API/tool, Opencode agent MUST do it.
52
+ If OpenCode CAN do it via CLI/API/tool, OpenCode MUST do it.
53
53
 
54
54
  Checkpoints are for:
55
- - **Verification** - Human confirms Claude's work (visual, UX)
55
+ - **Verification** - Human confirms OpenCode's work (visual, UX)
56
56
  - **Decision** - Human makes implementation choice
57
57
 
58
58
  Not for:
59
59
  - Deploying (use CLI)
60
60
  - Creating resources (use CLI/API)
61
- - Running builds/tests (use Bash)
62
- - Writing files (use Write tool)
63
- </claude_automates>
61
+ - Running builds/tests (use bash tool)
62
+ - Writing files (use write/edit tools)
63
+ </opencode_automates>
64
64
 
65
65
  <deviation_rules>
66
66
 
@@ -121,7 +121,7 @@ Milestones mark shipped versions (v1.0 → v1.1 → v2.0).
121
121
 
122
122
  <atomic_commits>
123
123
 
124
- **Git commits = context engineering for Claude.**
124
+ **Git commits = context engineering for OpenCode.**
125
125
 
126
126
  Each task gets its own commit immediately after completion:
127
127
  - Format: `{type}({phase}-{plan}): {task-description}`
@@ -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 Opencode agent sessions
132
+ - Git history becomes primary context source for future OpenCode 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—Opencode agent works differently)
151
+ - Human dev time estimates (hours, days, weeks—OpenCode 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 — Opencode agent builds)
88
+ - "Have you done X before?" (irrelevant — OpenCode 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. Opencode agent builds — user's skills are irrelevant.
158
+ - **User skills** - NEVER ask about user's technical experience. OpenCode 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>
@@ -2,16 +2,16 @@
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
- Opencode agent degrades when it *perceives* context pressure and enters "completion mode."
5
+ OpenCode degrades when it *perceives* context pressure and enters "completion mode."
6
6
 
7
- | Context Usage | Quality | Claude's State |
7
+ | Context Usage | Quality | OpenCode's State |
8
8
  |---------------|---------|----------------|
9
9
  | 0-30% | PEAK | Thorough, comprehensive |
10
10
  | 30-50% | GOOD | Confident, solid work |
11
11
  | 50-70% | DEGRADING | Efficiency mode begins |
12
12
  | 70%+ | POOR | Rushed, minimal |
13
13
 
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.
14
+ **The 40-50% inflection point:** OpenCode 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>
@@ -32,7 +32,7 @@ reproduction: [how to trigger]
32
32
  started: [when it broke / always broken]
33
33
 
34
34
  ## Eliminated
35
- <!-- APPEND only - prevents re-investigating after /clear -->
35
+ <!-- APPEND only - prevents re-investigating after /new -->
36
36
 
37
37
  - hypothesis: [theory that was wrong]
38
38
  evidence: [what disproved it]
@@ -67,8 +67,8 @@ files_changed: []
67
67
 
68
68
  **Current Focus:**
69
69
  - OVERWRITE entirely on each update
70
- - Always reflects what Opencode agent is doing RIGHT NOW
71
- - If Opencode agent reads this after /clear, it knows exactly where to resume
70
+ - Always reflects what OpenCode is doing RIGHT NOW
71
+ - If OpenCode reads this after /new, it knows exactly where to resume
72
72
  - Fields: hypothesis, test, expecting, next_action
73
73
 
74
74
  **Symptoms:**
@@ -81,7 +81,7 @@ files_changed: []
81
81
  - APPEND only - never remove entries
82
82
  - Prevents re-investigating dead ends after context reset
83
83
  - Each entry: hypothesis, evidence that disproved it, timestamp
84
- - Critical for efficiency across /clear boundaries
84
+ - Critical for efficiency across /new boundaries
85
85
 
86
86
  **Evidence:**
87
87
  - APPEND only - never remove entries
@@ -135,7 +135,7 @@ files_changed: []
135
135
 
136
136
  <resume_behavior>
137
137
 
138
- When Opencode agent reads this file after /clear:
138
+ When OpenCode reads this file after /new:
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 Opencode agent 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. Opencode agent should be able to resume perfectly from any interruption point.
146
+ The file IS the debugging brain. OpenCode should be able to resume perfectly from any interruption point.
147
147
 
148
148
  </resume_behavior>
149
149
 
@@ -63,7 +63,7 @@ Type "approved" or describe issues to fix.
63
63
  ### Checkpoint Details
64
64
 
65
65
  **Automation attempted:**
66
- [What Opencode agent tried to do]
66
+ [What OpenCode 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 Opencode agent will confirm completion]
76
+ [How OpenCode 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 Opencode agent 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 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 Opencode agent contexts
305
+ - Onboarding new OpenCode 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 Opencode agent to match existing style.
5
+ **Purpose:** Document how code is written in this codebase. Prescriptive guide for OpenCode 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 (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)
119
+ - Codebase patterns (OpenCode reads the code)
120
+ - Technical risks (OpenCode identifies during research)
121
+ - Implementation constraints (OpenCode figures out)
122
+ - Success metrics (OpenCode 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 Opencode agent instance understands immediately
74
+ - Be specific enough that a fresh OpenCode 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
@@ -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 `/new` 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
 
@@ -70,11 +70,11 @@ Template for `.planning/MILESTONE-CONTEXT.md` - temporary handoff file from disc
70
70
  <guidelines>
71
71
  **This is a handoff artifact, not permanent documentation.**
72
72
 
73
- The file exists only to pass context from `discuss-milestone` to `create-milestone` across a `/clear` boundary.
73
+ The file exists only to pass context from `discuss-milestone` to `create-milestone` across a `/new` boundary.
74
74
 
75
75
  **Lifecycle:**
76
76
  1. `/gsd-discuss-milestone` creates this file at end of discussion
77
- 2. User runs `/clear` (safe now - context is persisted)
77
+ 2. User runs `/new` (safe now - context is persisted)
78
78
  3. `/gsd-new-milestone` reads this file
79
79
  4. `/gsd-new-milestone` uses context to populate milestone
80
80
  5. `/gsd-new-milestone` deletes this file after successful creation
@@ -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 Opencode agent just built that needs verification]</what-built>
88
+ <what-built>[What OpenCode 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]
@@ -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 Opencode agent can do independently | Fully autonomous |
277
+ | `auto` | Everything OpenCode 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 Opencode agent parsing
458
+ - Always use XML structure for OpenCode 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
@@ -179,6 +179,6 @@ See: .planning/PROJECT.md (updated [date])
179
179
  **Current focus:** [Current phase name]
180
180
  ```
181
181
 
182
- This ensures Opencode agent reads current PROJECT.md context.
182
+ This ensures OpenCode 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 Opencode agent needs to know to implement a phase well - not just "which library" but "how do experts build this."
5
+ **Purpose:** Document what OpenCode needs to know to implement a phase well - not just "which library" but "how do experts build this."
6
6
 
7
7
  ---
8
8
 
@@ -501,7 +501,7 @@ function useVehicleControls(rigidBodyRef) {
501
501
 
502
502
  **When to create:**
503
503
  - Before planning phases in niche/complex domains
504
- - When Claude's training data is likely stale or sparse
504
+ - When OpenCode's training data is likely stale or sparse
505
505
  - When "how do experts do this" matters more than "which library"
506
506
 
507
507
  **Structure:**
@@ -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
- Opencode agent reads PROJECT.md directly for requirements, constraints, and decisions.
130
+ OpenCode reads PROJECT.md directly for requirements, constraints, and decisions.
131
131
 
132
132
  ### Current Position
133
133
  Where we are right now:
@@ -844,7 +844,7 @@ All {N} plans finished via parallel execution.
844
844
 
845
845
  `/gsd-plan-phase {X+1}`
846
846
 
847
- *`/clear` first → fresh context window*
847
+ *`/new` first → fresh context window*
848
848
 
849
849
  ---
850
850
 
@@ -575,7 +575,7 @@ Tag: v[X.Y]
575
575
 
576
576
  `/gsd-discuss-milestone`
577
577
 
578
- *`/clear` first → fresh context window*
578
+ *`/new` first → fresh context window*
579
579
 
580
580
  ---
581
581
 
@@ -368,7 +368,7 @@ Milestone v[X.Y] [Name] created:
368
368
 
369
369
  `/gsd-plan-phase [N]`
370
370
 
371
- *`/clear` first → fresh context window*
371
+ *`/new` first → fresh context window*
372
372
 
373
373
  ---
374
374
 
@@ -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
- - Opencode agent reads PROJECT.md directly for requirements, constraints, decisions
389
+ - OpenCode 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
 
@@ -432,7 +432,7 @@ Project initialized:
432
432
 
433
433
  `/gsd-plan-phase 1`
434
434
 
435
- *`/clear` first → fresh context window*
435
+ *`/new` first → fresh context window*
436
436
 
437
437
  ---
438
438
 
@@ -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. Opencode agent = investigator.**
8
+ **User = reporter. OpenCode = 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 /new - run /gsd-debug to resume."
285
285
  </step>
286
286
 
287
287
  <step name="resume_from_file">
@@ -420,7 +420,7 @@ Use question:
420
420
  - [ ] Current Focus always reflects NOW
421
421
  - [ ] Evidence appended for every finding
422
422
  - [ ] Eliminated prevents re-investigation
423
- - [ ] Can resume perfectly from any /clear
423
+ - [ ] Can resume perfectly from any /new
424
424
  - [ ] Root cause confirmed with evidence before fixing
425
425
  - [ ] Fix verified against original symptoms
426
426
  </success_criteria>
@@ -22,7 +22,7 @@ NOTE: For comprehensive ecosystem research ("how do experts build this"), use /g
22
22
  <source_hierarchy>
23
23
  **MANDATORY: Context7 BEFORE WebSearch**
24
24
 
25
- Claude's training data is 6-18 months stale. Always verify.
25
+ OpenCode's training data is 6-18 months stale. Always verify.
26
26
 
27
27
  1. **Context7 MCP FIRST** - Current docs, no hallucination
28
28
  2. **Official docs** - When Context7 lacks coverage
@@ -216,7 +216,7 @@ Context saved to `.planning/MILESTONE-CONTEXT.md`
216
216
 
217
217
  `/gsd-new-milestone`
218
218
 
219
- *`/clear` first → fresh context window*
219
+ *`/new` first → fresh context window*
220
220
 
221
221
  ---
222
222
  ```
@@ -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. Opencode agent = builder.**
8
+ **User = founder/visionary. OpenCode = builder.**
9
9
 
10
10
  The user doesn't know (and shouldn't need to know):
11
11
  - Codebase patterns (you read the code)
@@ -192,7 +192,7 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-CONTEXT.md
192
192
 
193
193
  `/gsd-plan-phase ${PHASE}`
194
194
 
195
- *`/clear` first → fresh context window*
195
+ *`/new` first → fresh context window*
196
196
 
197
197
  ---
198
198
 
@@ -316,7 +316,7 @@ Present next steps based on milestone status:
316
316
 
317
317
  `/gsd-plan-phase {X+1}`
318
318
 
319
- *`/clear` first for fresh context*
319
+ *`/new` first for fresh context*
320
320
  ```
321
321
 
322
322
  **If milestone complete:**
@@ -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 Opencode agent in future sessions
1072
+ - Clear history for OpenCode 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: Opencode agent automates everything with CLI/API before checkpoints.** Checkpoints are for verification and decisions, not manual work.
1080
+ **Critical: OpenCode 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 Opencode agent already did via CLI/API]
1132
+ I automated: [what OpenCode 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
 
@@ -1685,7 +1685,7 @@ Summary: .planning/phases/{phase-dir}/{phase}-{plan}-SUMMARY.md
1685
1685
 
1686
1686
  `/gsd-execute-plan .planning/phases/{phase-dir}/{phase}-{next-plan}-PLAN.md`
1687
1687
 
1688
- *`/clear` first → fresh context window*
1688
+ *`/new` first → fresh context window*
1689
1689
 
1690
1690
  ---
1691
1691
 
@@ -1746,7 +1746,7 @@ All {Y} plans finished.
1746
1746
 
1747
1747
  `/gsd-plan-phase {Z+1}`
1748
1748
 
1749
- *`/clear` first → fresh context window*
1749
+ *`/new` first → fresh context window*
1750
1750
 
1751
1751
  ---
1752
1752
 
@@ -1786,7 +1786,7 @@ Milestone is 100% done.
1786
1786
 
1787
1787
  `/gsd-complete-milestone`
1788
1788
 
1789
- *`/clear` first → fresh context window*
1789
+ *`/new` first → fresh context window*
1790
1790
 
1791
1791
  ---
1792
1792
 
@@ -1,7 +1,7 @@
1
1
  <purpose>
2
- Surface Claude's assumptions about a phase before planning, enabling users to correct misconceptions early.
2
+ Surface OpenCode'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 Opencode agent 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 thinks, not INTAKE of what user knows. No file output - purely conversational to prompt discussion.
5
5
  </purpose>
6
6
 
7
7
  <process>
@@ -53,31 +53,31 @@ 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 Opencode agent use?
56
+ What libraries, frameworks, patterns, or tools would OpenCode 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 Opencode agent build first, second, third?
62
+ What would OpenCode 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..."
66
66
 
67
67
  **3. Scope Boundaries:**
68
- What's included vs excluded in Claude's interpretation?
68
+ What's included vs excluded in OpenCode's interpretation?
69
69
  - "This phase includes: A, B, C"
70
70
  - "This phase does NOT include: D, E, F"
71
71
  - "Boundary ambiguities: G could go either way"
72
72
 
73
73
  **4. Risk Areas:**
74
- Where does Opencode agent expect complexity or challenges?
74
+ Where does OpenCode 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 Opencode agent assume exists or needs to be in place?
80
+ What does OpenCode 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..."
@@ -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 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.
18
+ Documents are reference material for OpenCode 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 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>
@@ -405,7 +405,7 @@ Created .planning/codebase/:
405
405
 
406
406
  `/gsd-new-project`
407
407
 
408
- *`/clear` first → fresh context window*
408
+ *`/new` first → fresh context window*
409
409
 
410
410
  ---
411
411
 
@@ -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 Opencode agent 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 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>
@@ -645,7 +645,7 @@ Wave 2: {plan-03}
645
645
 
646
646
  `/gsd-execute-phase {X}`
647
647
 
648
- *`/clear` first - fresh context window*
648
+ *`/new` first - fresh context window*
649
649
 
650
650
  ---
651
651
 
@@ -679,7 +679,7 @@ If you can't specify Files + Action + Verify + Done, the task is too vague.
679
679
  - No acceptance criteria committees
680
680
  - No sub-sub-sub tasks
681
681
  - **No reflexive sequential chaining** (Plan 02 depends on 01 "just because")
682
- Tasks are instructions for Claude, not Jira tickets.
682
+ Tasks are instructions for OpenCode, not Jira tickets.
683
683
  </anti_patterns>
684
684
 
685
685
  <success_criteria>