gsd-opencode 1.3.33 → 1.4.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/LICENSE +21 -0
- package/command/gsd/add-phase.md +3 -3
- package/command/gsd/add-todo.md +182 -0
- package/command/gsd/check-todos.md +217 -0
- package/command/gsd/complete-milestone.md +4 -3
- package/command/gsd/consider-issues.md +5 -5
- package/command/gsd/create-roadmap.md +4 -4
- package/command/gsd/debug.md +58 -0
- package/command/gsd/discuss-phase.md +3 -4
- package/command/gsd/execute-phase.md +137 -0
- package/command/gsd/execute-plan.md +70 -95
- package/command/gsd/help.md +83 -6
- package/command/gsd/insert-phase.md +16 -16
- package/command/gsd/list-phase-assumptions.md +8 -8
- package/command/gsd/map-codebase.md +11 -11
- package/command/gsd/new-milestone.md +1 -1
- package/command/gsd/new-project.md +26 -7
- package/command/gsd/pause-work.md +4 -3
- package/command/gsd/plan-fix.md +8 -8
- package/command/gsd/plan-phase.md +9 -9
- package/command/gsd/progress.md +20 -11
- package/command/gsd/remove-phase.md +15 -15
- package/command/gsd/research-phase.md +10 -10
- package/command/gsd/resume-work.md +4 -5
- package/command/gsd/status.md +127 -0
- package/command/gsd/verify-work.md +8 -8
- package/get-shit-done/references/continuation-format.md +8 -8
- package/get-shit-done/references/debugging/debugging-mindset.md +253 -0
- package/get-shit-done/references/debugging/hypothesis-testing.md +373 -0
- package/get-shit-done/references/debugging/investigation-techniques.md +337 -0
- package/get-shit-done/references/debugging/verification-patterns.md +425 -0
- package/get-shit-done/references/debugging/when-to-research.md +361 -0
- package/get-shit-done/references/plan-format.md +68 -21
- package/get-shit-done/references/questioning.md +12 -12
- package/get-shit-done/references/research-pitfalls.md +2 -2
- package/get-shit-done/references/scope-estimation.md +95 -11
- package/get-shit-done/templates/DEBUG.md +159 -0
- package/get-shit-done/templates/agent-history.md +263 -0
- package/get-shit-done/templates/checkpoint-return.md +204 -0
- package/get-shit-done/templates/codebase/architecture.md +4 -4
- package/get-shit-done/templates/codebase/concerns.md +1 -1
- package/get-shit-done/templates/codebase/structure.md +11 -11
- package/get-shit-done/templates/config.json +8 -0
- package/get-shit-done/templates/context.md +0 -21
- package/get-shit-done/templates/continuation-prompt.md +235 -0
- package/get-shit-done/templates/milestone-archive.md +1 -1
- package/get-shit-done/templates/phase-prompt.md +289 -129
- package/get-shit-done/templates/roadmap.md +1 -1
- package/get-shit-done/templates/state.md +11 -0
- package/get-shit-done/templates/subagent-task-prompt.md +95 -0
- package/get-shit-done/templates/summary.md +2 -2
- package/get-shit-done/workflows/_archive/execute-phase.md +899 -0
- 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 +426 -0
- package/get-shit-done/workflows/discovery-phase.md +1 -1
- package/get-shit-done/workflows/discuss-milestone.md +6 -6
- package/get-shit-done/workflows/discuss-phase.md +12 -22
- package/get-shit-done/workflows/execute-phase.md +272 -1504
- package/get-shit-done/workflows/execute-plan.md +1813 -0
- package/get-shit-done/workflows/map-codebase.md +9 -9
- package/get-shit-done/workflows/plan-phase.md +262 -49
- package/get-shit-done/workflows/resume-project.md +28 -2
- package/get-shit-done/workflows/transition.md +4 -4
- package/get-shit-done/workflows/verify-work.md +4 -4
- package/package.json +1 -1
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
name: gsd:new-project
|
|
3
3
|
description: Initialize a new project with deep context gathering and PROJECT.md
|
|
4
4
|
allowed-tools:
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
5
|
+
- read
|
|
6
|
+
- bash
|
|
7
|
+
- write
|
|
8
8
|
- question
|
|
9
9
|
---
|
|
10
10
|
|
|
@@ -228,8 +228,8 @@ Use question:
|
|
|
228
228
|
- header: "Mode"
|
|
229
229
|
- question: "How do you want to work?"
|
|
230
230
|
- options:
|
|
231
|
+
- "YOLO" — Auto-approve, just execute (Recommended)
|
|
231
232
|
- "Interactive" — Confirm at each step
|
|
232
|
-
- "YOLO" — Auto-approve, just execute
|
|
233
233
|
|
|
234
234
|
</step>
|
|
235
235
|
|
|
@@ -248,7 +248,27 @@ Use question:
|
|
|
248
248
|
|
|
249
249
|
**Depth controls compression tolerance, not artificial inflation.** All depths use 2-3 tasks per plan. Comprehensive means "don't compress complex work"—it doesn't mean "pad simple work to hit a number."
|
|
250
250
|
|
|
251
|
-
|
|
251
|
+
</step>
|
|
252
|
+
|
|
253
|
+
<step name="parallelization">
|
|
254
|
+
|
|
255
|
+
Ask parallel execution preference:
|
|
256
|
+
|
|
257
|
+
Use question:
|
|
258
|
+
|
|
259
|
+
- header: "Parallelization"
|
|
260
|
+
- question: "Enable parallel phase execution?"
|
|
261
|
+
- options:
|
|
262
|
+
- "Enabled" — Run independent plans in parallel (Recommended)
|
|
263
|
+
- "Disabled" — Execute plans sequentially
|
|
264
|
+
|
|
265
|
+
**Parallelization** spawns multiple agents for independent plans within a phase. Wave-based execution handles dependencies automatically. Can be changed later in config.json.
|
|
266
|
+
|
|
267
|
+
</step>
|
|
268
|
+
|
|
269
|
+
<step name="config">
|
|
270
|
+
|
|
271
|
+
Create `.planning/config.json` with chosen mode, depth, and parallelization using `templates/config.json` structure.
|
|
252
272
|
|
|
253
273
|
</step>
|
|
254
274
|
|
|
@@ -290,7 +310,6 @@ Project initialized:
|
|
|
290
310
|
*`/clear` first → fresh context window*
|
|
291
311
|
|
|
292
312
|
---
|
|
293
|
-
|
|
294
313
|
```
|
|
295
314
|
|
|
296
315
|
</step>
|
|
@@ -310,7 +329,7 @@ Project initialized:
|
|
|
310
329
|
- [ ] PROJECT.md captures full context with evolutionary structure
|
|
311
330
|
- [ ] Requirements initialized as hypotheses (greenfield) or with inferred Validated (brownfield)
|
|
312
331
|
- [ ] Key Decisions table initialized
|
|
313
|
-
- [ ] config.json has workflow mode
|
|
332
|
+
- [ ] config.json has workflow mode, depth, and parallelization
|
|
314
333
|
- [ ] All committed to git
|
|
315
334
|
|
|
316
335
|
</success_criteria>
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
name: gsd:pause-work
|
|
3
3
|
description: Create context handoff when pausing work mid-phase
|
|
4
4
|
allowed-tools:
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
5
|
+
- read
|
|
6
|
+
- write
|
|
7
|
+
- bash
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
<objective>
|
|
@@ -120,3 +120,4 @@ To resume: /gsd:resume-work
|
|
|
120
120
|
- [ ] Committed as WIP
|
|
121
121
|
- [ ] User knows location and how to resume
|
|
122
122
|
</success_criteria>
|
|
123
|
+
```
|
package/command/gsd/plan-fix.md
CHANGED
|
@@ -3,11 +3,11 @@ name: gsd:plan-fix
|
|
|
3
3
|
description: Plan fixes for UAT issues from verify-work
|
|
4
4
|
argument-hint: "[plan, e.g., '04-02']"
|
|
5
5
|
allowed-tools:
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
6
|
+
- read
|
|
7
|
+
- bash
|
|
8
|
+
- write
|
|
9
|
+
- glob
|
|
10
|
+
- grep
|
|
11
11
|
- question
|
|
12
12
|
---
|
|
13
13
|
|
|
@@ -24,7 +24,7 @@ Output: {plan}-FIX.md in the phase directory, ready for execution.
|
|
|
24
24
|
</execution_context>
|
|
25
25
|
|
|
26
26
|
<context>
|
|
27
|
-
Plan number: $ARGUMENTS (required - e.g., "04-02" or "09-01")
|
|
27
|
+
Plan number: ($ARGUMENTS) (required - e.g., "04-02" or "09-01")
|
|
28
28
|
|
|
29
29
|
**Load project state:**
|
|
30
30
|
@.planning/STATE.md
|
|
@@ -36,7 +36,7 @@ Plan number: $ARGUMENTS (required - e.g., "04-02" or "09-01")
|
|
|
36
36
|
<step name="parse">
|
|
37
37
|
**Parse plan argument:**
|
|
38
38
|
|
|
39
|
-
$ARGUMENTS should be a plan number like "04-02" or "09-01".
|
|
39
|
+
($ARGUMENTS) should be a plan number like "04-02" or "09-01".
|
|
40
40
|
Extract phase number (XX) and plan number (NN).
|
|
41
41
|
|
|
42
42
|
If no argument provided:
|
|
@@ -126,7 +126,7 @@ Priority: {critical count} critical, {major count} major, {minor count} minor
|
|
|
126
126
|
</objective>
|
|
127
127
|
|
|
128
128
|
<execution_context>
|
|
129
|
-
@~/.config/opencode/get-shit-done/workflows/execute-
|
|
129
|
+
@~/.config/opencode/get-shit-done/workflows/execute-plan.md
|
|
130
130
|
@~/.config/opencode/get-shit-done/templates/summary.md
|
|
131
131
|
</execution_context>
|
|
132
132
|
|
|
@@ -3,11 +3,11 @@ name: gsd:plan-phase
|
|
|
3
3
|
description: Create detailed execution plan for a phase (PLAN.md)
|
|
4
4
|
argument-hint: "[phase]"
|
|
5
5
|
allowed-tools:
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
6
|
+
- read
|
|
7
|
+
- bash
|
|
8
|
+
- write
|
|
9
|
+
- glob
|
|
10
|
+
- grep
|
|
11
11
|
- question
|
|
12
12
|
- webfetch
|
|
13
13
|
- mcp__context7__*
|
|
@@ -16,7 +16,7 @@ allowed-tools:
|
|
|
16
16
|
<objective>
|
|
17
17
|
Create executable phase prompt with discovery, context injection, and task breakdown.
|
|
18
18
|
|
|
19
|
-
Purpose: Break down roadmap phases into concrete, executable PLAN.md files that
|
|
19
|
+
Purpose: Break down roadmap phases into concrete, executable PLAN.md files that OpenCode can execute.
|
|
20
20
|
Output: One or more PLAN.md files in the phase directory (.planning/phases/XX-name/{phase}-{plan}-PLAN.md)
|
|
21
21
|
</objective>
|
|
22
22
|
|
|
@@ -30,7 +30,7 @@ Output: One or more PLAN.md files in the phase directory (.planning/phases/XX-na
|
|
|
30
30
|
</execution_context>
|
|
31
31
|
|
|
32
32
|
<context>
|
|
33
|
-
Phase number: $ARGUMENTS (optional - auto-detects next unplanned phase if not provided)
|
|
33
|
+
Phase number: ($ARGUMENTS) (optional - auto-detects next unplanned phase if not provided)
|
|
34
34
|
|
|
35
35
|
**Load project state first:**
|
|
36
36
|
@.planning/STATE.md
|
|
@@ -47,7 +47,7 @@ Check for `.planning/codebase/` and load relevant documents based on phase type.
|
|
|
47
47
|
|
|
48
48
|
<process>
|
|
49
49
|
1. Check .planning/ directory exists (error if not - user should run /gsd:new-project)
|
|
50
|
-
2. If phase number provided via $ARGUMENTS, validate it exists in roadmap
|
|
50
|
+
2. If phase number provided via ($ARGUMENTS), validate it exists in roadmap
|
|
51
51
|
3. If no phase number, detect next unplanned phase from roadmap
|
|
52
52
|
4. Follow plan-phase.md workflow:
|
|
53
53
|
- Load project state and accumulated decisions
|
|
@@ -62,6 +62,6 @@ Check for `.planning/codebase/` and load relevant documents based on phase type.
|
|
|
62
62
|
|
|
63
63
|
- One or more PLAN.md files created in .planning/phases/XX-name/
|
|
64
64
|
- Each plan has: objective, execution_context, context, tasks, verification, success_criteria, output
|
|
65
|
-
- Tasks are specific enough for
|
|
65
|
+
- Tasks are specific enough for OpenCode to execute
|
|
66
66
|
- User knows next steps (execute plan or review/adjust)
|
|
67
67
|
</success_criteria>
|
package/command/gsd/progress.md
CHANGED
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
name: gsd:progress
|
|
3
3
|
description: Check project progress, show context, and route to next action (execute or plan)
|
|
4
4
|
allowed-tools:
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
5
|
+
- read
|
|
6
|
+
- bash
|
|
7
|
+
- grep
|
|
8
|
+
- glob
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
<objective>
|
|
@@ -44,7 +44,7 @@ If missing STATE.md or ROADMAP.md: inform what's missing, suggest running `/gsd:
|
|
|
44
44
|
<step name="recent">
|
|
45
45
|
**Gather recent work context:**
|
|
46
46
|
|
|
47
|
-
- Find 2-3 most recent SUMMARY.md files
|
|
47
|
+
- Find the 2-3 most recent SUMMARY.md files
|
|
48
48
|
- Extract from each: what was accomplished, key decisions, any issues logged
|
|
49
49
|
- This shows "what we've been working on"
|
|
50
50
|
</step>
|
|
@@ -56,6 +56,8 @@ If missing STATE.md or ROADMAP.md: inform what's missing, suggest running `/gsd:
|
|
|
56
56
|
- Calculate: total plans, completed plans, remaining plans
|
|
57
57
|
- Note any blockers, concerns, or deferred issues
|
|
58
58
|
- Check for CONTEXT.md: For phases without PLAN.md files, check if `{phase}-CONTEXT.md` exists in phase directory
|
|
59
|
+
- Count pending todos: `ls .planning/todos/pending/*.md 2>/dev/null | wc -l`
|
|
60
|
+
- Check for active debug sessions: `ls .planning/debug/*.md 2>/dev/null | grep -v resolved | wc -l`
|
|
59
61
|
</step>
|
|
60
62
|
|
|
61
63
|
<step name="report">
|
|
@@ -82,6 +84,13 @@ CONTEXT: [✓ if CONTEXT.md exists | - if not]
|
|
|
82
84
|
## Open Issues
|
|
83
85
|
- [any deferred issues or blockers]
|
|
84
86
|
|
|
87
|
+
## Pending Todos
|
|
88
|
+
- [count] pending — /gsd:check-todos to review
|
|
89
|
+
|
|
90
|
+
## Active Debug Sessions
|
|
91
|
+
- [count] active — /gsd:debug to continue
|
|
92
|
+
(Only show this section if count > 0)
|
|
93
|
+
|
|
85
94
|
## What's Next
|
|
86
95
|
[Next phase/plan objective from ROADMAP]
|
|
87
96
|
```
|
|
@@ -93,7 +102,7 @@ CONTEXT: [✓ if CONTEXT.md exists | - if not]
|
|
|
93
102
|
|
|
94
103
|
**Step 1: Count plans, summaries, and issues in current phase**
|
|
95
104
|
|
|
96
|
-
List files in current phase directory:
|
|
105
|
+
List files in the current phase directory:
|
|
97
106
|
|
|
98
107
|
```bash
|
|
99
108
|
ls -1 .planning/phases/[current-phase-dir]/*-PLAN.md 2>/dev/null | wc -l
|
|
@@ -128,7 +137,7 @@ Track:
|
|
|
128
137
|
|
|
129
138
|
**Route A: Unexecuted plan exists**
|
|
130
139
|
|
|
131
|
-
Find first PLAN.md without matching SUMMARY.md.
|
|
140
|
+
Find the first PLAN.md without matching SUMMARY.md.
|
|
132
141
|
Read its `<objective>` section.
|
|
133
142
|
|
|
134
143
|
```
|
|
@@ -186,7 +195,7 @@ Check if `{phase}-CONTEXT.md` exists in phase directory.
|
|
|
186
195
|
**Also available:**
|
|
187
196
|
- `/gsd:discuss-phase {phase}` — gather context first
|
|
188
197
|
- `/gsd:research-phase {phase}` — investigate unknowns
|
|
189
|
-
- `/gsd:list-phase-assumptions {phase}` — see
|
|
198
|
+
- `/gsd:list-phase-assumptions {phase}` — see OpenCode's assumptions
|
|
190
199
|
|
|
191
200
|
---
|
|
192
201
|
```
|
|
@@ -223,9 +232,9 @@ ISSUES.md exists without matching FIX.md. User needs to plan fixes.
|
|
|
223
232
|
|
|
224
233
|
Read ROADMAP.md and identify:
|
|
225
234
|
1. Current phase number
|
|
226
|
-
2. All phase numbers in current milestone section
|
|
235
|
+
2. All phase numbers in the current milestone section
|
|
227
236
|
|
|
228
|
-
Count total phases and identify highest phase number.
|
|
237
|
+
Count total phases and identify the highest phase number.
|
|
229
238
|
|
|
230
239
|
State: "Current phase is {X}. Milestone has {N} phases (highest: {Y})."
|
|
231
240
|
|
|
@@ -240,7 +249,7 @@ State: "Current phase is {X}. Milestone has {N} phases (highest: {Y})."
|
|
|
240
249
|
|
|
241
250
|
**Route C: Phase complete, more phases remain**
|
|
242
251
|
|
|
243
|
-
Read ROADMAP.md to get next phase's name and goal.
|
|
252
|
+
Read ROADMAP.md to get the next phase's name and goal.
|
|
244
253
|
|
|
245
254
|
```
|
|
246
255
|
---
|
|
@@ -3,16 +3,16 @@ name: gsd:remove-phase
|
|
|
3
3
|
description: Remove a future phase from roadmap and renumber subsequent phases
|
|
4
4
|
argument-hint: <phase-number>
|
|
5
5
|
allowed-tools:
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
6
|
+
- read
|
|
7
|
+
- write
|
|
8
|
+
- bash
|
|
9
|
+
- glob
|
|
10
10
|
---
|
|
11
11
|
|
|
12
12
|
<objective>
|
|
13
|
-
Remove an unstarted future phase from roadmap and renumber all subsequent phases to maintain a clean, linear sequence.
|
|
13
|
+
Remove an unstarted future phase from the roadmap and renumber all subsequent phases to maintain a clean, linear sequence.
|
|
14
14
|
|
|
15
|
-
Purpose: Clean removal of work you've decided not to do, without
|
|
15
|
+
Purpose: Clean removal of work you've decided not to do, without polluting context with cancelled/deferred markers.
|
|
16
16
|
Output: Phase deleted, all subsequent phases renumbered, git commit as historical record.
|
|
17
17
|
</objective>
|
|
18
18
|
|
|
@@ -24,8 +24,8 @@ Output: Phase deleted, all subsequent phases renumbered, git commit as historica
|
|
|
24
24
|
<process>
|
|
25
25
|
|
|
26
26
|
<step name="parse_arguments">
|
|
27
|
-
Parse command arguments:
|
|
28
|
-
- Argument
|
|
27
|
+
Parse the command arguments:
|
|
28
|
+
- Argument is the phase number to remove (integer or decimal)
|
|
29
29
|
- Example: `/gsd:remove-phase 17` → phase = 17
|
|
30
30
|
- Example: `/gsd:remove-phase 16.1` → phase = 16.1
|
|
31
31
|
|
|
@@ -66,7 +66,7 @@ Verify that target phase exists in ROADMAP.md:
|
|
|
66
66
|
</step>
|
|
67
67
|
|
|
68
68
|
<step name="validate_future_phase">
|
|
69
|
-
Verify that phase is a future phase (not started):
|
|
69
|
+
Verify that the phase is a future phase (not started):
|
|
70
70
|
|
|
71
71
|
1. Compare target phase to current phase from STATE.md
|
|
72
72
|
2. Target must be > current phase number
|
|
@@ -151,8 +151,8 @@ Delete target phase directory if it exists:
|
|
|
151
151
|
|
|
152
152
|
```bash
|
|
153
153
|
if [ -d ".planning/phases/{target}-{slug}" ]; then
|
|
154
|
-
rm -rf ".planning/phases/{target}
|
|
155
|
-
echo "Deleted: .planning/phases/{target}
|
|
154
|
+
rm -rf ".planning/phases/{target}-{slug}"
|
|
155
|
+
echo "Deleted: .planning/phases/{target}-{slug}/"
|
|
156
156
|
fi
|
|
157
157
|
```
|
|
158
158
|
|
|
@@ -195,14 +195,14 @@ Also handle CONTEXT.md and DISCOVERY.md (these don't have phase prefixes, so no
|
|
|
195
195
|
<step name="update_roadmap">
|
|
196
196
|
Update ROADMAP.md:
|
|
197
197
|
|
|
198
|
-
1. **Remove
|
|
198
|
+
1. **Remove phase section entirely:**
|
|
199
199
|
- Delete from `### Phase {target}:` to next phase heading (or section end)
|
|
200
200
|
|
|
201
201
|
2. **Remove from phase list:**
|
|
202
202
|
- Delete line `- [ ] **Phase {target}: {Name}**` or similar
|
|
203
203
|
|
|
204
204
|
3. **Remove from Progress table:**
|
|
205
|
-
- Delete
|
|
205
|
+
- Delete row for Phase {target}
|
|
206
206
|
|
|
207
207
|
4. **Renumber all subsequent phases:**
|
|
208
208
|
- `### Phase 18:` → `### Phase 17:`
|
|
@@ -231,7 +231,7 @@ Update STATE.md:
|
|
|
231
231
|
2. **Recalculate progress percentage:**
|
|
232
232
|
- New percentage based on completed plans / new total plans
|
|
233
233
|
|
|
234
|
-
Do NOT add a "Roadmap Evolution" note - git commit is
|
|
234
|
+
Do NOT add a "Roadmap Evolution" note - git commit is record.
|
|
235
235
|
|
|
236
236
|
Write updated STATE.md.
|
|
237
237
|
</step>
|
|
@@ -295,7 +295,7 @@ Would you like to:
|
|
|
295
295
|
- Don't remove completed phases (have SUMMARY.md files)
|
|
296
296
|
- Don't remove current or past phases
|
|
297
297
|
- Don't leave gaps in numbering - always renumber
|
|
298
|
-
- Don't add "removed phase" notes to STATE.md - git commit is
|
|
298
|
+
- Don't add "removed phase" notes to STATE.md - git commit is record
|
|
299
299
|
- Don't ask about each decimal phase - just renumber them
|
|
300
300
|
- Don't modify completed phase directories
|
|
301
301
|
</anti_patterns>
|
|
@@ -3,20 +3,20 @@ name: gsd:research-phase
|
|
|
3
3
|
description: Research how to implement a phase before planning
|
|
4
4
|
argument-hint: "[phase]"
|
|
5
5
|
allowed-tools:
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
6
|
+
- read
|
|
7
|
+
- bash
|
|
8
|
+
- glob
|
|
9
|
+
- grep
|
|
10
|
+
- write
|
|
11
11
|
- webfetch
|
|
12
|
-
-
|
|
12
|
+
- websearch
|
|
13
13
|
- mcp__context7__*
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
<objective>
|
|
17
17
|
Comprehensive research on HOW to implement a phase before planning.
|
|
18
18
|
|
|
19
|
-
This is for niche/complex domains where
|
|
19
|
+
This is for niche/complex domains where OpenCode's training data is sparse or outdated. Research discovers:
|
|
20
20
|
- What libraries exist for this problem
|
|
21
21
|
- What architecture patterns experts use
|
|
22
22
|
- What standard stack looks like
|
|
@@ -33,7 +33,7 @@ Output: RESEARCH.md with ecosystem knowledge that informs quality planning.
|
|
|
33
33
|
</execution_context>
|
|
34
34
|
|
|
35
35
|
<context>
|
|
36
|
-
Phase number: $ARGUMENTS (required)
|
|
36
|
+
Phase number: ($ARGUMENTS) (required)
|
|
37
37
|
|
|
38
38
|
**Load project state:**
|
|
39
39
|
@.planning/STATE.md
|
|
@@ -74,7 +74,7 @@ Check for `.planning/phases/XX-name/{phase}-CONTEXT.md` - bonus context from dis
|
|
|
74
74
|
- Standard web dev (auth, CRUD, REST APIs)
|
|
75
75
|
- Well-known patterns (forms, validation, testing)
|
|
76
76
|
- Simple integrations (Stripe, SendGrid with clear docs)
|
|
77
|
-
- Commodity features
|
|
77
|
+
- Commodity features OpenCode handles well
|
|
78
78
|
</when_to_use>
|
|
79
79
|
|
|
80
80
|
<success_criteria>
|
|
@@ -85,7 +85,7 @@ Check for `.planning/phases/XX-name/{phase}-CONTEXT.md` - bonus context from dis
|
|
|
85
85
|
- [ ] RESEARCH.md created with ecosystem knowledge
|
|
86
86
|
- [ ] Standard stack/libraries identified
|
|
87
87
|
- [ ] Architecture patterns documented
|
|
88
|
-
- [ ] Common pitfalls
|
|
88
|
+
- [ ] Common pitfalls catalogued
|
|
89
89
|
- [ ] What NOT to hand-roll is clear
|
|
90
90
|
- [ ] User knows next steps (plan phase)
|
|
91
91
|
</success_criteria>
|
|
@@ -2,17 +2,16 @@
|
|
|
2
2
|
name: gsd:resume-work
|
|
3
3
|
description: Resume work from previous session with full context restoration
|
|
4
4
|
allowed-tools:
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
5
|
+
- read
|
|
6
|
+
- bash
|
|
7
|
+
- write
|
|
8
8
|
- question
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
<objective>
|
|
12
12
|
Restore complete project context and resume work seamlessly from previous session.
|
|
13
13
|
|
|
14
|
-
Routes to:
|
|
15
|
-
- resume-project workflow which handles:
|
|
14
|
+
Routes to resume-project workflow which handles:
|
|
16
15
|
|
|
17
16
|
- STATE.md loading (or reconstruction if missing)
|
|
18
17
|
- Checkpoint detection (.continue-here files)
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gsd:status
|
|
3
|
+
description: Check status of background agents from parallel execution
|
|
4
|
+
argument-hint: "[--wait]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- read
|
|
7
|
+
- write
|
|
8
|
+
- bash
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
<objective>
|
|
12
|
+
Monitor background agent status from /gsd:execute-phase parallel execution.
|
|
13
|
+
|
|
14
|
+
Shows running/completed agents from agent-history.json.
|
|
15
|
+
With --wait flag, blocks until all agents complete.
|
|
16
|
+
</objective>
|
|
17
|
+
|
|
18
|
+
<context>
|
|
19
|
+
Arguments: ($ARGUMENTS)
|
|
20
|
+
</context>
|
|
21
|
+
|
|
22
|
+
<process>
|
|
23
|
+
|
|
24
|
+
<step name="load_history">
|
|
25
|
+
**Load agent history:**
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
cat .planning/agent-history.json 2>/dev/null || echo '{"entries":[]}'
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
If file doesn't exist or has no entries:
|
|
32
|
+
```
|
|
33
|
+
No background agents tracked.
|
|
34
|
+
|
|
35
|
+
Run /gsd:execute-phase to spawn parallel agents.
|
|
36
|
+
```
|
|
37
|
+
Exit.
|
|
38
|
+
</step>
|
|
39
|
+
|
|
40
|
+
<step name="filter_agents">
|
|
41
|
+
**Find background agents:**
|
|
42
|
+
|
|
43
|
+
Filter entries where:
|
|
44
|
+
- `execution_mode` is "parallel" or "background"
|
|
45
|
+
- `status` is "spawned" (still running) or recently completed
|
|
46
|
+
|
|
47
|
+
Group by `parallel_group` if present.
|
|
48
|
+
</step>
|
|
49
|
+
|
|
50
|
+
<step name="display">
|
|
51
|
+
**Show status table:**
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
Background Agents
|
|
55
|
+
════════════════════════════════════════
|
|
56
|
+
|
|
57
|
+
| Plan | Status | Elapsed | Agent ID |
|
|
58
|
+
|--------|-------------|----------|---------------|
|
|
59
|
+
| 10-01 | ✓ Complete | 2m 15s | agent_01H... |
|
|
60
|
+
| 10-02 | ⏳ Running | 1m 30s | agent_01H... |
|
|
61
|
+
| 10-04 | ✓ Complete | 1m 45s | agent_01H... |
|
|
62
|
+
|
|
63
|
+
Progress: 2/3 complete
|
|
64
|
+
|
|
65
|
+
════════════════════════════════════════
|
|
66
|
+
Wait for all: /gsd:status --wait
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
**Status icons:**
|
|
70
|
+
- ✓ Complete
|
|
71
|
+
- ⏳ Running
|
|
72
|
+
- ✗ Failed
|
|
73
|
+
- ⏸ Queued (waiting for dependency)
|
|
74
|
+
</step>
|
|
75
|
+
|
|
76
|
+
<step name="wait_mode">
|
|
77
|
+
**If --wait flag provided:**
|
|
78
|
+
|
|
79
|
+
For each agent with status "spawned", monitor until complete:
|
|
80
|
+
|
|
81
|
+
Report as each completes:
|
|
82
|
+
```
|
|
83
|
+
⏳ Waiting for 3 agents...
|
|
84
|
+
|
|
85
|
+
✓ [1/3] 10-01 complete (2m 15s)
|
|
86
|
+
✓ [2/3] 10-04 complete (1m 45s)
|
|
87
|
+
✓ [3/3] 10-02 complete (3m 30s)
|
|
88
|
+
|
|
89
|
+
════════════════════════════════════════
|
|
90
|
+
All agents complete!
|
|
91
|
+
|
|
92
|
+
Total time: 3m 30s (parallel)
|
|
93
|
+
Sequential estimate: 7m 30s
|
|
94
|
+
Time saved: ~4m (53%)
|
|
95
|
+
════════════════════════════════════════
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Update agent-history.json with completion status for each.
|
|
99
|
+
</step>
|
|
100
|
+
|
|
101
|
+
<step name="next_steps">
|
|
102
|
+
**After all complete (or if already complete):**
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## ▶ Next Up
|
|
108
|
+
|
|
109
|
+
All parallel agents finished. Review results:
|
|
110
|
+
|
|
111
|
+
`/gsd:progress`
|
|
112
|
+
|
|
113
|
+
*`/clear` first → fresh context window*
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
```
|
|
117
|
+
</step>
|
|
118
|
+
|
|
119
|
+
</process>
|
|
120
|
+
|
|
121
|
+
<success_criteria>
|
|
122
|
+
- [ ] Reads agent-history.json for background agents
|
|
123
|
+
- [ ] Updates history with current status
|
|
124
|
+
- [ ] Shows simple status table
|
|
125
|
+
- [ ] --wait flag blocks until all complete
|
|
126
|
+
- [ ] Reports time savings vs sequential
|
|
127
|
+
</success_criteria>
|
|
@@ -3,19 +3,19 @@ name: gsd:verify-work
|
|
|
3
3
|
description: Guide manual user acceptance testing of recently built features
|
|
4
4
|
argument-hint: "[optional: phase or plan number, e.g., '4' or '04-02']"
|
|
5
5
|
allowed-tools:
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
6
|
+
- read
|
|
7
|
+
- bash
|
|
8
|
+
- glob
|
|
9
|
+
- grep
|
|
10
|
+
- edit
|
|
11
|
+
- write
|
|
12
12
|
- question
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
<objective>
|
|
16
16
|
Guide user through manual acceptance testing of recently built features.
|
|
17
17
|
|
|
18
|
-
Purpose: Validate that what
|
|
18
|
+
Purpose: Validate that what OpenCode thinks was built actually works from user's perspective. The USER performs all testing — OpenCode generates a test checklist, guides process, and captures issues.
|
|
19
19
|
|
|
20
20
|
Output: Validation of features, any issues logged to phase-scoped ISSUES.md
|
|
21
21
|
</objective>
|
|
@@ -26,7 +26,7 @@ Output: Validation of features, any issues logged to phase-scoped ISSUES.md
|
|
|
26
26
|
</execution_context>
|
|
27
27
|
|
|
28
28
|
<context>
|
|
29
|
-
Scope: $ARGUMENTS (optional)
|
|
29
|
+
Scope: ($ARGUMENTS) (optional)
|
|
30
30
|
- If provided: Test specific phase or plan (e.g., "4" or "04-02")
|
|
31
31
|
- If not provided: Test most recently completed plan
|
|
32
32
|
|
|
@@ -13,7 +13,7 @@ Standard format for presenting next steps after completing a command or workflow
|
|
|
13
13
|
|
|
14
14
|
`{command to copy-paste}`
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
*`/clear` first → fresh context window*
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
@@ -46,7 +46,7 @@ Standard format for presenting next steps after completing a command or workflow
|
|
|
46
46
|
|
|
47
47
|
`/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md`
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
*`/clear` first → fresh context window*
|
|
50
50
|
|
|
51
51
|
---
|
|
52
52
|
|
|
@@ -67,11 +67,11 @@ Add note that this is the last plan and what comes after:
|
|
|
67
67
|
## ▶ Next Up
|
|
68
68
|
|
|
69
69
|
**02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
|
|
70
|
-
|
|
70
|
+
*Final plan in Phase 2*
|
|
71
71
|
|
|
72
72
|
`/gsd:execute-plan .planning/phases/02-auth/02-03-PLAN.md`
|
|
73
73
|
|
|
74
|
-
|
|
74
|
+
*`/clear` first → fresh context window*
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
@@ -93,7 +93,7 @@ Add note that this is the last plan and what comes after:
|
|
|
93
93
|
|
|
94
94
|
`/gsd:plan-phase 2`
|
|
95
95
|
|
|
96
|
-
|
|
96
|
+
*`/clear` first → fresh context window*
|
|
97
97
|
|
|
98
98
|
---
|
|
99
99
|
|
|
@@ -122,7 +122,7 @@ Show completion status before next action:
|
|
|
122
122
|
|
|
123
123
|
`/gsd:plan-phase 3`
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
*`/clear` first → fresh context window*
|
|
126
126
|
|
|
127
127
|
---
|
|
128
128
|
|
|
@@ -151,7 +151,7 @@ When there's no clear primary action:
|
|
|
151
151
|
|
|
152
152
|
**To research unknowns:** `/gsd:research-phase 3`
|
|
153
153
|
|
|
154
|
-
|
|
154
|
+
*`/clear` first → fresh context window*
|
|
155
155
|
|
|
156
156
|
---
|
|
157
157
|
```
|
|
@@ -171,7 +171,7 @@ All 4 phases shipped
|
|
|
171
171
|
|
|
172
172
|
`/gsd:discuss-milestone`
|
|
173
173
|
|
|
174
|
-
|
|
174
|
+
*`/clear` first → fresh context window*
|
|
175
175
|
|
|
176
176
|
---
|
|
177
177
|
|