@undeemed/get-shit-done-codex 1.6.12 → 1.20.3

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.
Files changed (114) hide show
  1. package/README.md +40 -7
  2. package/agents/gsd-codebase-mapper.md +761 -0
  3. package/agents/gsd-debugger.md +1198 -0
  4. package/agents/gsd-executor.md +419 -0
  5. package/agents/gsd-integration-checker.md +423 -0
  6. package/agents/gsd-phase-researcher.md +469 -0
  7. package/agents/gsd-plan-checker.md +622 -0
  8. package/agents/gsd-planner.md +1159 -0
  9. package/agents/gsd-project-researcher.md +618 -0
  10. package/agents/gsd-research-synthesizer.md +236 -0
  11. package/agents/gsd-roadmapper.md +639 -0
  12. package/agents/gsd-verifier.md +541 -0
  13. package/bin/install.js +108 -102
  14. package/commands/gsd/add-phase.md +17 -185
  15. package/commands/gsd/add-todo.md +23 -163
  16. package/commands/gsd/audit-milestone.md +3 -219
  17. package/commands/gsd/check-todos.md +20 -196
  18. package/commands/gsd/cleanup.md +18 -0
  19. package/commands/gsd/complete-milestone.md +2 -2
  20. package/commands/gsd/debug.md +13 -0
  21. package/commands/gsd/discuss-phase.md +13 -6
  22. package/commands/gsd/execute-phase.md +4 -266
  23. package/commands/gsd/health.md +22 -0
  24. package/commands/gsd/help.md +8 -369
  25. package/commands/gsd/insert-phase.md +9 -203
  26. package/commands/gsd/join-discord.md +18 -0
  27. package/commands/gsd/list-phase-assumptions.md +4 -4
  28. package/commands/gsd/map-codebase.md +1 -1
  29. package/commands/gsd/new-milestone.md +16 -682
  30. package/commands/gsd/new-project.md +12 -866
  31. package/commands/gsd/new-project.md.bak +1041 -0
  32. package/commands/gsd/pause-work.md +17 -105
  33. package/commands/gsd/plan-milestone-gaps.md +3 -247
  34. package/commands/gsd/plan-phase.md +13 -444
  35. package/commands/gsd/progress.md +5 -337
  36. package/commands/gsd/quick.md +40 -0
  37. package/commands/gsd/reapply-patches.md +110 -0
  38. package/commands/gsd/remove-phase.md +9 -315
  39. package/commands/gsd/research-phase.md +27 -20
  40. package/commands/gsd/resume-work.md +2 -2
  41. package/commands/gsd/set-profile.md +34 -0
  42. package/commands/gsd/settings.md +36 -0
  43. package/commands/gsd/update.md +25 -160
  44. package/commands/gsd/verify-work.md +6 -186
  45. package/get-shit-done/bin/gsd-tools.cjs +5243 -0
  46. package/get-shit-done/bin/gsd-tools.test.cjs +2273 -0
  47. package/get-shit-done/references/checkpoints.md +270 -283
  48. package/get-shit-done/references/decimal-phase-calculation.md +65 -0
  49. package/get-shit-done/references/git-integration.md +7 -13
  50. package/get-shit-done/references/git-planning-commit.md +38 -0
  51. package/get-shit-done/references/model-profile-resolution.md +34 -0
  52. package/get-shit-done/references/model-profiles.md +92 -0
  53. package/get-shit-done/references/phase-argument-parsing.md +61 -0
  54. package/get-shit-done/references/planning-config.md +196 -0
  55. package/get-shit-done/references/questioning.md +5 -1
  56. package/get-shit-done/references/verification-patterns.md +17 -0
  57. package/get-shit-done/templates/DEBUG.md +4 -4
  58. package/get-shit-done/templates/UAT.md +1 -1
  59. package/get-shit-done/templates/codebase/architecture.md +1 -1
  60. package/get-shit-done/templates/codebase/concerns.md +1 -1
  61. package/get-shit-done/templates/codebase/conventions.md +1 -1
  62. package/get-shit-done/templates/codebase/structure.md +9 -9
  63. package/get-shit-done/templates/config.json +10 -0
  64. package/get-shit-done/templates/context.md +7 -15
  65. package/get-shit-done/templates/continue-here.md +1 -1
  66. package/get-shit-done/templates/phase-prompt.md +32 -41
  67. package/get-shit-done/templates/planner-subagent-prompt.md +4 -4
  68. package/get-shit-done/templates/project.md +1 -1
  69. package/get-shit-done/templates/research-project/ARCHITECTURE.md +1 -1
  70. package/get-shit-done/templates/research.md +27 -4
  71. package/get-shit-done/templates/state.md +1 -31
  72. package/get-shit-done/templates/summary-complex.md +59 -0
  73. package/get-shit-done/templates/summary-minimal.md +41 -0
  74. package/get-shit-done/templates/summary-standard.md +48 -0
  75. package/get-shit-done/templates/summary.md +5 -28
  76. package/get-shit-done/templates/user-setup.md +8 -20
  77. package/get-shit-done/templates/verification-report.md +3 -3
  78. package/get-shit-done/workflows/add-phase.md +111 -0
  79. package/get-shit-done/workflows/add-todo.md +157 -0
  80. package/get-shit-done/workflows/audit-milestone.md +242 -0
  81. package/get-shit-done/workflows/check-todos.md +176 -0
  82. package/get-shit-done/workflows/cleanup.md +152 -0
  83. package/get-shit-done/workflows/complete-milestone.md +225 -301
  84. package/get-shit-done/workflows/diagnose-issues.md +3 -17
  85. package/get-shit-done/workflows/discovery-phase.md +11 -15
  86. package/get-shit-done/workflows/discuss-phase.md +105 -42
  87. package/get-shit-done/workflows/execute-phase.md +205 -349
  88. package/get-shit-done/workflows/execute-plan.md +179 -1569
  89. package/get-shit-done/workflows/health.md +156 -0
  90. package/get-shit-done/workflows/help.md +486 -0
  91. package/get-shit-done/workflows/insert-phase.md +129 -0
  92. package/get-shit-done/workflows/list-phase-assumptions.md +9 -9
  93. package/get-shit-done/workflows/map-codebase.md +56 -18
  94. package/get-shit-done/workflows/new-milestone.md +373 -0
  95. package/get-shit-done/workflows/new-project.md +1113 -0
  96. package/get-shit-done/workflows/pause-work.md +122 -0
  97. package/get-shit-done/workflows/plan-milestone-gaps.md +256 -0
  98. package/get-shit-done/workflows/plan-phase.md +448 -0
  99. package/get-shit-done/workflows/progress.md +393 -0
  100. package/get-shit-done/workflows/quick.md +444 -0
  101. package/get-shit-done/workflows/remove-phase.md +154 -0
  102. package/get-shit-done/workflows/research-phase.md +74 -0
  103. package/get-shit-done/workflows/resume-project.md +18 -23
  104. package/get-shit-done/workflows/set-profile.md +80 -0
  105. package/get-shit-done/workflows/settings.md +200 -0
  106. package/get-shit-done/workflows/transition.md +78 -103
  107. package/get-shit-done/workflows/update.md +214 -0
  108. package/get-shit-done/workflows/verify-phase.md +109 -496
  109. package/get-shit-done/workflows/verify-work.md +22 -15
  110. package/hooks/dist/gsd-check-update.js +66 -0
  111. package/hooks/dist/gsd-statusline.js +91 -0
  112. package/package.json +19 -3
  113. package/scripts/build-hooks.js +42 -0
  114. package/commands/gsd/whats-new.md +0 -124
