@undeemed/get-shit-done-codex 1.20.10 → 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/.codex/config.toml +77 -0
- package/README.md +53 -42
- 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 +161 -208
- 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/{AGENTS.md → get-shit-done/AGENTS.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 +2 -2
- package/commands/gsd/new-project.md.bak +0 -1041
|
@@ -17,7 +17,7 @@ Read all files referenced by the invoking prompt's execution_context before star
|
|
|
17
17
|
- Read PROJECT.md (existing project, validated requirements, decisions)
|
|
18
18
|
- Read MILESTONES.md (what shipped previously)
|
|
19
19
|
- Read STATE.md (pending todos, blockers)
|
|
20
|
-
- Check for MILESTONE-CONTEXT.md (from
|
|
20
|
+
- Check for MILESTONE-CONTEXT.md (from $gsd-discuss-milestone)
|
|
21
21
|
|
|
22
22
|
## 2. Gather Milestone Goals
|
|
23
23
|
|
|
@@ -88,7 +88,7 @@ AskUserQuestion: "Research the domain ecosystem for new features before defining
|
|
|
88
88
|
- "Research first (Recommended)" — Discover patterns, features, architecture for NEW capabilities
|
|
89
89
|
- "Skip research" — Go straight to requirements
|
|
90
90
|
|
|
91
|
-
**Persist choice to config** (so future
|
|
91
|
+
**Persist choice to config** (so future `$gsd-plan-phase` honors it):
|
|
92
92
|
|
|
93
93
|
```bash
|
|
94
94
|
# If "Research first": persist true
|
|
@@ -355,11 +355,11 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs: create milestone v[X
|
|
|
355
355
|
|
|
356
356
|
**Phase [N]: [Phase Name]** — [Goal]
|
|
357
357
|
|
|
358
|
-
|
|
358
|
+
`$gsd-discuss-phase [N]` — gather context and clarify approach
|
|
359
359
|
|
|
360
360
|
<sub>`/clear` first → fresh context window</sub>
|
|
361
361
|
|
|
362
|
-
Also:
|
|
362
|
+
Also: `$gsd-plan-phase [N]` — skip discussion, plan directly
|
|
363
363
|
```
|
|
364
364
|
|
|
365
365
|
</process>
|
|
@@ -376,7 +376,7 @@ Also: `/gsd:plan-phase [N]` — skip discussion, plan directly
|
|
|
376
376
|
- [ ] User feedback incorporated (if any)
|
|
377
377
|
- [ ] ROADMAP.md phases continue from previous milestone
|
|
378
378
|
- [ ] All commits made (if planning docs committed)
|
|
379
|
-
- [ ] User knows next step:
|
|
379
|
+
- [ ] User knows next step: `$gsd-discuss-phase [N]`
|
|
380
380
|
|
|
381
381
|
**Atomic commits:** Each phase commits its artifacts immediately.
|
|
382
382
|
</success_criteria>
|
|
@@ -23,7 +23,7 @@ Check if `--auto` flag is present in $ARGUMENTS.
|
|
|
23
23
|
|
|
24
24
|
**Document requirement:**
|
|
25
25
|
Auto mode requires an idea document — either:
|
|
26
|
-
- File reference:
|
|
26
|
+
- File reference: `$gsd-new-project --auto @prd.md`
|
|
27
27
|
- Pasted/written text in the prompt
|
|
28
28
|
|
|
29
29
|
If no document content provided, error:
|
|
@@ -32,8 +32,8 @@ If no document content provided, error:
|
|
|
32
32
|
Error: --auto requires an idea document.
|
|
33
33
|
|
|
34
34
|
Usage:
|
|
35
|
-
|
|
36
|
-
|
|
35
|
+
$gsd-new-project --auto @your-idea.md
|
|
36
|
+
$gsd-new-project --auto [paste or write your idea here]
|
|
37
37
|
|
|
38
38
|
The document should describe what you want to build.
|
|
39
39
|
```
|
|
@@ -51,7 +51,7 @@ INIT=$(node ~/.codex/get-shit-done/bin/gsd-tools.cjs init new-project)
|
|
|
51
51
|
|
|
52
52
|
Parse JSON for: `researcher_model`, `synthesizer_model`, `roadmapper_model`, `commit_docs`, `project_exists`, `has_codebase_map`, `planning_exists`, `has_existing_code`, `has_package_file`, `is_brownfield`, `needs_codebase_map`, `has_git`, `project_path`.
|
|
53
53
|
|
|
54
|
-
**If `project_exists` is true:** Error — project already initialized. Use
|
|
54
|
+
**If `project_exists` is true:** Error — project already initialized. Use `$gsd-progress`.
|
|
55
55
|
|
|
56
56
|
**If `has_git` is false:** Initialize git:
|
|
57
57
|
```bash
|
|
@@ -68,12 +68,12 @@ Use AskUserQuestion:
|
|
|
68
68
|
- header: "Codebase"
|
|
69
69
|
- question: "I detected existing code in this directory. Would you like to map the codebase first?"
|
|
70
70
|
- options:
|
|
71
|
-
- "Map codebase first" — Run
|
|
71
|
+
- "Map codebase first" — Run $gsd-map-codebase to understand existing architecture (Recommended)
|
|
72
72
|
- "Skip mapping" — Proceed with project initialization
|
|
73
73
|
|
|
74
74
|
**If "Map codebase first":**
|
|
75
75
|
```
|
|
76
|
-
Run
|
|
76
|
+
Run `$gsd-map-codebase` first, then return to `$gsd-new-project`
|
|
77
77
|
```
|
|
78
78
|
Exit command.
|
|
79
79
|
|
|
@@ -493,7 +493,7 @@ Create `.planning/config.json` with all settings:
|
|
|
493
493
|
node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "chore: add project config" --files .planning/config.json
|
|
494
494
|
```
|
|
495
495
|
|
|
496
|
-
**Note:** Run
|
|
496
|
+
**Note:** Run `$gsd-settings` anytime to update these preferences.
|
|
497
497
|
|
|
498
498
|
## 5.5. Resolve Model Profile
|
|
499
499
|
|
|
@@ -1050,7 +1050,7 @@ Present completion summary:
|
|
|
1050
1050
|
╚══════════════════════════════════════════╝
|
|
1051
1051
|
```
|
|
1052
1052
|
|
|
1053
|
-
Exit skill and invoke SlashCommand("
|
|
1053
|
+
Exit skill and invoke SlashCommand("$gsd-discuss-phase 1 --auto")
|
|
1054
1054
|
|
|
1055
1055
|
**If interactive mode:**
|
|
1056
1056
|
|
|
@@ -1061,14 +1061,14 @@ Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
|
|
|
1061
1061
|
|
|
1062
1062
|
**Phase 1: [Phase Name]** — [Goal from ROADMAP.md]
|
|
1063
1063
|
|
|
1064
|
-
|
|
1064
|
+
$gsd-discuss-phase 1 — gather context and clarify approach
|
|
1065
1065
|
|
|
1066
1066
|
<sub>/clear first → fresh context window</sub>
|
|
1067
1067
|
|
|
1068
1068
|
---
|
|
1069
1069
|
|
|
1070
1070
|
**Also available:**
|
|
1071
|
-
-
|
|
1071
|
+
- $gsd-plan-phase 1 — skip discussion, plan directly
|
|
1072
1072
|
|
|
1073
1073
|
───────────────────────────────────────────────────────────────
|
|
1074
1074
|
```
|
|
@@ -1109,7 +1109,7 @@ Exit skill and invoke SlashCommand("/gsd:discuss-phase 1 --auto")
|
|
|
1109
1109
|
- [ ] ROADMAP.md created with phases, requirement mappings, success criteria
|
|
1110
1110
|
- [ ] STATE.md initialized
|
|
1111
1111
|
- [ ] REQUIREMENTS.md traceability updated
|
|
1112
|
-
- [ ] User knows next step is
|
|
1112
|
+
- [ ] User knows next step is `$gsd-discuss-phase 1`
|
|
1113
1113
|
|
|
1114
1114
|
**Atomic commits:** Each phase commits its artifacts immediately. If context is lost, artifacts persist.
|
|
1115
1115
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Create all phases necessary to close gaps identified by
|
|
2
|
+
Create all phases necessary to close gaps identified by `$gsd-audit-milestone`. Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase. One command creates all fix phases — no manual `$gsd-add-phase` per gap.
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
@@ -22,7 +22,7 @@ Parse YAML frontmatter to extract structured gaps:
|
|
|
22
22
|
|
|
23
23
|
If no audit file exists or has no gaps, error:
|
|
24
24
|
```
|
|
25
|
-
No audit gaps found. Run
|
|
25
|
+
No audit gaps found. Run `$gsd-audit-milestone` first.
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
## 2. Prioritize Gaps
|
|
@@ -164,22 +164,22 @@ node ~/.codex/get-shit-done/bin/gsd-tools.cjs commit "docs(roadmap): add gap clo
|
|
|
164
164
|
|
|
165
165
|
**Plan first gap closure phase**
|
|
166
166
|
|
|
167
|
-
|
|
167
|
+
`$gsd-plan-phase {N}`
|
|
168
168
|
|
|
169
169
|
<sub>`/clear` first → fresh context window</sub>
|
|
170
170
|
|
|
171
171
|
---
|
|
172
172
|
|
|
173
173
|
**Also available:**
|
|
174
|
-
-
|
|
174
|
+
- `$gsd-execute-phase {N}` — if plans already exist
|
|
175
175
|
- `cat .planning/ROADMAP.md` — see updated roadmap
|
|
176
176
|
|
|
177
177
|
---
|
|
178
178
|
|
|
179
179
|
**After all gap phases complete:**
|
|
180
180
|
|
|
181
|
-
|
|
182
|
-
|
|
181
|
+
`$gsd-audit-milestone` — re-audit to verify gaps closed
|
|
182
|
+
`$gsd-complete-milestone {version}` — archive when audit passes
|
|
183
183
|
```
|
|
184
184
|
|
|
185
185
|
</process>
|
|
@@ -270,5 +270,5 @@ becomes:
|
|
|
270
270
|
- [ ] Coverage count updated in REQUIREMENTS.md
|
|
271
271
|
- [ ] Phase directories created
|
|
272
272
|
- [ ] Changes committed (includes REQUIREMENTS.md)
|
|
273
|
-
- [ ] User knows to run
|
|
273
|
+
- [ ] User knows to run `$gsd-plan-phase` next
|
|
274
274
|
</success_criteria>
|
|
@@ -22,7 +22,7 @@ Parse JSON for: `researcher_model`, `planner_model`, `checker_model`, `research_
|
|
|
22
22
|
|
|
23
23
|
**File paths (for <files_to_read> blocks):** `state_path`, `roadmap_path`, `requirements_path`, `context_path`, `research_path`, `verification_path`, `uat_path`. These are null if files don't exist.
|
|
24
24
|
|
|
25
|
-
**If `planning_exists` is false:** Error — run
|
|
25
|
+
**If `planning_exists` is false:** Error — run `$gsd-new-project` first.
|
|
26
26
|
|
|
27
27
|
## 2. Parse and Normalize Arguments
|
|
28
28
|
|
|
@@ -61,7 +61,7 @@ Use AskUserQuestion:
|
|
|
61
61
|
- "Run discuss-phase first" — Capture design decisions before planning
|
|
62
62
|
|
|
63
63
|
If "Continue without context": Proceed to step 5.
|
|
64
|
-
If "Run discuss-phase first": Display
|
|
64
|
+
If "Run discuss-phase first": Display `$gsd-discuss-phase {X}` and exit workflow.
|
|
65
65
|
|
|
66
66
|
## 5. Handle Research
|
|
67
67
|
|
|
@@ -96,7 +96,7 @@ Answer: "What do I need to know to PLAN this phase well?"
|
|
|
96
96
|
</objective>
|
|
97
97
|
|
|
98
98
|
<files_to_read>
|
|
99
|
-
- {context_path} (USER DECISIONS from
|
|
99
|
+
- {context_path} (USER DECISIONS from $gsd-discuss-phase)
|
|
100
100
|
- {requirements_path} (Project requirements)
|
|
101
101
|
- {state_path} (Project decisions and history)
|
|
102
102
|
</files_to_read>
|
|
@@ -197,7 +197,7 @@ Planner prompt:
|
|
|
197
197
|
- {state_path} (Project State)
|
|
198
198
|
- {roadmap_path} (Roadmap)
|
|
199
199
|
- {requirements_path} (Requirements)
|
|
200
|
-
- {context_path} (USER DECISIONS from
|
|
200
|
+
- {context_path} (USER DECISIONS from $gsd-discuss-phase)
|
|
201
201
|
- {research_path} (Technical Research)
|
|
202
202
|
- {verification_path} (Verification Gaps - if --gaps)
|
|
203
203
|
- {uat_path} (UAT Gaps - if --gaps)
|
|
@@ -210,7 +210,7 @@ Planner prompt:
|
|
|
210
210
|
</planning_context>
|
|
211
211
|
|
|
212
212
|
<downstream_consumer>
|
|
213
|
-
Output consumed by
|
|
213
|
+
Output consumed by $gsd-execute-phase. Plans need:
|
|
214
214
|
- Frontmatter (wave, depends_on, files_modified, autonomous)
|
|
215
215
|
- Tasks in XML format
|
|
216
216
|
- Verification criteria
|
|
@@ -264,7 +264,7 @@ Checker prompt:
|
|
|
264
264
|
- {PHASE_DIR}/*-PLAN.md (Plans to verify)
|
|
265
265
|
- {roadmap_path} (Roadmap)
|
|
266
266
|
- {requirements_path} (Requirements)
|
|
267
|
-
- {context_path} (USER DECISIONS from
|
|
267
|
+
- {context_path} (USER DECISIONS from $gsd-discuss-phase)
|
|
268
268
|
- {research_path} (Technical Research — includes Validation Architecture)
|
|
269
269
|
</files_to_read>
|
|
270
270
|
|
|
@@ -311,7 +311,7 @@ Revision prompt:
|
|
|
311
311
|
|
|
312
312
|
<files_to_read>
|
|
313
313
|
- {PHASE_DIR}/*-PLAN.md (Existing plans)
|
|
314
|
-
- {context_path} (USER DECISIONS from
|
|
314
|
+
- {context_path} (USER DECISIONS from $gsd-discuss-phase)
|
|
315
315
|
</files_to_read>
|
|
316
316
|
|
|
317
317
|
**Checker issues:** {structured_issues_from_checker}
|
|
@@ -393,7 +393,7 @@ Task(
|
|
|
393
393
|
4. When spawning executor agents, use subagent_type='gsd-executor' with the existing @file pattern from the workflow
|
|
394
394
|
5. When spawning verifier agents, use subagent_type='gsd-verifier'
|
|
395
395
|
6. Preserve the classifyHandoffIfNeeded workaround (spot-check on that specific error)
|
|
396
|
-
7. Do NOT use the Skill tool or
|
|
396
|
+
7. Do NOT use the Skill tool or $gsd- commands
|
|
397
397
|
</instructions>
|
|
398
398
|
",
|
|
399
399
|
subagent_type="general-purpose",
|
|
@@ -410,14 +410,14 @@ Task(
|
|
|
410
410
|
|
|
411
411
|
Auto-advance pipeline finished.
|
|
412
412
|
|
|
413
|
-
Next:
|
|
413
|
+
Next: $gsd-discuss-phase ${NEXT_PHASE} --auto
|
|
414
414
|
```
|
|
415
415
|
- **GAPS FOUND / VERIFICATION FAILED** → Display result, stop chain:
|
|
416
416
|
```
|
|
417
417
|
Auto-advance stopped: Execution needs review.
|
|
418
418
|
|
|
419
419
|
Review the output above and continue manually:
|
|
420
|
-
|
|
420
|
+
$gsd-execute-phase ${PHASE}
|
|
421
421
|
```
|
|
422
422
|
|
|
423
423
|
**If neither `--auto` nor config enabled:**
|
|
@@ -448,7 +448,7 @@ Verification: {Passed | Passed with override | Skipped}
|
|
|
448
448
|
|
|
449
449
|
**Execute Phase {X}** — run all {N} plans
|
|
450
450
|
|
|
451
|
-
|
|
451
|
+
$gsd-execute-phase {X}
|
|
452
452
|
|
|
453
453
|
<sub>/clear first → fresh context window</sub>
|
|
454
454
|
|
|
@@ -456,7 +456,7 @@ Verification: {Passed | Passed with override | Skipped}
|
|
|
456
456
|
|
|
457
457
|
**Also available:**
|
|
458
458
|
- cat .planning/phases/{phase-dir}/*-PLAN.md — review plans
|
|
459
|
-
-
|
|
459
|
+
- $gsd-plan-phase {X} --research — re-research first
|
|
460
460
|
|
|
461
461
|
───────────────────────────────────────────────────────────────
|
|
462
462
|
</offer_next>
|
|
@@ -22,18 +22,18 @@ If `project_exists` is false (no `.planning/` directory):
|
|
|
22
22
|
```
|
|
23
23
|
No planning structure found.
|
|
24
24
|
|
|
25
|
-
Run
|
|
25
|
+
Run $gsd-new-project to start a new project.
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Exit.
|
|
29
29
|
|
|
30
|
-
If missing STATE.md: suggest
|
|
30
|
+
If missing STATE.md: suggest `$gsd-new-project`.
|
|
31
31
|
|
|
32
32
|
**If ROADMAP.md missing but PROJECT.md exists:**
|
|
33
33
|
|
|
34
34
|
This means a milestone was completed and archived. Go to **Route F** (between milestones).
|
|
35
35
|
|
|
36
|
-
If missing both ROADMAP.md and PROJECT.md: suggest
|
|
36
|
+
If missing both ROADMAP.md and PROJECT.md: suggest `$gsd-new-project`.
|
|
37
37
|
</step>
|
|
38
38
|
|
|
39
39
|
<step name="load">
|
|
@@ -117,10 +117,10 @@ CONTEXT: [✓ if has_context | - if not]
|
|
|
117
117
|
- [e.g. jq -r '.blockers[].text' from state-snapshot]
|
|
118
118
|
|
|
119
119
|
## Pending Todos
|
|
120
|
-
- [count] pending —
|
|
120
|
+
- [count] pending — $gsd-check-todos to review
|
|
121
121
|
|
|
122
122
|
## Active Debug Sessions
|
|
123
|
-
- [count] active —
|
|
123
|
+
- [count] active — $gsd-debug to continue
|
|
124
124
|
(Only show this section if count > 0)
|
|
125
125
|
|
|
126
126
|
## What's Next
|
|
@@ -179,7 +179,7 @@ Read its `<objective>` section.
|
|
|
179
179
|
|
|
180
180
|
**{phase}-{plan}: [Plan Name]** — [objective summary from PLAN.md]
|
|
181
181
|
|
|
182
|
-
|
|
182
|
+
`$gsd-execute-phase {phase}`
|
|
183
183
|
|
|
184
184
|
<sub>`/clear` first → fresh context window</sub>
|
|
185
185
|
|
|
@@ -202,7 +202,7 @@ Check if `{phase_num}-CONTEXT.md` exists in phase directory.
|
|
|
202
202
|
**Phase {N}: {Name}** — {Goal from ROADMAP.md}
|
|
203
203
|
<sub>✓ Context gathered, ready to plan</sub>
|
|
204
204
|
|
|
205
|
-
|
|
205
|
+
`$gsd-plan-phase {phase-number}`
|
|
206
206
|
|
|
207
207
|
<sub>`/clear` first → fresh context window</sub>
|
|
208
208
|
|
|
@@ -218,15 +218,15 @@ Check if `{phase_num}-CONTEXT.md` exists in phase directory.
|
|
|
218
218
|
|
|
219
219
|
**Phase {N}: {Name}** — {Goal from ROADMAP.md}
|
|
220
220
|
|
|
221
|
-
|
|
221
|
+
`$gsd-discuss-phase {phase}` — gather context and clarify approach
|
|
222
222
|
|
|
223
223
|
<sub>`/clear` first → fresh context window</sub>
|
|
224
224
|
|
|
225
225
|
---
|
|
226
226
|
|
|
227
227
|
**Also available:**
|
|
228
|
-
-
|
|
229
|
-
-
|
|
228
|
+
- `$gsd-plan-phase {phase}` — skip discussion, plan directly
|
|
229
|
+
- `$gsd-list-phase-assumptions {phase}` — see Codex's assumptions
|
|
230
230
|
|
|
231
231
|
---
|
|
232
232
|
```
|
|
@@ -244,15 +244,15 @@ UAT.md exists with gaps (diagnosed issues). User needs to plan fixes.
|
|
|
244
244
|
|
|
245
245
|
**{phase_num}-UAT.md** has {N} gaps requiring fixes.
|
|
246
246
|
|
|
247
|
-
|
|
247
|
+
`$gsd-plan-phase {phase} --gaps`
|
|
248
248
|
|
|
249
249
|
<sub>`/clear` first → fresh context window</sub>
|
|
250
250
|
|
|
251
251
|
---
|
|
252
252
|
|
|
253
253
|
**Also available:**
|
|
254
|
-
-
|
|
255
|
-
-
|
|
254
|
+
- `$gsd-execute-phase {phase}` — execute phase plans
|
|
255
|
+
- `$gsd-verify-work {phase}` — run more UAT testing
|
|
256
256
|
|
|
257
257
|
---
|
|
258
258
|
```
|
|
@@ -291,15 +291,15 @@ Read ROADMAP.md to get the next phase's name and goal.
|
|
|
291
291
|
|
|
292
292
|
**Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
|
|
293
293
|
|
|
294
|
-
|
|
294
|
+
`$gsd-discuss-phase {Z+1}` — gather context and clarify approach
|
|
295
295
|
|
|
296
296
|
<sub>`/clear` first → fresh context window</sub>
|
|
297
297
|
|
|
298
298
|
---
|
|
299
299
|
|
|
300
300
|
**Also available:**
|
|
301
|
-
-
|
|
302
|
-
-
|
|
301
|
+
- `$gsd-plan-phase {Z+1}` — skip discussion, plan directly
|
|
302
|
+
- `$gsd-verify-work {Z}` — user acceptance test before continuing
|
|
303
303
|
|
|
304
304
|
---
|
|
305
305
|
```
|
|
@@ -319,14 +319,14 @@ All {N} phases finished!
|
|
|
319
319
|
|
|
320
320
|
**Complete Milestone** — archive and prepare for next
|
|
321
321
|
|
|
322
|
-
|
|
322
|
+
`$gsd-complete-milestone`
|
|
323
323
|
|
|
324
324
|
<sub>`/clear` first → fresh context window</sub>
|
|
325
325
|
|
|
326
326
|
---
|
|
327
327
|
|
|
328
328
|
**Also available:**
|
|
329
|
-
-
|
|
329
|
+
- `$gsd-verify-work` — user acceptance test before completing milestone
|
|
330
330
|
|
|
331
331
|
---
|
|
332
332
|
```
|
|
@@ -350,7 +350,7 @@ Ready to plan the next milestone.
|
|
|
350
350
|
|
|
351
351
|
**Start Next Milestone** — questioning → research → requirements → roadmap
|
|
352
352
|
|
|
353
|
-
|
|
353
|
+
`$gsd-new-milestone`
|
|
354
354
|
|
|
355
355
|
<sub>`/clear` first → fresh context window</sub>
|
|
356
356
|
|
|
@@ -362,10 +362,10 @@ Ready to plan the next milestone.
|
|
|
362
362
|
<step name="edge_cases">
|
|
363
363
|
**Handle edge cases:**
|
|
364
364
|
|
|
365
|
-
- Phase complete but next phase not planned → offer
|
|
365
|
+
- Phase complete but next phase not planned → offer `$gsd-plan-phase [next]`
|
|
366
366
|
- All work complete → offer milestone completion
|
|
367
367
|
- Blockers present → highlight before offering to continue
|
|
368
|
-
- Handoff file exists → mention it, offer
|
|
368
|
+
- Handoff file exists → mention it, offer `$gsd-resume-work`
|
|
369
369
|
</step>
|
|
370
370
|
|
|
371
371
|
</process>
|
|
@@ -375,7 +375,7 @@ Ready to plan the next milestone.
|
|
|
375
375
|
- [ ] Rich context provided (recent work, decisions, issues)
|
|
376
376
|
- [ ] Current position clear with visual progress
|
|
377
377
|
- [ ] What's next clearly explained
|
|
378
|
-
- [ ] Smart routing:
|
|
378
|
+
- [ ] Smart routing: $gsd-execute-phase if plans exist, $gsd-plan-phase if not
|
|
379
379
|
- [ ] User confirms before any action
|
|
380
380
|
- [ ] Seamless handoff to appropriate gsd command
|
|
381
381
|
</success_criteria>
|
|
@@ -48,7 +48,7 @@ INIT=$(node ~/.codex/get-shit-done/bin/gsd-tools.cjs init quick "$DESCRIPTION")
|
|
|
48
48
|
|
|
49
49
|
Parse JSON for: `planner_model`, `executor_model`, `checker_model`, `verifier_model`, `commit_docs`, `next_num`, `slug`, `date`, `timestamp`, `quick_dir`, `task_dir`, `roadmap_exists`, `planning_exists`.
|
|
50
50
|
|
|
51
|
-
**If `roadmap_exists` is false:** Error — Quick mode requires an active project with ROADMAP.md. Run
|
|
51
|
+
**If `roadmap_exists` is false:** Error — Quick mode requires an active project with ROADMAP.md. Run `$gsd-new-project` first.
|
|
52
52
|
|
|
53
53
|
Quick tasks can run mid-phase - validation only checks ROADMAP.md exists, not phase status.
|
|
54
54
|
|
|
@@ -416,7 +416,7 @@ Commit: ${commit_hash}
|
|
|
416
416
|
|
|
417
417
|
---
|
|
418
418
|
|
|
419
|
-
Ready for next task:
|
|
419
|
+
Ready for next task: $gsd-quick
|
|
420
420
|
```
|
|
421
421
|
|
|
422
422
|
**If NOT `$FULL_MODE`:**
|
|
@@ -432,7 +432,7 @@ Commit: ${commit_hash}
|
|
|
432
432
|
|
|
433
433
|
---
|
|
434
434
|
|
|
435
|
-
Ready for next task:
|
|
435
|
+
Ready for next task: $gsd-quick
|
|
436
436
|
```
|
|
437
437
|
|
|
438
438
|
</process>
|
|
@@ -11,15 +11,15 @@ Read all files referenced by the invoking prompt's execution_context before star
|
|
|
11
11
|
<step name="parse_arguments">
|
|
12
12
|
Parse the command arguments:
|
|
13
13
|
- Argument is the phase number to remove (integer or decimal)
|
|
14
|
-
- Example:
|
|
15
|
-
- Example:
|
|
14
|
+
- Example: `$gsd-remove-phase 17` → phase = 17
|
|
15
|
+
- Example: `$gsd-remove-phase 16.1` → phase = 16.1
|
|
16
16
|
|
|
17
17
|
If no argument provided:
|
|
18
18
|
|
|
19
19
|
```
|
|
20
20
|
ERROR: Phase number required
|
|
21
|
-
Usage:
|
|
22
|
-
Example:
|
|
21
|
+
Usage: $gsd-remove-phase <phase-number>
|
|
22
|
+
Example: $gsd-remove-phase 17
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
Exit.
|
|
@@ -52,7 +52,7 @@ Only future phases can be removed:
|
|
|
52
52
|
- Current phase: {current}
|
|
53
53
|
- Phase {target} is current or completed
|
|
54
54
|
|
|
55
|
-
To abandon current work, use
|
|
55
|
+
To abandon current work, use $gsd-pause-work instead.
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
Exit.
|
|
@@ -125,7 +125,7 @@ Changes:
|
|
|
125
125
|
## What's Next
|
|
126
126
|
|
|
127
127
|
Would you like to:
|
|
128
|
-
-
|
|
128
|
+
- `$gsd-progress` — see updated roadmap status
|
|
129
129
|
- Continue with current phase
|
|
130
130
|
- Review roadmap
|
|
131
131
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<purpose>
|
|
2
2
|
Research how to implement a phase. Spawns gsd-phase-researcher with phase context.
|
|
3
3
|
|
|
4
|
-
Standalone research command. For most workflows, use
|
|
4
|
+
Standalone research command. For most workflows, use `$gsd-plan-phase` which integrates research automatically.
|
|
5
5
|
</purpose>
|
|
6
6
|
|
|
7
7
|
<process>
|
|
@@ -47,7 +47,7 @@ Research implementation approach for Phase {phase}: {name}
|
|
|
47
47
|
</objective>
|
|
48
48
|
|
|
49
49
|
<files_to_read>
|
|
50
|
-
- {context_path} (USER DECISIONS from
|
|
50
|
+
- {context_path} (USER DECISIONS from $gsd-discuss-phase)
|
|
51
51
|
- {requirements_path} (Project requirements)
|
|
52
52
|
- {state_path} (Project decisions and history)
|
|
53
53
|
</files_to_read>
|
|
@@ -27,7 +27,7 @@ Parse JSON for: `state_exists`, `roadmap_exists`, `project_exists`, `planning_ex
|
|
|
27
27
|
|
|
28
28
|
**If `state_exists` is true:** Proceed to load_state
|
|
29
29
|
**If `state_exists` is false but `roadmap_exists` or `project_exists` is true:** Offer to reconstruct STATE.md
|
|
30
|
-
**If `planning_exists` is false:** This is a new project - route to
|
|
30
|
+
**If `planning_exists` is false:** This is a new project - route to $gsd-new-project
|
|
31
31
|
</step>
|
|
32
32
|
|
|
33
33
|
<step name="load_state">
|
|
@@ -124,7 +124,7 @@ Present complete project status to user:
|
|
|
124
124
|
Resume with: Task tool (resume parameter with agent ID)
|
|
125
125
|
|
|
126
126
|
[If pending todos exist:]
|
|
127
|
-
📋 [N] pending todos —
|
|
127
|
+
📋 [N] pending todos — $gsd-check-todos to review
|
|
128
128
|
|
|
129
129
|
[If blockers exist:]
|
|
130
130
|
⚠️ Carried concerns:
|
|
@@ -180,11 +180,11 @@ What would you like to do?
|
|
|
180
180
|
[Primary action based on state - e.g.:]
|
|
181
181
|
1. Resume interrupted agent [if interrupted agent found]
|
|
182
182
|
OR
|
|
183
|
-
1. Execute phase (
|
|
183
|
+
1. Execute phase ($gsd-execute-phase {phase})
|
|
184
184
|
OR
|
|
185
|
-
1. Discuss Phase 3 context (
|
|
185
|
+
1. Discuss Phase 3 context ($gsd-discuss-phase 3) [if CONTEXT.md missing]
|
|
186
186
|
OR
|
|
187
|
-
1. Plan Phase 3 (
|
|
187
|
+
1. Plan Phase 3 ($gsd-plan-phase 3) [if CONTEXT.md exists or discuss option declined]
|
|
188
188
|
|
|
189
189
|
[Secondary options:]
|
|
190
190
|
2. Review current phase status
|
|
@@ -215,7 +215,7 @@ Based on user selection, route to appropriate workflow:
|
|
|
215
215
|
|
|
216
216
|
**{phase}-{plan}: [Plan Name]** — [objective from PLAN.md]
|
|
217
217
|
|
|
218
|
-
|
|
218
|
+
`$gsd-execute-phase {phase}`
|
|
219
219
|
|
|
220
220
|
<sub>`/clear` first → fresh context window</sub>
|
|
221
221
|
|
|
@@ -229,15 +229,15 @@ Based on user selection, route to appropriate workflow:
|
|
|
229
229
|
|
|
230
230
|
**Phase [N]: [Name]** — [Goal from ROADMAP.md]
|
|
231
231
|
|
|
232
|
-
|
|
232
|
+
`$gsd-plan-phase [phase-number]`
|
|
233
233
|
|
|
234
234
|
<sub>`/clear` first → fresh context window</sub>
|
|
235
235
|
|
|
236
236
|
---
|
|
237
237
|
|
|
238
238
|
**Also available:**
|
|
239
|
-
-
|
|
240
|
-
-
|
|
239
|
+
- `$gsd-discuss-phase [N]` — gather context first
|
|
240
|
+
- `$gsd-research-phase [N]` — investigate unknowns
|
|
241
241
|
|
|
242
242
|
---
|
|
243
243
|
```
|
|
@@ -192,13 +192,13 @@ Display:
|
|
|
192
192
|
| Git Branching | {None/Per Phase/Per Milestone} |
|
|
193
193
|
| Saved as Defaults | {Yes/No} |
|
|
194
194
|
|
|
195
|
-
These settings apply to future
|
|
195
|
+
These settings apply to future $gsd-plan-phase and $gsd-execute-phase runs.
|
|
196
196
|
|
|
197
197
|
Quick commands:
|
|
198
|
-
-
|
|
199
|
-
-
|
|
200
|
-
-
|
|
201
|
-
-
|
|
198
|
+
- $gsd-set-profile <profile> — switch model profile
|
|
199
|
+
- $gsd-plan-phase --research — force research
|
|
200
|
+
- $gsd-plan-phase --skip-research — skip research
|
|
201
|
+
- $gsd-plan-phase --skip-verify — skip plan check
|
|
202
202
|
```
|
|
203
203
|
</step>
|
|
204
204
|
|