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
|
@@ -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
|
|
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
|
|
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
|
|
58
|
-
# Or: /gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
853
|
-
- `/gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
377
|
-
- `/gsd
|
|
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
|
|
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
|
-
-
|
|
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
|
|
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
|
|
441
|
-
- `/gsd
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
260
|
-
2. Create phase plan (/gsd
|
|
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
|
|
28
|
-
2. Add phases to current milestone (/gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1755
|
-
- `/gsd
|
|
1756
|
-
- `/gsd
|
|
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
|
|
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
|
|
1795
|
-
- `/gsd
|
|
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
|
|
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
|
|
18
|
-
Example: /gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
157
|
-
2. Plan this phase (/gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
220
|
+
- Any {phase}-RESEARCH.md (from /gsd-research-phase)
|
|
221
221
|
- Any DISCOVERY.md (from mandatory discovery)
|
|
222
|
-
- Any {phase}-CONTEXT.md (from /gsd
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
---
|