@@ -1,172 +1,37 @@
1
1
  ---
2
2
  name: gsd:update
3
3
  description: Update GSD to latest version with changelog display
4
+ allowed-tools:
5
+ - Bash
6
+ - AskUserQuestion
4
7
  ---
5
8
 
6
9
  <objective>
7
10
  Check for GSD updates, install if available, and display what changed.
8
11
 
9
- Provides a better update experience than raw `npx get-shit-done-cc` by showing version diff and changelog entries.
12
+ Routes to the update workflow which handles:
13
+ - Version detection (local vs global installation)
14
+ - npm version checking
15
+ - Changelog fetching and display
16
+ - User confirmation with clean install warning
17
+ - Update execution and cache clearing
18
+ - Restart reminder
10
19
  </objective>
11
20
 
12
- <process>
13
-
14
- <step name="get_installed_version">
15
- Read installed version:
16
-
17
- ```bash
18
- cat ~/.claude/get-shit-done/VERSION 2>/dev/null
19
- ```
20
-
21
- **If VERSION file missing:**
22
- ```
23
- ## GSD Update
24
-
25
- **Installed version:** Unknown
26
-
27
- Your installation doesn't include version tracking.
28
-
29
- Running fresh install...
30
- ```
31
-
32
- Proceed to install step (treat as version 0.0.0 for comparison).
33
- </step>
34
-
35
- <step name="check_latest_version">
36
- Check npm for latest version:
37
-
38
- ```bash
39
- npm view get-shit-done-cc version 2>/dev/null
40
- ```
41
-
42
- **If npm check fails:**
43
- ```
44
- Couldn't check for updates (offline or npm unavailable).
45
-
46
- To update manually: `npx get-shit-done-cc --global`
47
- ```
48
-
49
- STOP here if npm unavailable.
50
- </step>
51
-
52
- <step name="compare_versions">
53
- Compare installed vs latest:
54
-
55
- **If installed == latest:**
56
- ```
57
- ## GSD Update
58
-
59
- **Installed:** X.Y.Z
60
- **Latest:** X.Y.Z
61
-
62
- You're already on the latest version.
63
- ```
64
-
65
- STOP here if already up to date.
66
-
67
- **If installed > latest:**
68
- ```
69
- ## GSD Update
70
-
71
- **Installed:** X.Y.Z
72
- **Latest:** A.B.C
73
-
74
- You're ahead of the latest release (development version?).
75
- ```
76
-
77
- STOP here if ahead.
78
- </step>
79
-
80
- <step name="show_changes_and_confirm">
81
- **If update available**, fetch and show what's new BEFORE updating:
82
-
83
- 1. Fetch changelog (same as fetch_changelog step)
84
- 2. Extract entries between installed and latest versions
85
- 3. Display preview and ask for confirmation:
86
-
87
- ```
88
- ## GSD Update Available
89
-
90
- **Installed:** 1.5.10
91
- **Latest:** 1.5.15
92
-
93
- ### What's New
94
- ────────────────────────────────────────────────────────────
95
-
96
- ## [1.5.15] - 2026-01-20
97
-
98
- ### Added
99
- - Feature X
100
-
101
- ## [1.5.14] - 2026-01-18
102
-
103
- ### Fixed
104
- - Bug fix Y
105
-
106
- ────────────────────────────────────────────────────────────
107
-
108
- ⚠️ **Note:** The installer performs a clean install of GSD folders:
109
- - `~/.claude/commands/gsd/` will be wiped and replaced
110
- - `~/.claude/get-shit-done/` will be wiped and replaced
111
- - `~/.claude/agents/gsd-*` files will be replaced
112
-
113
- Your custom files in other locations are preserved:
114
- - Custom commands in `~/.claude/commands/your-stuff/` ✓
115
- - Custom agents not prefixed with `gsd-` ✓
116
- - Custom hooks ✓
117
- - Your CLAUDE.md files ✓
118
-
119
- If you've modified any GSD files directly, back them up first.
120
- ```
121
-
122
- Use AskUserQuestion:
123
- - Question: "Proceed with update?"
124
- - Options:
125
- - "Yes, update now"
126
- - "No, cancel"
127
-
128
- **If user cancels:** STOP here.
129
- </step>
130
-
131
- <step name="run_update">
132
- Run the update:
133
-
134
- ```bash
135
- npx get-shit-done-cc --global
136
- ```
137
-
138
- Capture output. If install fails, show error and STOP.
139
-
140
- Clear the update cache so statusline indicator disappears:
141
-
142
- ```bash
143
- rm -f ~/.claude/cache/gsd-update-check.json
144
- ```
145
- </step>
146
-
147
- <step name="display_result">
148
- Format completion message (changelog was already shown in confirmation step):
149
-
150
- ```
151
- ╔═══════════════════════════════════════════════════════════╗
152
- ║ GSD Updated: v1.5.10 → v1.5.15 ║
153
- ╚═══════════════════════════════════════════════════════════╝
154
-
155
- ⚠️ Restart Claude Code to pick up the new commands.
156
-
157
- [View full changelog](https://github.com/glittercowboy/get-shit-done/blob/main/CHANGELOG.md)
158
- ```
159
- </step>
21
+ <execution_context>
22
+ @~/.codex/get-shit-done/workflows/update.md
23
+ </execution_context>
160
24
 
