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.
- package/command/gsd/add-phase.md +1 -1
- package/command/gsd/add-todo.md +2 -2
- package/command/gsd/create-roadmap.md +1 -1
- package/command/gsd/debug.md +2 -2
- package/command/gsd/help.md +2 -2
- package/command/gsd/insert-phase.md +1 -1
- package/command/gsd/new-project.md +2 -2
- package/command/gsd/pause-work.md +1 -1
- package/command/gsd/progress.md +6 -6
- package/command/gsd/status.md +1 -1
- package/get-shit-done/references/checkpoints.md +22 -22
- package/get-shit-done/references/continuation-format.md +11 -11
- package/get-shit-done/references/git-integration.md +4 -4
- package/get-shit-done/references/plan-format.md +24 -24
- package/get-shit-done/references/principles.md +14 -14
- package/get-shit-done/references/questioning.md +2 -2
- package/get-shit-done/references/scope-estimation.md +3 -3
- package/get-shit-done/templates/DEBUG.md +6 -6
- 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/milestone-context.md +3 -3
- package/get-shit-done/templates/phase-prompt.md +3 -3
- package/get-shit-done/templates/project.md +1 -1
- package/get-shit-done/templates/research.md +2 -2
- package/get-shit-done/templates/state.md +1 -1
- package/get-shit-done/workflows/_archive/execute-phase.md +1 -1
- package/get-shit-done/workflows/complete-milestone.md +1 -1
- package/get-shit-done/workflows/create-milestone.md +1 -1
- package/get-shit-done/workflows/create-roadmap.md +2 -2
- package/get-shit-done/workflows/debug.md +3 -3
- package/get-shit-done/workflows/discovery-phase.md +1 -1
- package/get-shit-done/workflows/discuss-milestone.md +1 -1
- package/get-shit-done/workflows/discuss-phase.md +2 -2
- package/get-shit-done/workflows/execute-phase.md +1 -1
- package/get-shit-done/workflows/execute-plan.md +6 -6
- package/get-shit-done/workflows/list-phase-assumptions.md +7 -7
- package/get-shit-done/workflows/map-codebase.md +2 -2
- package/get-shit-done/workflows/plan-phase.md +3 -3
- package/get-shit-done/workflows/research-phase.md +9 -9
- package/get-shit-done/workflows/resume-project.md +2 -2
- package/get-shit-done/workflows/transition.md +2 -2
- package/get-shit-done/workflows/verify-work.md +1 -1
- 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
|
-
<
|
|
4
|
+
<solo_developer_opencode>
|
|
5
5
|
|
|
6
|
-
You are planning for ONE person (the user) and ONE implementer (
|
|
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
|
-
-
|
|
10
|
-
- Estimate effort in
|
|
11
|
-
</
|
|
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
|
-
<
|
|
50
|
+
<opencode_automates>
|
|
51
51
|
|
|
52
|
-
If
|
|
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
|
|
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
|
|
62
|
-
- Writing files (use
|
|
63
|
-
</
|
|
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
|
|
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
|
|
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—
|
|
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 —
|
|
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.
|
|
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
|
-
|
|
5
|
+
OpenCode degrades when it *perceives* context pressure and enters "completion mode."
|
|
6
6
|
|
|
7
|
-
| Context Usage | Quality |
|
|
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:**
|
|
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 /
|
|
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
|
|
71
|
-
- If
|
|
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 /
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 (
|
|
120
|
-
- Technical risks (
|
|
121
|
-
- Implementation constraints (
|
|
122
|
-
- Success metrics (
|
|
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
|
|
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 `/
|
|
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 `/
|
|
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 `/
|
|
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
|
|
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
|
|
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
|
|
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
|
|
@@ -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
|
|
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
|
|
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
|
-
|
|
130
|
+
OpenCode reads PROJECT.md directly for requirements, constraints, and decisions.
|
|
131
131
|
|
|
132
132
|
### Current Position
|
|
133
133
|
Where we are right now:
|
|
@@ -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
|
|
|
@@ -432,7 +432,7 @@ Project initialized:
|
|
|
432
432
|
|
|
433
433
|
`/gsd-plan-phase 1`
|
|
434
434
|
|
|
435
|
-
*`/
|
|
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.
|
|
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">
|
|
@@ -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>
|
|
@@ -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
|
|
@@ -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)
|
|
@@ -192,7 +192,7 @@ Created: .planning/phases/${PHASE}-${SLUG}/${PHASE}-CONTEXT.md
|
|
|
192
192
|
|
|
193
193
|
`/gsd-plan-phase ${PHASE}`
|
|
194
194
|
|
|
195
|
-
*`/
|
|
195
|
+
*`/new` first → fresh context window*
|
|
196
196
|
|
|
197
197
|
---
|
|
198
198
|
|
|
@@ -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
|
|
|
@@ -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
|
-
*`/
|
|
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
|
-
*`/
|
|
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
|
-
*`/
|
|
1789
|
+
*`/new` first → fresh context window*
|
|
1790
1790
|
|
|
1791
1791
|
---
|
|
1792
1792
|
|
|
@@ -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>
|
|
@@ -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..."
|
|
@@ -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 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
|
-
*`/
|
|
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
|
|
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
|
-
*`/
|
|
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
|
|
682
|
+
Tasks are instructions for OpenCode, not Jira tickets.
|
|
683
683
|
</anti_patterns>
|
|
684
684
|
|
|
685
685
|
<success_criteria>
|