@undeemed/get-shit-done-codex 1.21.0 → 1.22.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/README.md +33 -45
- package/agents/gsd-codebase-mapper.md +3 -3
- package/agents/gsd-debugger.md +5 -5
- package/agents/gsd-executor.md +14 -14
- package/agents/gsd-phase-researcher.md +7 -7
- package/agents/gsd-plan-checker.md +10 -10
- package/agents/gsd-planner.md +19 -19
- package/agents/gsd-project-researcher.md +3 -3
- package/agents/gsd-research-synthesizer.md +6 -6
- package/agents/gsd-roadmapper.md +7 -7
- package/agents/gsd-verifier.md +29 -17
- package/bin/install.js +54 -198
- package/commands/gsd/add-tests.md +5 -4
- package/commands/gsd/complete-milestone.md +6 -6
- package/commands/gsd/debug.md +1 -1
- package/commands/gsd/map-codebase.md +3 -3
- package/commands/gsd/new-milestone.md +1 -1
- package/commands/gsd/new-project.md +1 -1
- package/commands/gsd/plan-milestone-gaps.md +2 -2
- package/commands/gsd/reapply-patches.md +2 -2
- package/commands/gsd/research-phase.md +3 -3
- package/commands/gsd/verify-work.md +1 -1
- package/get-shit-done/bin/lib/commands.cjs +1 -1
- package/get-shit-done/bin/lib/phase.cjs +2 -2
- package/get-shit-done/bin/lib/verify.cjs +8 -8
- package/get-shit-done/references/continuation-format.md +16 -16
- package/get-shit-done/references/model-profiles.md +1 -1
- package/get-shit-done/references/ui-brand.md +2 -2
- package/get-shit-done/templates/DEBUG.md +1 -1
- package/get-shit-done/templates/UAT.md +3 -3
- package/get-shit-done/templates/VALIDATION.md +1 -1
- package/get-shit-done/templates/debug-subagent-prompt.md +1 -1
- package/get-shit-done/templates/discovery.md +2 -2
- package/get-shit-done/templates/phase-prompt.md +1 -1
- package/get-shit-done/templates/planner-subagent-prompt.md +3 -3
- package/get-shit-done/templates/project.md +1 -1
- package/get-shit-done/templates/research.md +1 -1
- package/get-shit-done/templates/retrospective.md +13 -7
- package/get-shit-done/templates/state.md +2 -2
- package/get-shit-done/workflows/add-phase.md +7 -7
- package/get-shit-done/workflows/add-tests.md +41 -18
- package/get-shit-done/workflows/add-todo.md +2 -2
- package/get-shit-done/workflows/audit-milestone.md +5 -5
- package/get-shit-done/workflows/check-todos.md +8 -8
- package/get-shit-done/workflows/complete-milestone.md +33 -8
- package/get-shit-done/workflows/diagnose-issues.md +1 -1
- package/get-shit-done/workflows/discovery-phase.md +3 -3
- package/get-shit-done/workflows/discuss-phase.md +10 -10
- package/get-shit-done/workflows/execute-phase.md +7 -7
- package/get-shit-done/workflows/execute-plan.md +3 -3
- package/get-shit-done/workflows/health.md +5 -5
- package/get-shit-done/workflows/help.md +85 -85
- package/get-shit-done/workflows/insert-phase.md +6 -6
- package/get-shit-done/workflows/list-phase-assumptions.md +4 -4
- package/get-shit-done/workflows/map-codebase.md +2 -2
- package/get-shit-done/workflows/new-milestone.md +5 -5
- package/get-shit-done/workflows/new-project.md +11 -11
- package/get-shit-done/workflows/pause-work.md +1 -1
- package/get-shit-done/workflows/plan-milestone-gaps.md +7 -7
- package/get-shit-done/workflows/plan-phase.md +12 -12
- package/get-shit-done/workflows/progress.md +22 -22
- package/get-shit-done/workflows/quick.md +3 -3
- package/get-shit-done/workflows/remove-phase.md +6 -6
- package/get-shit-done/workflows/research-phase.md +2 -2
- package/get-shit-done/workflows/resume-project.md +9 -9
- package/get-shit-done/workflows/settings.md +5 -5
- package/get-shit-done/workflows/transition.md +10 -10
- package/get-shit-done/workflows/update.md +2 -2
- package/get-shit-done/workflows/verify-work.md +8 -8
- package/package.json +1 -1
- package/commands/gsd/new-project.md.bak +0 -1041
|
@@ -321,7 +321,7 @@ grep "^status:" "$PHASE_DIR"/*-VERIFICATION.md | cut -d: -f2 | tr -d ' '
|
|
|
321
321
|
|--------|--------|
|
|
322
322
|
| `passed` | → update_roadmap |
|
|
323
323
|
| `human_needed` | Present items for human testing, get approval or feedback |
|
|
324
|
-
| `gaps_found` | Present gap summary, offer
|
|
324
|
+
| `gaps_found` | Present gap summary, offer `$gsd-plan-phase {phase} --gaps` |
|
|
325
325
|
|
|
326
326
|
**If human_needed:**
|
|
327
327
|
```
|
|
@@ -347,15 +347,15 @@ All automated checks passed. {N} items need human testing:
|
|
|
347
347
|
---
|
|
348
348
|
## ▶ Next Up
|
|
349
349
|
|
|
350
|
-
|
|
350
|
+
`$gsd-plan-phase {X} --gaps`
|
|
351
351
|
|
|
352
352
|
<sub>`/clear` first → fresh context window</sub>
|
|
353
353
|
|
|
354
354
|
Also: `cat {phase_dir}/{phase_num}-VERIFICATION.md` — full report
|
|
355
|
-
Also:
|
|
355
|
+
Also: `$gsd-verify-work {X}` — manual testing first
|
|
356
356
|
```
|
|
357
357
|
|
|
358
|
-
Gap closure cycle:
|
|
358
|
+
Gap closure cycle: `$gsd-plan-phase {X} --gaps` reads VERIFICATION.md → creates gap plans with `gap_closure: true` → user runs `$gsd-execute-phase {X} --gaps-only` → verifier re-runs.
|
|
359
359
|
</step>
|
|
360
360
|
|
|
361
361
|
<step name="update_roadmap">
|
|
@@ -381,7 +381,7 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs(phase-{X}): complete
|
|
|
381
381
|
|
|
382
382
|
<step name="offer_next">
|
|
383
383
|
|
|
384
|
-
**Exception:** If `gaps_found`, the `verify_phase_goal` step already presents the gap-closure path (
|
|
384
|
+
**Exception:** If `gaps_found`, the `verify_phase_goal` step already presents the gap-closure path (`$gsd-plan-phase {X} --gaps`). No additional routing needed — skip auto-advance.
|
|
385
385
|
|
|
386
386
|
**No-transition check (spawned by auto-advance chain):**
|
|
387
387
|
|
|
@@ -429,7 +429,7 @@ Read and follow `~/.codex/get-shit-done/workflows/transition.md`, passing throug
|
|
|
429
429
|
|
|
430
430
|
**If neither `--auto` nor `AUTO_CFG` is true:**
|
|
431
431
|
|
|
432
|
-
The workflow ends. The user runs
|
|
432
|
+
The workflow ends. The user runs `$gsd-progress` or invokes the transition workflow manually.
|
|
433
433
|
</step>
|
|
434
434
|
|
|
435
435
|
</process>
|
|
@@ -447,7 +447,7 @@ Orchestrator: ~10-15% context. Subagents: fresh 200k each. No polling (Task bloc
|
|
|
447
447
|
</failure_handling>
|
|
448
448
|
|
|
449
449
|
<resumption>
|
|
450
|
-
Re-run
|
|
450
|
+
Re-run `$gsd-execute-phase {phase}` → discover_plans finds completed SUMMARYs → skips them → resumes from first incomplete plan → continues wave execution.
|
|
451
451
|
|
|
452
452
|
STATE.md tracks: last completed plan, current wave, pending checkpoints.
|
|
453
453
|
</resumption>
|
|
@@ -423,9 +423,9 @@ ls -1 .planning/phases/[current-phase-dir]/*-SUMMARY.md 2>/dev/null | wc -l
|
|
|
423
423
|
|
|
424
424
|
| Condition | Route | Action |
|
|
425
425
|
|-----------|-------|--------|
|
|
426
|
-
| summaries < plans | **A: More plans** | Find next PLAN without SUMMARY. Yolo: auto-continue. Interactive: show next plan, suggest
|
|
427
|
-
| summaries = plans, current < highest phase | **B: Phase done** | Show completion, suggest
|
|
428
|
-
| summaries = plans, current = highest phase | **C: Milestone done** | Show banner, suggest
|
|
426
|
+
| summaries < plans | **A: More plans** | Find next PLAN without SUMMARY. Yolo: auto-continue. Interactive: show next plan, suggest `$gsd-execute-phase {phase}` + `$gsd-verify-work`. STOP here. |
|
|
427
|
+
| summaries = plans, current < highest phase | **B: Phase done** | Show completion, suggest `$gsd-plan-phase {Z+1}` + `$gsd-verify-work {Z}` + `$gsd-discuss-phase {Z+1}` |
|
|
428
|
+
| summaries = plans, current = highest phase | **C: Milestone done** | Show banner, suggest `$gsd-complete-milestone` + `$gsd-verify-work` + `$gsd-add-phase` |
|
|
429
429
|
|
|
430
430
|
All routes: `/clear` first for fresh context.
|
|
431
431
|
</step>
|
|
@@ -62,10 +62,10 @@ Errors: N | Warnings: N | Info: N
|
|
|
62
62
|
## Errors
|
|
63
63
|
|
|
64
64
|
- [E001] config.json: JSON parse error at line 5
|
|
65
|
-
Fix: Run
|
|
65
|
+
Fix: Run $gsd-health --repair to reset to defaults
|
|
66
66
|
|
|
67
67
|
- [E002] PROJECT.md not found
|
|
68
|
-
Fix: Run
|
|
68
|
+
Fix: Run $gsd-new-project to create
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
**If warnings exist:**
|
|
@@ -73,7 +73,7 @@ Errors: N | Warnings: N | Info: N
|
|
|
73
73
|
## Warnings
|
|
74
74
|
|
|
75
75
|
- [W001] STATE.md references phase 5, but only phases 1-3 exist
|
|
76
|
-
Fix: Run
|
|
76
|
+
Fix: Run $gsd-health --repair to regenerate
|
|
77
77
|
|
|
78
78
|
- [W005] Phase directory "1-setup" doesn't follow NN-name format
|
|
79
79
|
Fix: Rename to match pattern (e.g., 01-setup)
|
|
@@ -90,7 +90,7 @@ Errors: N | Warnings: N | Info: N
|
|
|
90
90
|
**Footer (if repairable issues exist and --repair was NOT used):**
|
|
91
91
|
```
|
|
92
92
|
---
|
|
93
|
-
N issues can be auto-repaired. Run:
|
|
93
|
+
N issues can be auto-repaired. Run: $gsd-health --repair
|
|
94
94
|
```
|
|
95
95
|
</step>
|
|
96
96
|
|
|
@@ -100,7 +100,7 @@ N issues can be auto-repaired. Run: /gsd:health --repair
|
|
|
100
100
|
Ask user if they want to run repairs:
|
|
101
101
|
|
|
102
102
|
```
|
|
103
|
-
Would you like to run
|
|
103
|
+
Would you like to run $gsd-health --repair to fix N issues automatically?
|
|
104
104
|
```
|
|
105
105
|
|
|
106
106
|
If yes, re-run with --repair flag and display results.
|
|
@@ -9,9 +9,9 @@ Display the complete GSD command reference. Output ONLY the reference content. D
|
|
|
9
9
|
|
|
10
10
|
## Quick Start
|
|
11
11
|
|
|
12
|
-
1.
|
|
13
|
-
2.
|
|
14
|
-
3.
|
|
12
|
+
1. `$gsd-new-project` - Initialize project (includes research, requirements, roadmap)
|
|
13
|
+
2. `$gsd-plan-phase 1` - Create detailed plan for first phase
|
|
14
|
+
3. `$gsd-execute-phase 1` - Execute the phase
|
|
15
15
|
|
|
16
16
|
## Staying Updated
|
|
17
17
|
|
|
@@ -24,12 +24,12 @@ npx get-shit-done-cc@latest
|
|
|
24
24
|
## Core Workflow
|
|
25
25
|
|
|
26
26
|
```
|
|
27
|
-
|
|
27
|
+
$gsd-new-project → $gsd-plan-phase → $gsd-execute-phase → repeat
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
### Project Initialization
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
**`$gsd-new-project`**
|
|
33
33
|
Initialize new project through unified flow.
|
|
34
34
|
|
|
35
35
|
One command takes you from idea to ready-for-planning:
|
|
@@ -46,30 +46,30 @@ Creates all `.planning/` artifacts:
|
|
|
46
46
|
- `ROADMAP.md` — phases mapped to requirements
|
|
47
47
|
- `STATE.md` — project memory
|
|
48
48
|
|
|
49
|
-
Usage:
|
|
49
|
+
Usage: `$gsd-new-project`
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
**`$gsd-map-codebase`**
|
|
52
52
|
Map an existing codebase for brownfield projects.
|
|
53
53
|
|
|
54
54
|
- Analyzes codebase with parallel Explore agents
|
|
55
55
|
- Creates `.planning/codebase/` with 7 focused documents
|
|
56
56
|
- Covers stack, architecture, structure, conventions, testing, integrations, concerns
|
|
57
|
-
- Use before
|
|
57
|
+
- Use before `$gsd-new-project` on existing codebases
|
|
58
58
|
|
|
59
|
-
Usage:
|
|
59
|
+
Usage: `$gsd-map-codebase`
|
|
60
60
|
|
|
61
61
|
### Phase Planning
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
**`$gsd-discuss-phase <number>`**
|
|
64
64
|
Help articulate your vision for a phase before planning.
|
|
65
65
|
|
|
66
66
|
- Captures how you imagine this phase working
|
|
67
67
|
- Creates CONTEXT.md with your vision, essentials, and boundaries
|
|
68
68
|
- Use when you have ideas about how something should look/feel
|
|
69
69
|
|
|
70
|
-
Usage:
|
|
70
|
+
Usage: `$gsd-discuss-phase 2`
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
**`$gsd-research-phase <number>`**
|
|
73
73
|
Comprehensive ecosystem research for niche/complex domains.
|
|
74
74
|
|
|
75
75
|
- Discovers standard stack, architecture patterns, pitfalls
|
|
@@ -77,18 +77,18 @@ Comprehensive ecosystem research for niche/complex domains.
|
|
|
77
77
|
- Use for 3D, games, audio, shaders, ML, and other specialized domains
|
|
78
78
|
- Goes beyond "which library" to ecosystem knowledge
|
|
79
79
|
|
|
80
|
-
Usage:
|
|
80
|
+
Usage: `$gsd-research-phase 3`
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
**`$gsd-list-phase-assumptions <number>`**
|
|
83
83
|
See what Codex is planning to do before it starts.
|
|
84
84
|
|
|
85
85
|
- Shows Codex's intended approach for a phase
|
|
86
86
|
- Lets you course-correct if Codex misunderstood your vision
|
|
87
87
|
- No files created - conversational output only
|
|
88
88
|
|
|
89
|
-
Usage:
|
|
89
|
+
Usage: `$gsd-list-phase-assumptions 3`
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
**`$gsd-plan-phase <number>`**
|
|
92
92
|
Create detailed execution plan for a specific phase.
|
|
93
93
|
|
|
94
94
|
- Generates `.planning/phases/XX-phase-name/XX-YY-PLAN.md`
|
|
@@ -96,14 +96,14 @@ Create detailed execution plan for a specific phase.
|
|
|
96
96
|
- Includes verification criteria and success measures
|
|
97
97
|
- Multiple plans per phase supported (XX-01, XX-02, etc.)
|
|
98
98
|
|
|
99
|
-
Usage:
|
|
99
|
+
Usage: `$gsd-plan-phase 1`
|
|
100
100
|
Result: Creates `.planning/phases/01-foundation/01-01-PLAN.md`
|
|
101
101
|
|
|
102
102
|
**PRD Express Path:** Pass `--prd path/to/requirements.md` to skip discuss-phase entirely. Your PRD becomes locked decisions in CONTEXT.md. Useful when you already have clear acceptance criteria.
|
|
103
103
|
|
|
104
104
|
### Execution
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
**`$gsd-execute-phase <phase-number>`**
|
|
107
107
|
Execute all plans in a phase.
|
|
108
108
|
|
|
109
109
|
- Groups plans by wave (from frontmatter), executes waves sequentially
|
|
@@ -111,11 +111,11 @@ Execute all plans in a phase.
|
|
|
111
111
|
- Verifies phase goal after all plans complete
|
|
112
112
|
- Updates REQUIREMENTS.md, ROADMAP.md, STATE.md
|
|
113
113
|
|
|
114
|
-
Usage:
|
|
114
|
+
Usage: `$gsd-execute-phase 5`
|
|
115
115
|
|
|
116
116
|
### Quick Mode
|
|
117
117
|
|
|
118
|
-
|
|
118
|
+
**`$gsd-quick`**
|
|
119
119
|
Execute small, ad-hoc tasks with GSD guarantees but skip optional agents.
|
|
120
120
|
|
|
121
121
|
Quick mode uses the same system with a shorter path:
|
|
@@ -125,31 +125,31 @@ Quick mode uses the same system with a shorter path:
|
|
|
125
125
|
|
|
126
126
|
Use when you know exactly what to do and the task is small enough to not need research or verification.
|
|
127
127
|
|
|
128
|
-
Usage:
|
|
128
|
+
Usage: `$gsd-quick`
|
|
129
129
|
Result: Creates `.planning/quick/NNN-slug/PLAN.md`, `.planning/quick/NNN-slug/SUMMARY.md`
|
|
130
130
|
|
|
131
131
|
### Roadmap Management
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
**`$gsd-add-phase <description>`**
|
|
134
134
|
Add new phase to end of current milestone.
|
|
135
135
|
|
|
136
136
|
- Appends to ROADMAP.md
|
|
137
137
|
- Uses next sequential number
|
|
138
138
|
- Updates phase directory structure
|
|
139
139
|
|
|
140
|
-
Usage:
|
|
140
|
+
Usage: `$gsd-add-phase "Add admin dashboard"`
|
|
141
141
|
|
|
142
|
-
|
|
142
|
+
**`$gsd-insert-phase <after> <description>`**
|
|
143
143
|
Insert urgent work as decimal phase between existing phases.
|
|
144
144
|
|
|
145
145
|
- Creates intermediate phase (e.g., 7.1 between 7 and 8)
|
|
146
146
|
- Useful for discovered work that must happen mid-milestone
|
|
147
147
|
- Maintains phase ordering
|
|
148
148
|
|
|
149
|
-
Usage:
|
|
149
|
+
Usage: `$gsd-insert-phase 7 "Fix critical auth bug"`
|
|
150
150
|
Result: Creates Phase 7.1
|
|
151
151
|
|
|
152
|
-
|
|
152
|
+
**`$gsd-remove-phase <number>`**
|
|
153
153
|
Remove a future phase and renumber subsequent phases.
|
|
154
154
|
|
|
155
155
|
- Deletes phase directory and all references
|
|
@@ -157,12 +157,12 @@ Remove a future phase and renumber subsequent phases.
|
|
|
157
157
|
- Only works on future (unstarted) phases
|
|
158
158
|
- Git commit preserves historical record
|
|
159
159
|
|
|
160
|
-
Usage:
|
|
160
|
+
Usage: `$gsd-remove-phase 17`
|
|
161
161
|
Result: Phase 17 deleted, phases 18-20 become 17-19
|
|
162
162
|
|
|
163
163
|
### Milestone Management
|
|
164
164
|
|
|
165
|
-
|
|
165
|
+
**`$gsd-new-milestone <name>`**
|
|
166
166
|
Start a new milestone through unified flow.
|
|
167
167
|
|
|
168
168
|
- Deep questioning to understand what you're building next
|
|
@@ -170,11 +170,11 @@ Start a new milestone through unified flow.
|
|
|
170
170
|
- Requirements definition with scoping
|
|
171
171
|
- Roadmap creation with phase breakdown
|
|
172
172
|
|
|
173
|
-
Mirrors
|
|
173
|
+
Mirrors `$gsd-new-project` flow for brownfield projects (existing PROJECT.md).
|
|
174
174
|
|
|
175
|
-
Usage:
|
|
175
|
+
Usage: `$gsd-new-milestone "v2.0 Features"`
|
|
176
176
|
|
|
177
|
-
|
|
177
|
+
**`$gsd-complete-milestone <version>`**
|
|
178
178
|
Archive completed milestone and prepare for next version.
|
|
179
179
|
|
|
180
180
|
- Creates MILESTONES.md entry with stats
|
|
@@ -182,11 +182,11 @@ Archive completed milestone and prepare for next version.
|
|
|
182
182
|
- Creates git tag for the release
|
|
183
183
|
- Prepares workspace for next version
|
|
184
184
|
|
|
185
|
-
Usage:
|
|
185
|
+
Usage: `$gsd-complete-milestone 1.0.0`
|
|
186
186
|
|
|
187
187
|
### Progress Tracking
|
|
188
188
|
|
|
189
|
-
|
|
189
|
+
**`$gsd-progress`**
|
|
190
190
|
Check project status and intelligently route to next action.
|
|
191
191
|
|
|
192
192
|
- Shows visual progress bar and completion percentage
|
|
@@ -196,45 +196,45 @@ Check project status and intelligently route to next action.
|
|
|
196
196
|
- Offers to execute next plan or create it if missing
|
|
197
197
|
- Detects 100% milestone completion
|
|
198
198
|
|
|
199
|
-
Usage:
|
|
199
|
+
Usage: `$gsd-progress`
|
|
200
200
|
|
|
201
201
|
### Session Management
|
|
202
202
|
|
|
203
|
-
|
|
203
|
+
**`$gsd-resume-work`**
|
|
204
204
|
Resume work from previous session with full context restoration.
|
|
205
205
|
|
|
206
206
|
- Reads STATE.md for project context
|
|
207
207
|
- Shows current position and recent progress
|
|
208
208
|
- Offers next actions based on project state
|
|
209
209
|
|
|
210
|
-
Usage:
|
|
210
|
+
Usage: `$gsd-resume-work`
|
|
211
211
|
|
|
212
|
-
|
|
212
|
+
**`$gsd-pause-work`**
|
|
213
213
|
Create context handoff when pausing work mid-phase.
|
|
214
214
|
|
|
215
215
|
- Creates .continue-here file with current state
|
|
216
216
|
- Updates STATE.md session continuity section
|
|
217
217
|
- Captures in-progress work context
|
|
218
218
|
|
|
219
|
-
Usage:
|
|
219
|
+
Usage: `$gsd-pause-work`
|
|
220
220
|
|
|
221
221
|
### Debugging
|
|
222
222
|
|
|
223
|
-
|
|
223
|
+
**`$gsd-debug [issue description]`**
|
|
224
224
|
Systematic debugging with persistent state across context resets.
|
|
225
225
|
|
|
226
226
|
- Gathers symptoms through adaptive questioning
|
|
227
227
|
- Creates `.planning/debug/[slug].md` to track investigation
|
|
228
228
|
- Investigates using scientific method (evidence → hypothesis → test)
|
|
229
|
-
- Survives `/clear` — run
|
|
229
|
+
- Survives `/clear` — run `$gsd-debug` with no args to resume
|
|
230
230
|
- Archives resolved issues to `.planning/debug/resolved/`
|
|
231
231
|
|
|
232
|
-
Usage:
|
|
233
|
-
Usage:
|
|
232
|
+
Usage: `$gsd-debug "login button doesn't work"`
|
|
233
|
+
Usage: `$gsd-debug` (resume active session)
|
|
234
234
|
|
|
235
235
|
### Todo Management
|
|
236
236
|
|
|
237
|
-
|
|
237
|
+
**`$gsd-add-todo [description]`**
|
|
238
238
|
Capture idea or task as todo from current conversation.
|
|
239
239
|
|
|
240
240
|
- Extracts context from conversation (or uses provided description)
|
|
@@ -243,24 +243,24 @@ Capture idea or task as todo from current conversation.
|
|
|
243
243
|
- Checks for duplicates before creating
|
|
244
244
|
- Updates STATE.md todo count
|
|
245
245
|
|
|
246
|
-
Usage:
|
|
247
|
-
Usage:
|
|
246
|
+
Usage: `$gsd-add-todo` (infers from conversation)
|
|
247
|
+
Usage: `$gsd-add-todo Add auth token refresh`
|
|
248
248
|
|
|
249
|
-
|
|
249
|
+
**`$gsd-check-todos [area]`**
|
|
250
250
|
List pending todos and select one to work on.
|
|
251
251
|
|
|
252
252
|
- Lists all pending todos with title, area, age
|
|
253
|
-
- Optional area filter (e.g.,
|
|
253
|
+
- Optional area filter (e.g., `$gsd-check-todos api`)
|
|
254
254
|
- Loads full context for selected todo
|
|
255
255
|
- Routes to appropriate action (work now, add to phase, brainstorm)
|
|
256
256
|
- Moves todo to done/ when work begins
|
|
257
257
|
|
|
258
|
-
Usage:
|
|
259
|
-
Usage:
|
|
258
|
+
Usage: `$gsd-check-todos`
|
|
259
|
+
Usage: `$gsd-check-todos api`
|
|
260
260
|
|
|
261
261
|
### User Acceptance Testing
|
|
262
262
|
|
|
263
|
-
|
|
263
|
+
**`$gsd-verify-work [phase]`**
|
|
264
264
|
Validate built features through conversational UAT.
|
|
265
265
|
|
|
266
266
|
- Extracts testable deliverables from SUMMARY.md files
|
|
@@ -268,11 +268,11 @@ Validate built features through conversational UAT.
|
|
|
268
268
|
- Automatically diagnoses failures and creates fix plans
|
|
269
269
|
- Ready for re-execution if issues found
|
|
270
270
|
|
|
271
|
-
Usage:
|
|
271
|
+
Usage: `$gsd-verify-work 3`
|
|
272
272
|
|
|
273
273
|
### Milestone Auditing
|
|
274
274
|
|
|
275
|
-
|
|
275
|
+
**`$gsd-audit-milestone [version]`**
|
|
276
276
|
Audit milestone completion against original intent.
|
|
277
277
|
|
|
278
278
|
- Reads all phase VERIFICATION.md files
|
|
@@ -280,41 +280,41 @@ Audit milestone completion against original intent.
|
|
|
280
280
|
- Spawns integration checker for cross-phase wiring
|
|
281
281
|
- Creates MILESTONE-AUDIT.md with gaps and tech debt
|
|
282
282
|
|
|
283
|
-
Usage:
|
|
283
|
+
Usage: `$gsd-audit-milestone`
|
|
284
284
|
|
|
285
|
-
|
|
285
|
+
**`$gsd-plan-milestone-gaps`**
|
|
286
286
|
Create phases to close gaps identified by audit.
|
|
287
287
|
|
|
288
288
|
- Reads MILESTONE-AUDIT.md and groups gaps into phases
|
|
289
289
|
- Prioritizes by requirement priority (must/should/nice)
|
|
290
290
|
- Adds gap closure phases to ROADMAP.md
|
|
291
|
-
- Ready for
|
|
291
|
+
- Ready for `$gsd-plan-phase` on new phases
|
|
292
292
|
|
|
293
|
-
Usage:
|
|
293
|
+
Usage: `$gsd-plan-milestone-gaps`
|
|
294
294
|
|
|
295
295
|
### Configuration
|
|
296
296
|
|
|
297
|
-
|
|
297
|
+
**`$gsd-settings`**
|
|
298
298
|
Configure workflow toggles and model profile interactively.
|
|
299
299
|
|
|
300
300
|
- Toggle researcher, plan checker, verifier agents
|
|
301
301
|
- Select model profile (quality/balanced/budget)
|
|
302
302
|
- Updates `.planning/config.json`
|
|
303
303
|
|
|
304
|
-
Usage:
|
|
304
|
+
Usage: `$gsd-settings`
|
|
305
305
|
|
|
306
|
-
|
|
306
|
+
**`$gsd-set-profile <profile>`**
|
|
307
307
|
Quick switch model profile for GSD agents.
|
|
308
308
|
|
|
309
309
|
- `quality` — Opus everywhere except verification
|
|
310
310
|
- `balanced` — Opus for planning, Sonnet for execution (default)
|
|
311
311
|
- `budget` — Sonnet for writing, Haiku for research/verification
|
|
312
312
|
|
|
313
|
-
Usage:
|
|
313
|
+
Usage: `$gsd-set-profile budget`
|
|
314
314
|
|
|
315
315
|
### Utility Commands
|
|
316
316
|
|
|
317
|
-
|
|
317
|
+
**`$gsd-cleanup`**
|
|
318
318
|
Archive accumulated phase directories from completed milestones.
|
|
319
319
|
|
|
320
320
|
- Identifies phases from completed milestones still in `.planning/phases/`
|
|
@@ -322,12 +322,12 @@ Archive accumulated phase directories from completed milestones.
|
|
|
322
322
|
- Moves phase dirs to `.planning/milestones/v{X.Y}-phases/`
|
|
323
323
|
- Use after multiple milestones to reduce `.planning/phases/` clutter
|
|
324
324
|
|
|
325
|
-
Usage:
|
|
325
|
+
Usage: `$gsd-cleanup`
|
|
326
326
|
|
|
327
|
-
|
|
327
|
+
**`$gsd-help`**
|
|
328
328
|
Show this command reference.
|
|
329
329
|
|
|
330
|
-
|
|
330
|
+
**`$gsd-update`**
|
|
331
331
|
Update GSD to latest version with changelog preview.
|
|
332
332
|
|
|
333
333
|
- Shows installed vs latest version comparison
|
|
@@ -336,15 +336,15 @@ Update GSD to latest version with changelog preview.
|
|
|
336
336
|
- Confirms before running install
|
|
337
337
|
- Better than raw `npx get-shit-done-cc`
|
|
338
338
|
|
|
339
|
-
Usage:
|
|
339
|
+
Usage: `$gsd-update`
|
|
340
340
|
|
|
341
|
-
|
|
341
|
+
**`$gsd-join-discord`**
|
|
342
342
|
Join the GSD Discord community.
|
|
343
343
|
|
|
344
344
|
- Get help, share what you're building, stay updated
|
|
345
345
|
- Connect with other GSD users
|
|
346
346
|
|
|
347
|
-
Usage:
|
|
347
|
+
Usage: `$gsd-join-discord`
|
|
348
348
|
|
|
349
349
|
## Files & Structure
|
|
350
350
|
|
|
@@ -363,7 +363,7 @@ Usage: `/gsd:join-discord`
|
|
|
363
363
|
├── milestones/
|
|
364
364
|
│ ├── v1.0-ROADMAP.md # Archived roadmap snapshot
|
|
365
365
|
│ ├── v1.0-REQUIREMENTS.md # Archived requirements
|
|
366
|
-
│ └── v1.0-phases/ # Archived phase dirs (via
|
|
366
|
+
│ └── v1.0-phases/ # Archived phase dirs (via $gsd-cleanup or --archive-phases)
|
|
367
367
|
│ ├── 01-foundation/
|
|
368
368
|
│ └── 02-core-features/
|
|
369
369
|
├── codebase/ # Codebase map (brownfield projects)
|
|
@@ -385,7 +385,7 @@ Usage: `/gsd:join-discord`
|
|
|
385
385
|
|
|
386
386
|
## Workflow Modes
|
|
387
387
|
|
|
388
|
-
Set during
|
|
388
|
+
Set during `$gsd-new-project`:
|
|
389
389
|
|
|
390
390
|
**Interactive Mode**
|
|
391
391
|
|
|
@@ -433,51 +433,51 @@ Example config:
|
|
|
433
433
|
**Starting a new project:**
|
|
434
434
|
|
|
435
435
|
```
|
|
436
|
-
|
|
436
|
+
$gsd-new-project # Unified flow: questioning → research → requirements → roadmap
|
|
437
437
|
/clear
|
|
438
|
-
|
|
438
|
+
$gsd-plan-phase 1 # Create plans for first phase
|
|
439
439
|
/clear
|
|
440
|
-
|
|
440
|
+
$gsd-execute-phase 1 # Execute all plans in phase
|
|
441
441
|
```
|
|
442
442
|
|
|
443
443
|
**Resuming work after a break:**
|
|
444
444
|
|
|
445
445
|
```
|
|
446
|
-
|
|
446
|
+
$gsd-progress # See where you left off and continue
|
|
447
447
|
```
|
|
448
448
|
|
|
449
449
|
**Adding urgent mid-milestone work:**
|
|
450
450
|
|
|
451
451
|
```
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
452
|
+
$gsd-insert-phase 5 "Critical security fix"
|
|
453
|
+
$gsd-plan-phase 5.1
|
|
454
|
+
$gsd-execute-phase 5.1
|
|
455
455
|
```
|
|
456
456
|
|
|
457
457
|
**Completing a milestone:**
|
|
458
458
|
|
|
459
459
|
```
|
|
460
|
-
|
|
460
|
+
$gsd-complete-milestone 1.0.0
|
|
461
461
|
/clear
|
|
462
|
-
|
|
462
|
+
$gsd-new-milestone # Start next milestone (questioning → research → requirements → roadmap)
|
|
463
463
|
```
|
|
464
464
|
|
|
465
465
|
**Capturing ideas during work:**
|
|
466
466
|
|
|
467
467
|
```
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
468
|
+
$gsd-add-todo # Capture from conversation context
|
|
469
|
+
$gsd-add-todo Fix modal z-index # Capture with explicit description
|
|
470
|
+
$gsd-check-todos # Review and work on todos
|
|
471
|
+
$gsd-check-todos api # Filter by area
|
|
472
472
|
```
|
|
473
473
|
|
|
474
474
|
**Debugging an issue:**
|
|
475
475
|
|
|
476
476
|
```
|
|
477
|
-
|
|
477
|
+
$gsd-debug "form submission fails silently" # Start debug session
|
|
478
478
|
# ... investigation happens, context fills up ...
|
|
479
479
|
/clear
|
|
480
|
-
|
|
480
|
+
$gsd-debug # Resume from where you left off
|
|
481
481
|
```
|
|
482
482
|
|
|
483
483
|
## Getting Help
|
|
@@ -485,5 +485,5 @@ Example config:
|
|
|
485
485
|
- Read `.planning/PROJECT.md` for project vision
|
|
486
486
|
- Read `.planning/STATE.md` for current context
|
|
487
487
|
- Check `.planning/ROADMAP.md` for phase status
|
|
488
|
-
- Run
|
|
488
|
+
- Run `$gsd-progress` to check where you're up to
|
|
489
489
|
</reference>
|
|
@@ -13,7 +13,7 @@ Parse the command arguments:
|
|
|
13
13
|
- First argument: integer phase number to insert after
|
|
14
14
|
- Remaining arguments: phase description
|
|
15
15
|
|
|
16
|
-
Example:
|
|
16
|
+
Example: `$gsd-insert-phase 72 Fix critical auth bug`
|
|
17
17
|
-> after = 72
|
|
18
18
|
-> description = "Fix critical auth bug"
|
|
19
19
|
|
|
@@ -21,8 +21,8 @@ If arguments missing:
|
|
|
21
21
|
|
|
22
22
|
```
|
|
23
23
|
ERROR: Both phase number and description required
|
|
24
|
-
Usage:
|
|
25
|
-
Example:
|
|
24
|
+
Usage: $gsd-insert-phase <after> <description>
|
|
25
|
+
Example: $gsd-insert-phase 72 Fix critical auth bug
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Exit.
|
|
@@ -92,7 +92,7 @@ Project state updated: .planning/STATE.md
|
|
|
92
92
|
|
|
93
93
|
**Phase {decimal_phase}: {description}** -- urgent insertion
|
|
94
94
|
|
|
95
|
-
|
|
95
|
+
`$gsd-plan-phase {decimal_phase}`
|
|
96
96
|
|
|
97
97
|
<sub>`/clear` first -> fresh context window</sub>
|
|
98
98
|
|
|
@@ -110,11 +110,11 @@ Project state updated: .planning/STATE.md
|
|
|
110
110
|
|
|
111
111
|
<anti_patterns>
|
|
112
112
|
|
|
113
|
-
- Don't use this for planned work at end of milestone (use
|
|
113
|
+
- Don't use this for planned work at end of milestone (use $gsd-add-phase)
|
|
114
114
|
- Don't insert before Phase 1 (decimal 0.1 makes no sense)
|
|
115
115
|
- Don't renumber existing phases
|
|
116
116
|
- Don't modify the target phase content
|
|
117
|
-
- Don't create plans yet (that's
|
|
117
|
+
- Don't create plans yet (that's $gsd-plan-phase)
|
|
118
118
|
- Don't commit changes (user decides when to commit)
|
|
119
119
|
</anti_patterns>
|
|
120
120
|
|
|
@@ -14,8 +14,8 @@ Phase number: $ARGUMENTS (required)
|
|
|
14
14
|
```
|
|
15
15
|
Error: Phase number required.
|
|
16
16
|
|
|
17
|
-
Usage:
|
|
18
|
-
Example:
|
|
17
|
+
Usage: $gsd-list-phase-assumptions [phase-number]
|
|
18
|
+
Example: $gsd-list-phase-assumptions 3
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
Exit workflow.
|
|
@@ -153,8 +153,8 @@ Present next steps:
|
|
|
153
153
|
|
|
154
154
|
```
|
|
155
155
|
What's next?
|
|
156
|
-
1. Discuss context (
|
|
157
|
-
2. Plan this phase (
|
|
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
|
```
|
|
@@ -285,14 +285,14 @@ Created .planning/codebase/:
|
|
|
285
285
|
|
|
286
286
|
**Initialize project** — use codebase context for planning
|
|
287
287
|
|
|
288
|
-
|
|
288
|
+
`$gsd-new-project`
|
|
289
289
|
|
|
290
290
|
<sub>`/clear` first → fresh context window</sub>
|
|
291
291
|
|
|
292
292
|
---
|
|
293
293
|
|
|
294
294
|
**Also available:**
|
|
295
|
-
- Re-run mapping:
|
|
295
|
+
- Re-run mapping: `$gsd-map-codebase`
|
|
296
296
|
- Review specific file: `cat .planning/codebase/STACK.md`
|
|
297
297
|
- Edit any document before proceeding
|
|
298
298
|
|