25
+ <process>
26
+ **Follow the update workflow** from `@~/.codex/get-shit-done/workflows/update.md`.
27
+
28
+ The workflow handles all logic including:
29
+ 1. Installed version detection (local/global)
30
+ 2. Latest version checking via npm
31
+ 3. Version comparison
32
+ 4. Changelog fetching and extraction
33
+ 5. Clean install warning display
34
+ 6. User confirmation
35
+ 7. Update execution
36
+ 8. Cache clearing
161
37
  </process>
162
-
163
- <success_criteria>
164
- - [ ] Installed version read correctly
165
- - [ ] Latest version checked via npm
166
- - [ ] Update skipped if already current
167
- - [ ] Changelog fetched and displayed BEFORE update
168
- - [ ] Clean install warning shown
169
- - [ ] User confirmation obtained
170
- - [ ] Update executed successfully
171
- - [ ] Restart reminder shown
172
- </success_criteria>
@@ -11,18 +11,17 @@ allowed-tools:
11
11
  - Write
12
12
  - Task
13
13
  ---
14
-
15
14
  <objective>
16
15
  Validate built features through conversational testing with persistent state.
17
16
 
18
- Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
17
+ Purpose: Confirm what Codex built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
19
18
 
20
- Output: {phase}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase
19
+ Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase
21
20
  </objective>
