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.
- package/bin/install.js +1 -1
- package/command/gsd/add-phase.md +13 -11
- package/command/gsd/add-todo.md +7 -5
- package/command/gsd/check-todos.md +12 -10
- package/command/gsd/complete-milestone.md +8 -8
- package/command/gsd/consider-issues.md +5 -5
- package/command/gsd/create-roadmap.md +6 -6
- package/command/gsd/debug.md +2 -2
- package/command/gsd/discuss-milestone.md +4 -4
- package/command/gsd/discuss-phase.md +2 -2
- package/command/gsd/execute-phase.md +4 -4
- package/command/gsd/execute-plan.md +3 -3
- package/command/gsd/help.md +75 -75
- package/command/gsd/insert-phase.md +9 -9
- package/command/gsd/list-phase-assumptions.md +2 -2
- package/command/gsd/map-codebase.md +5 -5
- package/command/gsd/new-milestone.md +3 -3
- package/command/gsd/new-project.md +5 -5
- package/command/gsd/pause-work.md +3 -3
- package/command/gsd/plan-fix.md +6 -6
- package/command/gsd/plan-phase.md +5 -5
- package/command/gsd/progress.md +23 -23
- package/command/gsd/remove-phase.md +9 -7
- package/command/gsd/research-phase.md +2 -2
- package/command/gsd/resume-work.md +1 -1
- package/command/gsd/status.md +6 -6
- package/command/gsd/verify-work.md +3 -3
- package/get-shit-done/references/checkpoints.md +19 -19
- package/get-shit-done/references/continuation-format.md +17 -17
- package/get-shit-done/references/git-integration.md +3 -3
- package/get-shit-done/references/plan-format.md +23 -23
- package/get-shit-done/references/principles.md +5 -5
- package/get-shit-done/references/questioning.md +2 -2
- package/get-shit-done/references/research-pitfalls.md +2 -2
- package/get-shit-done/references/scope-estimation.md +2 -2
- package/get-shit-done/templates/DEBUG.md +5 -5
- package/get-shit-done/templates/agent-history.md +1 -1
- package/get-shit-done/templates/checkpoint-return.md +2 -2
- package/get-shit-done/templates/codebase/architecture.md +1 -1
- package/get-shit-done/templates/codebase/concerns.md +1 -1
- package/get-shit-done/templates/codebase/conventions.md +1 -1
- package/get-shit-done/templates/context.md +4 -4
- package/get-shit-done/templates/continue-here.md +1 -1
- package/get-shit-done/templates/discovery.md +2 -2
- package/get-shit-done/templates/milestone-context.md +7 -7
- package/get-shit-done/templates/phase-prompt.md +4 -4
- package/get-shit-done/templates/project.md +2 -2
- package/get-shit-done/templates/research.md +1 -1
- package/get-shit-done/templates/state.md +3 -3
- package/get-shit-done/templates/uat-issues.md +7 -7
- package/get-shit-done/workflows/_archive/execute-phase.md +13 -13
- package/get-shit-done/workflows/complete-milestone.md +2 -2
- package/get-shit-done/workflows/create-milestone.md +8 -8
- package/get-shit-done/workflows/create-roadmap.md +5 -5
- package/get-shit-done/workflows/debug.md +3 -3
- package/get-shit-done/workflows/discovery-phase.md +3 -3
- package/get-shit-done/workflows/discuss-milestone.md +7 -7
- package/get-shit-done/workflows/discuss-phase.md +4 -4
- package/get-shit-done/workflows/execute-phase.md +4 -4
- package/get-shit-done/workflows/execute-plan.md +16 -16
- package/get-shit-done/workflows/list-phase-assumptions.md +9 -9
- package/get-shit-done/workflows/map-codebase.md +3 -3
- package/get-shit-done/workflows/plan-phase.md +11 -11
- package/get-shit-done/workflows/research-phase.md +10 -10
- package/get-shit-done/workflows/resume-project.md +12 -12
- package/get-shit-done/workflows/transition.md +6 -6
- package/get-shit-done/workflows/verify-work.md +4 -4
- package/package.json +1 -1
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
<purpose>
|
|
2
2
|
Comprehensive research on HOW to implement a phase before planning.
|
|
3
3
|
|
|
4
|
-
Triggered by /gsd
|
|
4
|
+
Triggered by /gsd-research-phase command when the domain is niche, complex, or Claude's training is likely stale.
|
|
5
5
|
|
|
6
6
|
Produces RESEARCH.md with ecosystem knowledge that informs quality planning - not just "which library" but "how do experts build this."
|
|
7
7
|
</purpose>
|
|
8
8
|
|
|
9
9
|
<when_to_use>
|
|
10
|
-
**This workflow is for domains where
|
|
10
|
+
**This workflow is for domains where Opencode agent fails without research:**
|
|
11
11
|
- 3D graphics (Three.js, Babylon.js, procedural generation, level design)
|
|
12
12
|
- Game development (physics engines, collision, AI, ECS patterns)
|
|
13
13
|
- Audio/music (Web Audio, DSP, synthesis, MIDI)
|
|
14
14
|
- Shaders (GLSL, Metal, ISF, compute shaders)
|
|
15
15
|
- ML/AI integration (model serving, inference, vector DBs)
|
|
16
16
|
- Real-time systems (WebSockets, WebRTC, CRDT sync)
|
|
17
|
-
- Specialized frameworks with active ecosystems
|
|
17
|
+
- Specialized frameworks with active ecosystems Opencode agent may not know
|
|
18
18
|
|
|
19
19
|
**Skip this for commodity domains:**
|
|
20
20
|
- Standard auth (JWT, OAuth)
|
|
@@ -32,7 +32,7 @@ For niche domains, the question isn't library selection - it's:
|
|
|
32
32
|
- What's the established architecture pattern?
|
|
33
33
|
- What libraries form the standard stack?
|
|
34
34
|
- What problems do people commonly hit?
|
|
35
|
-
- What's SOTA vs what
|
|
35
|
+
- What's SOTA vs what Opencode agent thinks is SOTA?
|
|
36
36
|
- What should NOT be hand-rolled?
|
|
37
37
|
</key_insight>
|
|
38
38
|
|
|
@@ -53,7 +53,7 @@ fi
|
|
|
53
53
|
```
|
|
54
54
|
Error: Phase ${PHASE} not found in roadmap.
|
|
55
55
|
|
|
56
|
-
Use /gsd
|
|
56
|
+
Use /gsd-progress to see available phases.
|
|
57
57
|
```
|
|
58
58
|
Exit workflow.
|
|
59
59
|
|
|
@@ -103,7 +103,7 @@ Load available context to inform research direction:
|
|
|
103
103
|
cat .planning/PROJECT.md 2>/dev/null | head -50
|
|
104
104
|
```
|
|
105
105
|
|
|
106
|
-
**2. Phase context (if exists from /gsd
|
|
106
|
+
**2. Phase context (if exists from /gsd-discuss-phase):**
|
|
107
107
|
```bash
|
|
108
108
|
cat .planning/phases/${PHASE}-*/${PHASE}-CONTEXT.md 2>/dev/null
|
|
109
109
|
```
|
|
@@ -292,7 +292,7 @@ Before creating RESEARCH.md, run through research-pitfalls.md checklist:
|
|
|
292
292
|
- [ ] "What might I have missed?" review completed
|
|
293
293
|
|
|
294
294
|
**Additional checks for ecosystem research:**
|
|
295
|
-
- [ ] Checked for libraries
|
|
295
|
+
- [ ] Checked for libraries Opencode agent might not know about
|
|
296
296
|
- [ ] Verified version numbers are current
|
|
297
297
|
- [ ] Confirmed patterns still recommended (not deprecated)
|
|
298
298
|
- [ ] Looked for "don't do this" warnings in docs
|
|
@@ -371,7 +371,7 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-RESEARCH.md
|
|
|
371
371
|
**Confidence:** [HIGH/MEDIUM/LOW] - [brief reason]
|
|
372
372
|
|
|
373
373
|
What's next?
|
|
374
|
-
1. Plan this phase (/gsd
|
|
374
|
+
1. Plan this phase (/gsd-plan-phase ${PHASE}) - RESEARCH.md will be loaded automatically
|
|
375
375
|
2. Dig deeper - Research specific areas more thoroughly
|
|
376
376
|
3. Review full RESEARCH.md
|
|
377
377
|
4. Done for now
|
|
@@ -418,7 +418,7 @@ Confirm: "Committed: docs(${PHASE}): complete phase research"
|
|
|
418
418
|
</success_criteria>
|
|
419
419
|
|
|
420
420
|
<integration_with_planning>
|
|
421
|
-
When /gsd
|
|
421
|
+
When /gsd-plan-phase runs after research:
|
|
422
422
|
|
|
423
423
|
1. plan-phase detects RESEARCH.md exists in phase directory
|
|
424
424
|
2. RESEARCH.md loaded as @context reference
|
|
@@ -428,7 +428,7 @@ When /gsd:plan-phase runs after research:
|
|
|
428
428
|
6. "Architecture patterns" inform task structure
|
|
429
429
|
7. "Code examples" can be referenced in task actions
|
|
430
430
|
|
|
431
|
-
This produces higher quality plans because
|
|
431
|
+
This produces higher quality plans because Opencode agent knows:
|
|
432
432
|
- What tools experts use
|
|
433
433
|
- What patterns to follow
|
|
434
434
|
- What mistakes to avoid
|
|
@@ -26,7 +26,7 @@ ls .planning/PROJECT.md 2>/dev/null && echo "Project file exists"
|
|
|
26
26
|
|
|
27
27
|
**If STATE.md exists:** Proceed to load_state
|
|
28
28
|
**If only ROADMAP.md/PROJECT.md exist:** Offer to reconstruct STATE.md
|
|
29
|
-
**If .planning/ doesn't exist:** This is a new project - route to /gsd
|
|
29
|
+
**If .planning/ doesn't exist:** This is a new project - route to /gsd-new-project
|
|
30
30
|
</step>
|
|
31
31
|
|
|
32
32
|
<step name="load_state">
|
|
@@ -121,7 +121,7 @@ Present complete project status to user:
|
|
|
121
121
|
Task: [task description from agent-history.json]
|
|
122
122
|
Interrupted: [timestamp]
|
|
123
123
|
|
|
124
|
-
Resume with: /gsd
|
|
124
|
+
Resume with: /gsd-resume-task
|
|
125
125
|
|
|
126
126
|
[If deferred issues exist:]
|
|
127
127
|
π [N] deferred issues awaiting attention
|
|
@@ -141,7 +141,7 @@ Present complete project status to user:
|
|
|
141
141
|
Based on project state, determine the most logical next action:
|
|
142
142
|
|
|
143
143
|
**If interrupted agent exists:**
|
|
144
|
-
β Primary: Resume interrupted agent (/gsd
|
|
144
|
+
β Primary: Resume interrupted agent (/gsd-resume-task)
|
|
145
145
|
β Option: Start fresh (abandon agent work)
|
|
146
146
|
|
|
147
147
|
**If .continue-here file exists:**
|
|
@@ -178,15 +178,15 @@ Present contextual options based on project state:
|
|
|
178
178
|
What would you like to do?
|
|
179
179
|
|
|
180
180
|
[Primary action based on state - e.g.:]
|
|
181
|
-
1. Resume interrupted agent (/gsd
|
|
181
|
+
1. Resume interrupted agent (/gsd-resume-task) [if interrupted agent found]
|
|
182
182
|
OR
|
|
183
|
-
1. Resume from checkpoint (/gsd
|
|
183
|
+
1. Resume from checkpoint (/gsd-execute-plan .planning/phases/XX-name/.continue-here-02-01.md)
|
|
184
184
|
OR
|
|
185
|
-
1. Execute next plan (/gsd
|
|
185
|
+
1. Execute next plan (/gsd-execute-plan .planning/phases/XX-name/02-02-PLAN.md)
|
|
186
186
|
OR
|
|
187
|
-
1. Discuss Phase 3 context (/gsd
|
|
187
|
+
1. Discuss Phase 3 context (/gsd-discuss-phase 3) [if CONTEXT.md missing]
|
|
188
188
|
OR
|
|
189
|
-
1. Plan Phase 3 (/gsd
|
|
189
|
+
1. Plan Phase 3 (/gsd-plan-phase 3) [if CONTEXT.md exists or discuss option declined]
|
|
190
190
|
|
|
191
191
|
[Secondary options:]
|
|
192
192
|
2. Review current phase status
|
|
@@ -217,7 +217,7 @@ Based on user selection, route to appropriate workflow:
|
|
|
217
217
|
|
|
218
218
|
**{phase}-{plan}: [Plan Name]** β [objective from PLAN.md]
|
|
219
219
|
|
|
220
|
-
`/gsd
|
|
220
|
+
`/gsd-execute-plan [path]`
|
|
221
221
|
|
|
222
222
|
*`/clear` first β fresh context window*
|
|
223
223
|
|
|
@@ -231,15 +231,15 @@ Based on user selection, route to appropriate workflow:
|
|
|
231
231
|
|
|
232
232
|
**Phase [N]: [Name]** β [Goal from ROADMAP.md]
|
|
233
233
|
|
|
234
|
-
`/gsd
|
|
234
|
+
`/gsd-plan-phase [phase-number]`
|
|
235
235
|
|
|
236
236
|
*`/clear` first β fresh context window*
|
|
237
237
|
|
|
238
238
|
---
|
|
239
239
|
|
|
240
240
|
**Also available:**
|
|
241
|
-
- `/gsd
|
|
242
|
-
- `/gsd
|
|
241
|
+
- `/gsd-discuss-phase [N]` β gather context first
|
|
242
|
+
- `/gsd-research-phase [N]` β investigate unknowns
|
|
243
243
|
|
|
244
244
|
---
|
|
245
245
|
```
|
|
@@ -449,7 +449,7 @@ Next: Phase [X+1] β [Name]
|
|
|
449
449
|
β‘ Auto-continuing: Plan Phase [X+1] in detail
|
|
450
450
|
```
|
|
451
451
|
|
|
452
|
-
Exit skill and invoke [removed - use /command syntax]("/gsd
|
|
452
|
+
Exit skill and invoke [removed - use /command syntax]("/gsd-plan-phase [X+1]")
|
|
453
453
|
|
|
454
454
|
</if>
|
|
455
455
|
|
|
@@ -464,15 +464,15 @@ Exit skill and invoke [removed - use /command syntax]("/gsd:plan-phase [X+1]")
|
|
|
464
464
|
|
|
465
465
|
**Phase [X+1]: [Name]** β [Goal from ROADMAP.md]
|
|
466
466
|
|
|
467
|
-
`/gsd
|
|
467
|
+
`/gsd-plan-phase [X+1]`
|
|
468
468
|
|
|
469
469
|
*`/clear` first β fresh context window*
|
|
470
470
|
|
|
471
471
|
---
|
|
472
472
|
|
|
473
473
|
**Also available:**
|
|
474
|
-
- `/gsd
|
|
475
|
-
- `/gsd
|
|
474
|
+
- `/gsd-discuss-phase [X+1]` β gather context first
|
|
475
|
+
- `/gsd-research-phase [X+1]` β investigate unknowns
|
|
476
476
|
- Review roadmap
|
|
477
477
|
|
|
478
478
|
---
|
|
@@ -494,7 +494,7 @@ Phase {X} marked complete.
|
|
|
494
494
|
β‘ Auto-continuing: Complete milestone and archive
|
|
495
495
|
```
|
|
496
496
|
|
|
497
|
-
Exit skill and invoke [removed - use /command syntax]("/gsd
|
|
497
|
+
Exit skill and invoke [removed - use /command syntax]("/gsd-complete-milestone {version}")
|
|
498
498
|
|
|
499
499
|
</if>
|
|
500
500
|
|
|
@@ -511,7 +511,7 @@ Exit skill and invoke [removed - use /command syntax]("/gsd:complete-milestone {
|
|
|
511
511
|
|
|
512
512
|
**Complete Milestone {version}** β archive and prepare for next
|
|
513
513
|
|
|
514
|
-
`/gsd
|
|
514
|
+
`/gsd-complete-milestone {version}`
|
|
515
515
|
|
|
516
516
|
*`/clear` first β fresh context window*
|
|
517
517
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<purpose>
|
|
2
2
|
Guide manual user acceptance testing of recently built features. Extract deliverables from SUMMARY.md, generate test checklist, guide user through each test, log issues to phase-scoped file.
|
|
3
3
|
|
|
4
|
-
The USER performs all testing β
|
|
4
|
+
The USER performs all testing β Opencode agent generates the checklist, guides the process, and captures issues.
|
|
5
5
|
</purpose>
|
|
6
6
|
|
|
7
7
|
<process>
|
|
@@ -137,7 +137,7 @@ If any issues found:
|
|
|
137
137
|
**Actual:** [What actually happened]
|
|
138
138
|
```
|
|
139
139
|
|
|
140
|
-
**Note:** Issues go to phase-scoped file, NOT global `.planning/ISSUES.md`. This keeps UAT findings tied to the specific work being tested and enables `/gsd
|
|
140
|
+
**Note:** Issues go to phase-scoped file, NOT global `.planning/ISSUES.md`. This keeps UAT findings tied to the specific work being tested and enables `/gsd-plan-fix` to address them.
|
|
141
141
|
</step>
|
|
142
142
|
|
|
143
143
|
<step name="summarize">
|
|
@@ -165,7 +165,7 @@ If any issues found:
|
|
|
165
165
|
## Next Steps
|
|
166
166
|
[Based on verdict:]
|
|
167
167
|
- If clean: Suggest proceeding to next phase
|
|
168
|
-
- If issues: Suggest /gsd
|
|
168
|
+
- If issues: Suggest /gsd-plan-fix to address
|
|
169
169
|
```
|
|
170
170
|
</step>
|
|
171
171
|
|
|
@@ -183,7 +183,7 @@ If all passed:
|
|
|
183
183
|
- "Done" β Finish testing session
|
|
184
184
|
|
|
185
185
|
If issues found:
|
|
186
|
-
- "Plan fixes" β Create plan to address issues (/gsd
|
|
186
|
+
- "Plan fixes" β Create plan to address issues (/gsd-plan-fix)
|
|
187
187
|
- "Log and continue" β Issues logged, proceed anyway
|
|
188
188
|
- "Review issues" β Look at logged issues in detail
|
|
189
189
|
- "Done" β Finish testing session
|