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
package/command/gsd/help.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-help
|
|
3
3
|
description: Show available GSD commands and usage guide
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -21,10 +21,10 @@ Output ONLY the reference content below. Do NOT add:
|
|
|
21
21
|
|
|
22
22
|
## Quick Start
|
|
23
23
|
|
|
24
|
-
1. `/gsd
|
|
25
|
-
2. `/gsd
|
|
26
|
-
3. `/gsd
|
|
27
|
-
4. `/gsd
|
|
24
|
+
1. `/gsd-new-project` - Initialize project with brief
|
|
25
|
+
2. `/gsd-create-roadmap` - Create roadmap and phases
|
|
26
|
+
3. `/gsd-plan-phase <number>` - Create detailed plan for first phase
|
|
27
|
+
4. `/gsd-execute-plan <path>` - Execute the plan
|
|
28
28
|
|
|
29
29
|
## Core Workflow
|
|
30
30
|
|
|
@@ -34,7 +34,7 @@ Initialization → Planning → Execution → Milestone Completion
|
|
|
34
34
|
|
|
35
35
|
### Project Initialization
|
|
36
36
|
|
|
37
|
-
**`/gsd
|
|
37
|
+
**`/gsd-new-project`**
|
|
38
38
|
Initialize new project with brief and configuration.
|
|
39
39
|
|
|
40
40
|
- Creates `.planning/PROJECT.md` (vision and requirements)
|
|
@@ -42,39 +42,39 @@ Initialize new project with brief and configuration.
|
|
|
42
42
|
- Asks for workflow mode (interactive/yolo) upfront
|
|
43
43
|
- Commits initialization files to git
|
|
44
44
|
|
|
45
|
-
Usage: `/gsd
|
|
45
|
+
Usage: `/gsd-new-project`
|
|
46
46
|
|
|
47
|
-
**`/gsd
|
|
47
|
+
**`/gsd-create-roadmap`**
|
|
48
48
|
Create roadmap and state tracking for initialized project.
|
|
49
49
|
|
|
50
50
|
- Creates `.planning/ROADMAP.md` (phase breakdown)
|
|
51
51
|
- Creates `.planning/STATE.md` (project memory)
|
|
52
52
|
- Creates `.planning/phases/` directories
|
|
53
53
|
|
|
54
|
-
Usage: `/gsd
|
|
54
|
+
Usage: `/gsd-create-roadmap`
|
|
55
55
|
|
|
56
|
-
**`/gsd
|
|
56
|
+
**`/gsd-map-codebase`**
|
|
57
57
|
Map an existing codebase for brownfield projects.
|
|
58
58
|
|
|
59
59
|
- Analyzes codebase with parallel explore agents
|
|
60
60
|
- Creates `.planning/codebase/` with 7 focused documents
|
|
61
61
|
- Covers stack, architecture, structure, conventions, testing, integrations, concerns
|
|
62
|
-
- Use before `/gsd
|
|
62
|
+
- Use before `/gsd-new-project` on existing codebases
|
|
63
63
|
|
|
64
|
-
Usage: `/gsd
|
|
64
|
+
Usage: `/gsd-map-codebase`
|
|
65
65
|
|
|
66
66
|
### Phase Planning
|
|
67
67
|
|
|
68
|
-
**`/gsd
|
|
68
|
+
**`/gsd-discuss-phase <number>`**
|
|
69
69
|
Help articulate your vision for a phase before planning.
|
|
70
70
|
|
|
71
71
|
- Captures how you imagine this phase working
|
|
72
72
|
- Creates CONTEXT.md with your vision, essentials, and boundaries
|
|
73
73
|
- Use when you have ideas about how something should look/feel
|
|
74
74
|
|
|
75
|
-
Usage: `/gsd
|
|
75
|
+
Usage: `/gsd-discuss-phase 2`
|
|
76
76
|
|
|
77
|
-
**`/gsd
|
|
77
|
+
**`/gsd-research-phase <number>`**
|
|
78
78
|
Comprehensive ecosystem research for niche/complex domains.
|
|
79
79
|
|
|
80
80
|
- Discovers standard stack, architecture patterns, pitfalls
|
|
@@ -82,18 +82,18 @@ Comprehensive ecosystem research for niche/complex domains.
|
|
|
82
82
|
- Use for 3D, games, audio, shaders, ML, and other specialized domains
|
|
83
83
|
- Goes beyond "which library" to ecosystem knowledge
|
|
84
84
|
|
|
85
|
-
Usage: `/gsd
|
|
85
|
+
Usage: `/gsd-research-phase 3`
|
|
86
86
|
|
|
87
|
-
**`/gsd
|
|
87
|
+
**`/gsd-list-phase-assumptions <number>`**
|
|
88
88
|
See what OpenCode is planning to do before it starts.
|
|
89
89
|
|
|
90
90
|
- Shows OpenCode's intended approach for a phase
|
|
91
91
|
- Lets you course-correct if OpenCode misunderstood your vision
|
|
92
92
|
- No files created - conversational output only
|
|
93
93
|
|
|
94
|
-
Usage: `/gsd
|
|
94
|
+
Usage: `/gsd-list-phase-assumptions 3`
|
|
95
95
|
|
|
96
|
-
**`/gsd
|
|
96
|
+
**`/gsd-plan-phase <number>`**
|
|
97
97
|
Create detailed execution plan for a specific phase.
|
|
98
98
|
|
|
99
99
|
- Generates `.planning/phases/XX-phase-name/XX-YY-PLAN.md`
|
|
@@ -101,12 +101,12 @@ Create detailed execution plan for a specific phase.
|
|
|
101
101
|
- Includes verification criteria and success measures
|
|
102
102
|
- Multiple plans per phase supported (XX-01, XX-02, etc.)
|
|
103
103
|
|
|
104
|
-
Usage: `/gsd
|
|
104
|
+
Usage: `/gsd-plan-phase 1`
|
|
105
105
|
Result: Creates `.planning/phases/01-foundation/01-01-PLAN.md`
|
|
106
106
|
|
|
107
107
|
### Execution
|
|
108
108
|
|
|
109
|
-
**`/gsd
|
|
109
|
+
**`/gsd-execute-plan <path>`**
|
|
110
110
|
Execute a single PLAN.md file.
|
|
111
111
|
|
|
112
112
|
- Runs plan tasks sequentially
|
|
@@ -114,16 +114,16 @@ Execute a single PLAN.md file.
|
|
|
114
114
|
- Updates STATE.md with accumulated context
|
|
115
115
|
- Use for interactive execution with checkpoints
|
|
116
116
|
|
|
117
|
-
Usage: `/gsd
|
|
117
|
+
Usage: `/gsd-execute-plan .planning/phases/01-foundation/01-01-PLAN.md`
|
|
118
118
|
|
|
119
|
-
**`/gsd
|
|
119
|
+
**`/gsd-execute-phase <phase-number>`**
|
|
120
120
|
Execute all unexecuted plans in a phase with parallel agents.
|
|
121
121
|
|
|
122
122
|
- Analyzes plan dependencies and spawns independent plans concurrently
|
|
123
123
|
- Use when phase has 2+ plans and you want "walk away" execution
|
|
124
124
|
- Respects max_concurrent_agents from config.json
|
|
125
125
|
|
|
126
|
-
Usage: `/gsd
|
|
126
|
+
Usage: `/gsd-execute-phase 5`
|
|
127
127
|
|
|
128
128
|
Options (via `.planning/config.json` parallelization section):
|
|
129
129
|
- `max_concurrent_agents`: Limit parallel agents (default: 3)
|
|
@@ -132,26 +132,26 @@ Options (via `.planning/config.json` parallelization section):
|
|
|
132
132
|
|
|
133
133
|
### Roadmap Management
|
|
134
134
|
|
|
135
|
-
**`/gsd
|
|
135
|
+
**`/gsd-add-phase <description>`**
|
|
136
136
|
Add new phase to end of current milestone.
|
|
137
137
|
|
|
138
138
|
- Appends to ROADMAP.md
|
|
139
139
|
- Uses next sequential number
|
|
140
140
|
- Updates phase directory structure
|
|
141
141
|
|
|
142
|
-
Usage: `/gsd
|
|
142
|
+
Usage: `/gsd-add-phase "Add admin dashboard"`
|
|
143
143
|
|
|
144
|
-
**`/gsd
|
|
144
|
+
**`/gsd-insert-phase <after> <description>`**
|
|
145
145
|
Insert urgent work as decimal phase between existing phases.
|
|
146
146
|
|
|
147
147
|
- Creates intermediate phase (e.g., 7.1 between 7 and 8)
|
|
148
148
|
- Useful for discovered work that must happen mid-milestone
|
|
149
149
|
- Maintains phase ordering
|
|
150
150
|
|
|
151
|
-
Usage: `/gsd
|
|
151
|
+
Usage: `/gsd-insert-phase 7 "Fix critical auth bug"`
|
|
152
152
|
Result: Creates Phase 7.1
|
|
153
153
|
|
|
154
|
-
**`/gsd
|
|
154
|
+
**`/gsd-remove-phase <number>`**
|
|
155
155
|
Remove a future phase and renumber subsequent phases.
|
|
156
156
|
|
|
157
157
|
- Deletes phase directory and all references
|
|
@@ -159,30 +159,30 @@ Remove a future phase and renumber subsequent phases.
|
|
|
159
159
|
- Only works on future (unstarted) phases
|
|
160
160
|
- Git commit preserves historical record
|
|
161
161
|
|
|
162
|
-
Usage: `/gsd
|
|
162
|
+
Usage: `/gsd-remove-phase 17`
|
|
163
163
|
Result: Phase 17 deleted, phases 18-20 become 17-19
|
|
164
164
|
|
|
165
165
|
### Milestone Management
|
|
166
166
|
|
|
167
|
-
**`/gsd
|
|
167
|
+
**`/gsd-discuss-milestone`**
|
|
168
168
|
Figure out what you want to build in the next milestone.
|
|
169
169
|
|
|
170
170
|
- Reviews what shipped in previous milestone
|
|
171
171
|
- Helps you identify features to add, improve, or fix
|
|
172
|
-
- Routes to /gsd
|
|
172
|
+
- Routes to /gsd-new-milestone when ready
|
|
173
173
|
|
|
174
|
-
Usage: `/gsd
|
|
174
|
+
Usage: `/gsd-discuss-milestone`
|
|
175
175
|
|
|
176
|
-
**`/gsd
|
|
176
|
+
**`/gsd-new-milestone <name>`**
|
|
177
177
|
Create a new milestone with phases for an existing project.
|
|
178
178
|
|
|
179
179
|
- Adds milestone section to ROADMAP.md
|
|
180
180
|
- Creates phase directories
|
|
181
181
|
- Updates STATE.md for new milestone
|
|
182
182
|
|
|
183
|
-
Usage: `/gsd
|
|
183
|
+
Usage: `/gsd-new-milestone "v2.0 Features"`
|
|
184
184
|
|
|
185
|
-
**`/gsd
|
|
185
|
+
**`/gsd-complete-milestone <version>`**
|
|
186
186
|
Archive completed milestone and prepare for next version.
|
|
187
187
|
|
|
188
188
|
- Creates MILESTONES.md entry with stats
|
|
@@ -190,11 +190,11 @@ Archive completed milestone and prepare for next version.
|
|
|
190
190
|
- Creates git tag for the release
|
|
191
191
|
- Prepares workspace for next version
|
|
192
192
|
|
|
193
|
-
Usage: `/gsd
|
|
193
|
+
Usage: `/gsd-complete-milestone 1.0.0`
|
|
194
194
|
|
|
195
195
|
### Progress Tracking
|
|
196
196
|
|
|
197
|
-
**`/gsd
|
|
197
|
+
**`/gsd-progress`**
|
|
198
198
|
Check project status and intelligently route to next action.
|
|
199
199
|
|
|
200
200
|
- Shows visual progress bar and completion percentage
|
|
@@ -204,31 +204,31 @@ Check project status and intelligently route to next action.
|
|
|
204
204
|
- Offers to execute next plan or create it if missing
|
|
205
205
|
- Detects 100% milestone completion
|
|
206
206
|
|
|
207
|
-
Usage: `/gsd
|
|
207
|
+
Usage: `/gsd-progress`
|
|
208
208
|
|
|
209
209
|
### Session Management
|
|
210
210
|
|
|
211
|
-
**`/gsd
|
|
211
|
+
**`/gsd-resume-work`**
|
|
212
212
|
Resume work from previous session with full context restoration.
|
|
213
213
|
|
|
214
214
|
- Reads STATE.md for project context
|
|
215
215
|
- Shows current position and recent progress
|
|
216
216
|
- Offers next actions based on project state
|
|
217
217
|
|
|
218
|
-
Usage: `/gsd
|
|
218
|
+
Usage: `/gsd-resume-work`
|
|
219
219
|
|
|
220
|
-
**`/gsd
|
|
220
|
+
**`/gsd-pause-work`**
|
|
221
221
|
Create context handoff when pausing work mid-phase.
|
|
222
222
|
|
|
223
223
|
- Creates .continue-here file with current state
|
|
224
224
|
- Updates STATE.md session continuity section
|
|
225
225
|
- Captures in-progress work context
|
|
226
226
|
|
|
227
|
-
Usage: `/gsd
|
|
227
|
+
Usage: `/gsd-pause-work`
|
|
228
228
|
|
|
229
229
|
### Issue Management
|
|
230
230
|
|
|
231
|
-
**`/gsd
|
|
231
|
+
**`/gsd-consider-issues`**
|
|
232
232
|
Review deferred issues with codebase context.
|
|
233
233
|
|
|
234
234
|
- Analyzes all open issues against current codebase state
|
|
@@ -237,25 +237,25 @@ Review deferred issues with codebase context.
|
|
|
237
237
|
- Identifies natural fits for upcoming phases
|
|
238
238
|
- Offers batch actions (close, insert phase, note for planning)
|
|
239
239
|
|
|
240
|
-
Usage: `/gsd
|
|
240
|
+
Usage: `/gsd-consider-issues`
|
|
241
241
|
|
|
242
242
|
### Debugging
|
|
243
243
|
|
|
244
|
-
**`/gsd
|
|
244
|
+
**`/gsd-debug [issue description]`**
|
|
245
245
|
Systematic debugging with persistent state across context resets.
|
|
246
246
|
|
|
247
247
|
- Gathers symptoms through adaptive questioning
|
|
248
248
|
- Creates `.planning/debug/[slug].md` to track investigation
|
|
249
249
|
- Investigates using scientific method (evidence → hypothesis → test)
|
|
250
|
-
- Survives `/clear` — run `/gsd
|
|
250
|
+
- Survives `/clear` — run `/gsd-debug` with no args to resume
|
|
251
251
|
- Archives resolved issues to `.planning/debug/resolved/`
|
|
252
252
|
|
|
253
|
-
Usage: `/gsd
|
|
254
|
-
Usage: `/gsd
|
|
253
|
+
Usage: `/gsd-debug "login button doesn't work"`
|
|
254
|
+
Usage: `/gsd-debug` (resume active session)
|
|
255
255
|
|
|
256
256
|
### Todo Management
|
|
257
257
|
|
|
258
|
-
**`/gsd
|
|
258
|
+
**`/gsd-add-todo [description]`**
|
|
259
259
|
Capture idea or task as todo from current conversation.
|
|
260
260
|
|
|
261
261
|
- Extracts context from conversation (or uses provided description)
|
|
@@ -264,24 +264,24 @@ Capture idea or task as todo from current conversation.
|
|
|
264
264
|
- Checks for duplicates before creating
|
|
265
265
|
- Updates STATE.md todo count
|
|
266
266
|
|
|
267
|
-
Usage: `/gsd
|
|
268
|
-
Usage: `/gsd
|
|
267
|
+
Usage: `/gsd-add-todo` (infers from conversation)
|
|
268
|
+
Usage: `/gsd-add-todo Add auth token refresh`
|
|
269
269
|
|
|
270
|
-
**`/gsd
|
|
270
|
+
**`/gsd-check-todos [area]`**
|
|
271
271
|
List pending todos and select one to work on.
|
|
272
272
|
|
|
273
273
|
- Lists all pending todos with title, area, age
|
|
274
|
-
- Optional area filter (e.g., `/gsd
|
|
274
|
+
- Optional area filter (e.g., `/gsd-check-todos api`)
|
|
275
275
|
- Loads full context for selected todo
|
|
276
276
|
- Routes to appropriate action (work now, add to phase, brainstorm)
|
|
277
277
|
- Moves todo to done/ when work begins
|
|
278
278
|
|
|
279
|
-
Usage: `/gsd
|
|
280
|
-
Usage: `/gsd
|
|
279
|
+
Usage: `/gsd-check-todos`
|
|
280
|
+
Usage: `/gsd-check-todos api`
|
|
281
281
|
|
|
282
282
|
### Utility Commands
|
|
283
283
|
|
|
284
|
-
**`/gsd
|
|
284
|
+
**`/gsd-help`**
|
|
285
285
|
Show this command reference.
|
|
286
286
|
|
|
287
287
|
## Files & Structure
|
|
@@ -317,7 +317,7 @@ Show this command reference.
|
|
|
317
317
|
|
|
318
318
|
## Workflow Modes
|
|
319
319
|
|
|
320
|
-
Set during `/gsd
|
|
320
|
+
Set during `/gsd-new-project`:
|
|
321
321
|
|
|
322
322
|
**Interactive Mode**
|
|
323
323
|
|
|
@@ -338,49 +338,49 @@ Change anytime by editing `.planning/config.json`
|
|
|
338
338
|
**Starting a new project:**
|
|
339
339
|
|
|
340
340
|
```
|
|
341
|
-
/gsd
|
|
342
|
-
/gsd
|
|
343
|
-
/gsd
|
|
344
|
-
/gsd
|
|
341
|
+
/gsd-new-project
|
|
342
|
+
/gsd-create-roadmap
|
|
343
|
+
/gsd-plan-phase 1
|
|
344
|
+
/gsd-execute-plan .planning/phases/01-foundation/01-01-PLAN.md
|
|
345
345
|
```
|
|
346
346
|
|
|
347
347
|
**Resuming work after a break:**
|
|
348
348
|
|
|
349
349
|
```
|
|
350
|
-
/gsd
|
|
350
|
+
/gsd-progress # See where you left off and continue
|
|
351
351
|
```
|
|
352
352
|
|
|
353
353
|
**Adding urgent mid-milestone work:**
|
|
354
354
|
|
|
355
355
|
```
|
|
356
|
-
/gsd
|
|
357
|
-
/gsd
|
|
358
|
-
/gsd
|
|
356
|
+
/gsd-insert-phase 5 "Critical security fix"
|
|
357
|
+
/gsd-plan-phase 5.1
|
|
358
|
+
/gsd-execute-plan .planning/phases/05.1-critical-security-fix/05.1-01-PLAN.md
|
|
359
359
|
```
|
|
360
360
|
|
|
361
361
|
**Completing a milestone:**
|
|
362
362
|
|
|
363
363
|
```
|
|
364
|
-
/gsd
|
|
365
|
-
/gsd
|
|
364
|
+
/gsd-complete-milestone 1.0.0
|
|
365
|
+
/gsd-new-project # Start next milestone
|
|
366
366
|
```
|
|
367
367
|
|
|
368
368
|
**Capturing ideas during work:**
|
|
369
369
|
|
|
370
370
|
```
|
|
371
|
-
/gsd
|
|
372
|
-
/gsd
|
|
373
|
-
/gsd
|
|
374
|
-
/gsd
|
|
371
|
+
/gsd-add-todo # Capture from conversation context
|
|
372
|
+
/gsd-add-todo Fix modal z-index # Capture with explicit description
|
|
373
|
+
/gsd-check-todos # Review and work on todos
|
|
374
|
+
/gsd-check-todos api # Filter by area
|
|
375
375
|
```
|
|
376
376
|
|
|
377
377
|
**Debugging an issue:**
|
|
378
378
|
|
|
379
379
|
```
|
|
380
|
-
/gsd
|
|
380
|
+
/gsd-debug "form submission fails silently" # Start debug session
|
|
381
381
|
# ... investigation happens, context fills up ...
|
|
382
382
|
/clear
|
|
383
|
-
/gsd
|
|
383
|
+
/gsd-debug # Resume from where you left off
|
|
384
384
|
```
|
|
385
385
|
|
|
386
386
|
## Getting Help
|
|
@@ -388,5 +388,5 @@ Change anytime by editing `.planning/config.json`
|
|
|
388
388
|
- Read `.planning/PROJECT.md` for project vision
|
|
389
389
|
- Read `.planning/STATE.md` for current context
|
|
390
390
|
- Check `.planning/ROADMAP.md` for phase status
|
|
391
|
-
- Run `/gsd
|
|
391
|
+
- Run `/gsd-progress` to check where you're up to
|
|
392
392
|
</reference>
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-insert-phase
|
|
3
3
|
description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
|
|
4
4
|
argument-hint: <after> <description>
|
|
5
5
|
allowed-tools:
|
|
@@ -26,9 +26,9 @@ Purpose: Handle urgent work discovered during execution without renumbering enti
|
|
|
26
26
|
<step name="parse_arguments">
|
|
27
27
|
Parse the command arguments:
|
|
28
28
|
- First argument ($1): integer phase number to insert after
|
|
29
|
-
- Remaining arguments ($2 $3 $4 $5 $6 $7 $8 $9 $10 $11
|
|
29
|
+
- Remaining arguments ($2 $3 $4 $5 $6 $7 $8 $9 $10 $11 $12 ...): phase description
|
|
30
30
|
|
|
31
|
-
Example: `/gsd
|
|
31
|
+
Example: `/gsd-insert-phase 72 Fix critical auth bug`
|
|
32
32
|
→ after = 72
|
|
33
33
|
→ description = "Fix critical auth bug"
|
|
34
34
|
|
|
@@ -37,8 +37,8 @@ Validation:
|
|
|
37
37
|
```bash
|
|
38
38
|
if [ $# -lt 2 ]; then
|
|
39
39
|
echo "ERROR: Both phase number and description required"
|
|
40
|
-
echo "Usage: /gsd
|
|
41
|
-
echo "Example: /gsd
|
|
40
|
+
echo "Usage: /gsd-insert-phase <after> <description>"
|
|
41
|
+
echo "Example: /gsd-insert-phase 72 Fix critical auth bug"
|
|
42
42
|
exit 1
|
|
43
43
|
fi
|
|
44
44
|
```
|
|
@@ -143,7 +143,7 @@ Insert the new phase entry into the roadmap:
|
|
|
143
143
|
**Plans:** 0 plans
|
|
144
144
|
|
|
145
145
|
Plans:
|
|
146
|
-
- [ ] TBD (run /gsd
|
|
146
|
+
- [ ] TBD (run /gsd-plan-phase {decimal_phase} to break down)
|
|
147
147
|
|
|
148
148
|
**Details:**
|
|
149
149
|
[To be added during planning]
|
|
@@ -189,7 +189,7 @@ Project state updated: .planning/STATE.md
|
|
|
189
189
|
|
|
190
190
|
**Phase {decimal_phase}: {description}** — urgent insertion
|
|
191
191
|
|
|
192
|
-
`/gsd
|
|
192
|
+
`/gsd-plan-phase {decimal_phase}`
|
|
193
193
|
|
|
194
194
|
*`/clear` first → fresh context window*
|
|
195
195
|
|
|
@@ -207,11 +207,11 @@ Project state updated: .planning/STATE.md
|
|
|
207
207
|
|
|
208
208
|
<anti_patterns>
|
|
209
209
|
|
|
210
|
-
- Don't use this for planned work at end of milestone (use /gsd
|
|
210
|
+
- Don't use this for planned work at end of milestone (use /gsd-add-phase)
|
|
211
211
|
- Don't insert before Phase 1 (decimal 0.1 makes no sense)
|
|
212
212
|
- Don't renumber existing phases
|
|
213
213
|
- Don't modify the target phase content
|
|
214
|
-
- Don't create plans yet (that's /gsd
|
|
214
|
+
- Don't create plans yet (that's /gsd-plan-phase)
|
|
215
215
|
- Don't commit changes (user decides when to commit)
|
|
216
216
|
</anti_patterns>
|
|
217
217
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-list-phase-assumptions
|
|
3
3
|
description: Surface OpenCode's assumptions about a phase approach before planning
|
|
4
4
|
argument-hint: "[phase]"
|
|
5
5
|
allowed-tools:
|
|
@@ -21,7 +21,7 @@ Output: Conversational output only (no file creation) - ends with "What do you t
|
|
|
21
21
|
</execution_context>
|
|
22
22
|
|
|
23
23
|
<context>
|
|
24
|
-
Phase number:
|
|
24
|
+
Phase number: $ARGUMENTS (required)
|
|
25
25
|
|
|
26
26
|
**Load project state first:**
|
|
27
27
|
@.planning/STATE.md
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-map-codebase
|
|
3
3
|
description: Analyze codebase with parallel explore agents to produce .planning/codebase/ documents
|
|
4
4
|
argument-hint: "[optional: specific area to map, e.g., 'api' or 'auth']"
|
|
5
5
|
allowed-tools:
|
|
@@ -31,14 +31,14 @@ Output: .planning/codebase/ folder with 7 structured documents about the codebas
|
|
|
31
31
|
</execution_context>
|
|
32
32
|
|
|
33
33
|
<context>
|
|
34
|
-
Focus area:
|
|
34
|
+
Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specific subsystem)
|
|
35
35
|
|
|
36
36
|
**Load project state if exists:**
|
|
37
37
|
Check for .planning/STATE.md - loads context if project already initialized
|
|
38
38
|
|
|
39
39
|
**This command can run:**
|
|
40
|
-
- Before /gsd
|
|
41
|
-
- After /gsd
|
|
40
|
+
- Before /gsd-new-project (brownfield codebases) - creates codebase map first
|
|
41
|
+
- After /gsd-new-project (greenfield codebases) - updates codebase map as code evolves
|
|
42
42
|
- Anytime to refresh codebase understanding
|
|
43
43
|
</context>
|
|
44
44
|
|
|
@@ -72,7 +72,7 @@ Check for .planning/STATE.md - loads context if project already initialized
|
|
|
72
72
|
- TESTING.md - Test structure, coverage, practices
|
|
73
73
|
- INTEGRATIONS.md - APIs, databases, external services
|
|
74
74
|
- CONCERNS.md - Technical debt, risks, issues
|
|
75
|
-
6. Offer next steps (typically: /gsd
|
|
75
|
+
6. Offer next steps (typically: /gsd-new-project or /gsd-plan-phase)
|
|
76
76
|
</process>
|
|
77
77
|
|
|
78
78
|
<success_criteria>
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-new-milestone
|
|
3
3
|
description: Create a new milestone with phases for an existing project
|
|
4
4
|
argument-hint: "[milestone name, e.g., 'v2.0 Features']"
|
|
5
5
|
---
|
|
@@ -17,7 +17,7 @@ Output: New milestone in ROADMAP.md, updated STATE.md, phase directories created
|
|
|
17
17
|
</execution_context>
|
|
18
18
|
|
|
19
19
|
<context>
|
|
20
|
-
Milestone name:
|
|
20
|
+
Milestone name: $ARGUMENTS (optional - will prompt if not provided)
|
|
21
21
|
|
|
22
22
|
**Load project state first:**
|
|
23
23
|
@.planning/STATE.md
|
|
@@ -34,7 +34,7 @@ Milestone name: ($ARGUMENTS) (optional - will prompt if not provided)
|
|
|
34
34
|
2. Calculate next milestone version and starting phase number
|
|
35
35
|
3. If milestone name provided in arguments, use it; otherwise prompt
|
|
36
36
|
4. Gather phases (per depth setting: quick 3-5, standard 5-8, comprehensive 8-12):
|
|
37
|
-
- If called from /gsd
|
|
37
|
+
- If called from /gsd-discuss-milestone, use provided context
|
|
38
38
|
- Otherwise, prompt for phase breakdown
|
|
39
39
|
5. Detect research needs for each phase
|
|
40
40
|
6. Confirm phases (respect config.json gate settings)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-new-project
|
|
3
3
|
description: Initialize a new project with deep context gathering and PROJECT.md
|
|
4
4
|
allowed-tools:
|
|
5
5
|
- read
|
|
@@ -35,7 +35,7 @@ Creates `.planning/` with PROJECT.md and config.json.
|
|
|
35
35
|
|
|
36
36
|
1. **Abort if project exists:**
|
|
37
37
|
```bash
|
|
38
|
-
[ -f .planning/PROJECT.md ] && echo "ERROR: Project already initialized. Use /gsd
|
|
38
|
+
[ -f .planning/PROJECT.md ] && echo "ERROR: Project already initialized. Use /gsd-progress" && exit 1
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
2. **Initialize git repo in THIS directory** (required even if inside a parent repo):
|
|
@@ -73,12 +73,12 @@ Use question:
|
|
|
73
73
|
- header: "Existing Code"
|
|
74
74
|
- question: "I detected existing code in this directory. Would you like to map the codebase first?"
|
|
75
75
|
- options:
|
|
76
|
-
- "Map codebase first" — Run /gsd
|
|
76
|
+
- "Map codebase first" — Run /gsd-map-codebase to understand existing architecture (Recommended)
|
|
77
77
|
- "Skip mapping" — Proceed with project initialization
|
|
78
78
|
|
|
79
79
|
**If "Map codebase first":**
|
|
80
80
|
```
|
|
81
|
-
Run `/gsd
|
|
81
|
+
Run `/gsd-map-codebase` first, then return to `/gsd-new-project`
|
|
82
82
|
```
|
|
83
83
|
Exit command.
|
|
84
84
|
|
|
@@ -305,7 +305,7 @@ Project initialized:
|
|
|
305
305
|
|
|
306
306
|
**[Project Name]** — create roadmap
|
|
307
307
|
|
|
308
|
-
`/gsd
|
|
308
|
+
`/gsd-create-roadmap`
|
|
309
309
|
|
|
310
310
|
*`/clear` first → fresh context window*
|
|
311
311
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
name: gsd-pause-work
|
|
3
3
|
description: Create context handoff when pausing work mid-phase
|
|
4
4
|
allowed-tools:
|
|
5
5
|
- read
|
|
@@ -86,7 +86,7 @@ Start with: [specific first action when resuming]
|
|
|
86
86
|
</next_action>
|
|
87
87
|
```
|
|
88
88
|
|
|
89
|
-
Be specific enough for a fresh
|
|
89
|
+
Be specific enough for a fresh Opencode agent to understand immediately.
|
|
90
90
|
</step>
|
|
91
91
|
|
|
92
92
|
<step name="commit">
|
|
@@ -107,7 +107,7 @@ Current state:
|
|
|
107
107
|
- Status: [in_progress/blocked]
|
|
108
108
|
- Committed as WIP
|
|
109
109
|
|
|
110
|
-
To resume: /gsd
|
|
110
|
+
To resume: /gsd-resume-work
|
|
111
111
|
|
|
112
112
|
```
|
|
113
113
|
</step>
|
package/command/gsd/plan-fix.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: gsd
|
|
2
|
+
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:
|
|
@@ -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:
|
|
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,14 +36,14 @@ Plan number: ($ARGUMENTS) (required - e.g., "04-02" or "09-01")
|
|
|
36
36
|
<step name="parse">
|
|
37
37
|
**Parse plan argument:**
|
|
38
38
|
|
|
39
|
-
|
|
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:
|
|
43
43
|
```
|
|
44
44
|
Error: Plan number required.
|
|
45
45
|
|
|
46
|
-
Usage: /gsd
|
|
46
|
+
Usage: /gsd-plan-fix 04-02
|
|
47
47
|
|
|
48
48
|
This creates a fix plan from .planning/phases/XX-name/04-02-ISSUES.md
|
|
49
49
|
```
|
|
@@ -62,7 +62,7 @@ If not found:
|
|
|
62
62
|
```
|
|
63
63
|
No ISSUES.md found for plan {plan}.
|
|
64
64
|
|
|
65
|
-
ISSUES.md files are created by /gsd
|
|
65
|
+
ISSUES.md files are created by /gsd-verify-work when UAT finds issues.
|
|
66
66
|
If no issues were found during testing, no fix plan is needed.
|
|
67
67
|
```
|
|
68
68
|
Exit.
|
|
@@ -192,7 +192,7 @@ Would you like to:
|
|
|
192
192
|
```
|
|
193
193
|
|
|
194
194
|
Use question to get response.
|
|
195
|
-
If execute: `/gsd
|
|
195
|
+
If execute: `/gsd-execute-plan .planning/phases/XX-name/{plan}-FIX.md`
|
|
196
196
|
</step>
|
|
197
197
|
|
|
198
198
|
</process>
|