22
21
 
23
22
  <execution_context>
24
- @~/.claude/get-shit-done/workflows/verify-work.md
25
- @~/.claude/get-shit-done/templates/UAT.md
23
+ @~/.codex/get-shit-done/workflows/verify-work.md
24
+ @~/.codex/get-shit-done/templates/UAT.md
26
25
  </execution_context>
27
26
 
28
27
  <context>
@@ -35,185 +34,6 @@ Phase: $ARGUMENTS (optional)
35
34
  </context>
36
35
 
37
36
  <process>
38
- 1. Check for active UAT sessions (resume or start new)
39
- 2. Find SUMMARY.md files for the phase
40
- 3. Extract testable deliverables (user-observable outcomes)
41
- 4. Create {phase}-UAT.md with test list
42
- 5. Present tests one at a time:
43
- - Show expected behavior
44
- - Wait for plain text response
45
- - "yes/y/next" = pass, anything else = issue (severity inferred)
46
- 6. Update UAT.md after each response
47
- 7. On completion: commit, present summary
48
- 8. If issues found:
49
- - Spawn parallel debug agents to diagnose root causes
50
- - Spawn gsd-planner in --gaps mode to create fix plans
51
- - Spawn gsd-plan-checker to verify fix plans
52
- - Iterate planner ↔ checker until plans pass (max 3)
53
- - Present ready status with `/clear` then `/gsd:execute-phase`
37
+ Execute the verify-work workflow from @~/.codex/get-shit-done/workflows/verify-work.md end-to-end.
38
+ Preserve all workflow gates (session management, test presentation, diagnosis, fix planning, routing).
54
39
  </process>
