gsd-opencode 1.4.15 → 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.
- package/bin/install.js +1 -1
- package/command/gsd/add-phase.md +14 -12
- package/command/gsd/add-todo.md +8 -6
- 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 +7 -7
- package/command/gsd/debug.md +4 -4
- 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 +76 -76
- package/command/gsd/insert-phase.md +10 -10
- 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 +7 -7
- 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 +29 -29
- 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 +7 -7
- package/command/gsd/verify-work.md +3 -3
- package/get-shit-done/references/checkpoints.md +22 -22
- package/get-shit-done/references/continuation-format.md +28 -28
- package/get-shit-done/references/git-integration.md +4 -4
- package/get-shit-done/references/plan-format.md +25 -25
- package/get-shit-done/references/principles.md +14 -14
- 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 +3 -3
- package/get-shit-done/templates/DEBUG.md +7 -7
- 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 +9 -9
- 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 +2 -2
- 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 +14 -14
- package/get-shit-done/workflows/complete-milestone.md +3 -3
- package/get-shit-done/workflows/create-milestone.md +9 -9
- package/get-shit-done/workflows/create-roadmap.md +6 -6
- package/get-shit-done/workflows/debug.md +4 -4
- package/get-shit-done/workflows/discovery-phase.md +4 -4
- package/get-shit-done/workflows/discuss-milestone.md +8 -8
- package/get-shit-done/workflows/discuss-phase.md +5 -5
- package/get-shit-done/workflows/execute-phase.md +5 -5
- package/get-shit-done/workflows/execute-plan.md +19 -19
- package/get-shit-done/workflows/list-phase-assumptions.md +11 -11
- package/get-shit-done/workflows/map-codebase.md +4 -4
- package/get-shit-done/workflows/plan-phase.md +13 -13
- package/get-shit-done/workflows/research-phase.md +13 -13
- package/get-shit-done/workflows/resume-project.md +14 -14
- package/get-shit-done/workflows/transition.md +8 -8
- package/get-shit-done/workflows/verify-work.md +4 -4
- package/package.json +1 -1
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
135
|
-
2. /gsd
|
|
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
|
|
|
@@ -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
|
+
*`/new` 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
|
+
*`/new` 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
|
+
*`/new` 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 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
|
+
*`/new` 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 = 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 /
|
|
284
|
+
"Context filling up. Safe to /new - 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>
|
|
@@ -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 /
|
|
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>
|
|
@@ -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>
|
|
@@ -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
|
-
|
|
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
|
|
@@ -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,9 +214,9 @@ 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
|
+
*`/new` first → fresh context window*
|
|
220
220
|
|
|
221
221
|
---
|
|
222
222
|
```
|
|
@@ -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 = 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
|
+
*`/new` 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,9 +314,9 @@ 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
|
+
*`/new` first for fresh context*
|
|
320
320
|
```
|
|
321
321
|
|
|
322
322
|
**If milestone complete:**
|
|
@@ -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 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 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 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
|
+
*`/new` 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
|
+
*`/new` 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
|
+
*`/new` 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
|
-
Surface
|
|
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
|
|
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>
|
|
@@ -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,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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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..."
|
|
@@ -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
|
```
|