55
-
56
- <anti_patterns>
57
- - Don't use AskUserQuestion for test responses — plain text conversation
58
- - Don't ask severity — infer from description
59
- - Don't present full checklist upfront — one test at a time
60
- - Don't run automated tests — this is manual user validation
61
- - Don't fix issues during testing — log as gaps, diagnose after all tests complete
62
- </anti_patterns>
63
-
64
- <offer_next>
65
- Output this markdown directly (not as a code block). Route based on UAT results:
66
-
67
- | Status | Route |
68
- |--------|-------|
69
- | All tests pass + more phases | Route A (next phase) |
70
- | All tests pass + last phase | Route B (milestone complete) |
71
- | Issues found + fix plans ready | Route C (execute fixes) |
72
- | Issues found + planning blocked | Route D (manual intervention) |
73
-
74
- ---
75
-
76
- **Route A: All tests pass, more phases remain**
77
-
78
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
79
- GSD-CODEX ► PHASE {Z} VERIFIED ✓
80
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
81
-
82
- **Phase {Z}: {Name}**
83
-
84
- {N}/{N} tests passed
85
- UAT complete ✓
86
-
87
- ───────────────────────────────────────────────────────────────
88
-
89
- ## ▶ Next Up
90
-
91
- **Phase {Z+1}: {Name}** — {Goal from ROADMAP.md}
92
-
93
- /gsd:discuss-phase {Z+1} — gather context and clarify approach
94
-
95
- <sub>/clear first → fresh context window</sub>
96
-
97
- ───────────────────────────────────────────────────────────────
98
-
99
- **Also available:**
100
- - /gsd:plan-phase {Z+1} — skip discussion, plan directly
101
- - /gsd:execute-phase {Z+1} — skip to execution (if already planned)
102
-
103
- ───────────────────────────────────────────────────────────────
104
-
105
- ---
106
-
107
- **Route B: All tests pass, milestone complete**
108
-
109
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
110
- GSD-CODEX ► PHASE {Z} VERIFIED ✓
111
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
112
-
113
- **Phase {Z}: {Name}**
114
-
115
- {N}/{N} tests passed
116
- Final phase verified ✓
117
-
118
- ───────────────────────────────────────────────────────────────
119
-
120
- ## ▶ Next Up
121
-
122
- **Audit milestone** — verify requirements, cross-phase integration, E2E flows
123
-
124
- /gsd:audit-milestone
125
-
126
- <sub>/clear first → fresh context window</sub>
127
-
128
- ───────────────────────────────────────────────────────────────
129
-
130
- **Also available:**
131
- - /gsd:complete-milestone — skip audit, archive directly
132
-
133
- ───────────────────────────────────────────────────────────────
134
-
135
- ---
136
-
137
- **Route C: Issues found, fix plans ready**
138
-
139
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
140
- GSD-CODEX ► PHASE {Z} ISSUES FOUND ⚠
141
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
142
-
143
- **Phase {Z}: {Name}**
144
-
145
- {N}/{M} tests passed
146
- {X} issues diagnosed
147
- Fix plans verified ✓
148
-
149
- ### Issues Found
150
-
151
- {List issues with severity from UAT.md}
152
-
153
- ───────────────────────────────────────────────────────────────
154
-
155
- ## ▶ Next Up
156
-
157
- **Execute fix plans** — run diagnosed fixes
158
-
159
- /gsd:execute-phase {Z} --gaps-only
160
-
161
- <sub>/clear first → fresh context window</sub>
162
-
163
- ───────────────────────────────────────────────────────────────
164
-
165
- **Also available:**
166
- - cat .planning/phases/{phase_dir}/*-PLAN.md — review fix plans
167
- - /gsd:plan-phase {Z} --gaps — regenerate fix plans
168
-
169
- ───────────────────────────────────────────────────────────────
170
-
171
- ---
172
-
173
- **Route D: Issues found, planning blocked**
174
-
175
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
176
- GSD-CODEX ► PHASE {Z} BLOCKED ✗
177
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
178
-
179
- **Phase {Z}: {Name}**
180
-
181
- {N}/{M} tests passed
182
- Fix planning blocked after {X} iterations
183
-
184
- ### Unresolved Issues
185
-
186
- {List blocking issues from planner/checker output}
187
-
188
- ───────────────────────────────────────────────────────────────
189
-
190
- ## ▶ Next Up
191
-
192
- **Manual intervention required**
193
-
194
- Review the issues above and either:
195
- 1. Provide guidance for fix planning
196
- 2. Manually address blockers
197
- 3. Accept current state and continue
198
-
199
- ───────────────────────────────────────────────────────────────
200
-
201
- **Options:**
202
- - /gsd:plan-phase {Z} --gaps — retry fix planning with guidance
203
- - /gsd:discuss-phase {Z} — gather more context before replanning
204
-
205
- ───────────────────────────────────────────────────────────────
206
- </offer_next>
207
-
208
- <success_criteria>
209
- - [ ] UAT.md created with tests from SUMMARY.md
210
- - [ ] Tests presented one at a time with expected behavior
211
- - [ ] Plain text responses (no structured forms)
212
- - [ ] Severity inferred, never asked
213
- - [ ] Batched writes: on issue, every 5 passes, or completion
214
- - [ ] Committed on completion
215
- - [ ] If issues: parallel debug agents diagnose root causes
216
- - [ ] If issues: gsd-planner creates fix plans from diagnosed gaps
217
- - [ ] If issues: gsd-plan-checker verifies fix plans (max 3 iterations)
218
- - [ ] Ready for `/gsd:execute-phase` when complete
219
- </success_criteria>