@undeemed/get-shit-done-codex 1.24.2 → 1.24.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.
- package/README.md +62 -9
- package/get-shit-done/AGENTS.md +59 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -44,7 +44,8 @@ graph TB
|
|
|
44
44
|
|
|
45
45
|
## What Changed In This Fork
|
|
46
46
|
|
|
47
|
-
- **AGENTS-first for Codex:** `AGENTS.md` is the primary behavior contract. [Agent.md
|
|
47
|
+
- **AGENTS-first for Codex:** `AGENTS.md` is the primary behavior contract. [Agent.md Info](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals)
|
|
48
|
+
- **Default Model is flagship:** Codex 5.3 is used for all profile modes, but at different thinking levels. [Model Profiles](https://github.com/undeemed/get-shit-done-codex/edit/main/README.md#model-profiles)
|
|
48
49
|
- **Native skills:** all commands use `$gsd-*` skill notation — no prompt aliases needed.
|
|
49
50
|
- **Full config distribution:** installer ships `.codex/config.toml` (multi-agent, feature flags, MCP servers) and 11 rich `agents/*.md` sub-agent definitions — everything needed for multi-agent orchestration out of the box.
|
|
50
51
|
- **Sub-agent linking:** each agent role in `config.toml` uses `developer_instructions` to load its full role definition from `agents/gsd-*.md` at runtime — no manual wiring needed.
|
|
@@ -90,7 +91,7 @@ The installer distributes everything GSD needs:
|
|
|
90
91
|
On first run, Codex may prompt you to **trust the project** so the config takes effect (one-time, one-click).
|
|
91
92
|
|
|
92
93
|
> [!NOTE]
|
|
93
|
-
> `.codex/config.toml` is non-destructive — the installer skips it if you already have one, so your customizations are preserved on updates.
|
|
94
|
+
> `.codex/config.toml` is non-destructive — the installer skips it if you already have one, so your customizations are preserved on updates. You can manually update it later referencing the .codex/.toml in this repo.
|
|
94
95
|
|
|
95
96
|
### Installed File Structure
|
|
96
97
|
|
|
@@ -210,13 +211,65 @@ Manual user acceptance testing. The system walks you through testable deliverabl
|
|
|
210
211
|
|
|
211
212
|
## Commands
|
|
212
213
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
|
216
|
-
|
|
|
217
|
-
| `$gsd-
|
|
218
|
-
| `$gsd-
|
|
219
|
-
| `$gsd-
|
|
214
|
+
**Core Workflow**
|
|
215
|
+
|
|
216
|
+
| Command | Description |
|
|
217
|
+
| -------------------------- | ----------------------------------------------------------------- |
|
|
218
|
+
| `$gsd-new-project` | Initialize project: questions → research → requirements → roadmap |
|
|
219
|
+
| `$gsd-create-roadmap` | Create roadmap and state tracking |
|
|
220
|
+
| `$gsd-map-codebase` | Map existing codebase (brownfield projects) |
|
|
221
|
+
| `$gsd-plan-phase [N]` | Research + plan + verify for a phase |
|
|
222
|
+
| `$gsd-execute-phase <N>` | Execute all plans in parallel waves |
|
|
223
|
+
| `$gsd-execute-plan [path]` | Execute a single PLAN.md file |
|
|
224
|
+
| `$gsd-verify-work [N]` | Manual user acceptance testing |
|
|
225
|
+
| `$gsd-progress` | Show current position and what's next |
|
|
226
|
+
| `$gsd-quick` | Quick-start shortcut for small tasks |
|
|
227
|
+
|
|
228
|
+
**Phase Management**
|
|
229
|
+
|
|
230
|
+
| Command | Description |
|
|
231
|
+
| --------------------------------- | ----------------------------------- |
|
|
232
|
+
| `$gsd-add-phase` | Append phase to roadmap |
|
|
233
|
+
| `$gsd-insert-phase [N]` | Insert urgent work at position N |
|
|
234
|
+
| `$gsd-remove-phase [N]` | Remove a future phase |
|
|
235
|
+
| `$gsd-discuss-phase [N]` | Gather context before planning |
|
|
236
|
+
| `$gsd-research-phase [N]` | Deep ecosystem research for a phase |
|
|
237
|
+
| `$gsd-list-phase-assumptions [N]` | Review assumptions before planning |
|
|
238
|
+
|
|
239
|
+
**Milestones**
|
|
240
|
+
|
|
241
|
+
| Command | Description |
|
|
242
|
+
| --------------------------- | ------------------------------------ |
|
|
243
|
+
| `$gsd-complete-milestone` | Archive milestone, prep next version |
|
|
244
|
+
| `$gsd-discuss-milestone` | Gather context for next milestone |
|
|
245
|
+
| `$gsd-new-milestone [name]` | Create new milestone with phases |
|
|
246
|
+
| `$gsd-audit-milestone` | Audit milestone completeness |
|
|
247
|
+
| `$gsd-plan-milestone-gaps` | Plan for gaps in current milestone |
|
|
248
|
+
|
|
249
|
+
**Session & Debugging**
|
|
250
|
+
|
|
251
|
+
| Command | Description |
|
|
252
|
+
| ---------------------- | -------------------------------------- |
|
|
253
|
+
| `$gsd-pause-work` | Create handoff when stopping mid-phase |
|
|
254
|
+
| `$gsd-resume-work` | Restore from last session |
|
|
255
|
+
| `$gsd-consider-issues` | Review deferred issues |
|
|
256
|
+
| `$gsd-plan-fix [plan]` | Plan fixes for UAT issues |
|
|
257
|
+
| `$gsd-debug` | Diagnose and debug issues |
|
|
258
|
+
| `$gsd-cleanup` | Clean up planning artifacts |
|
|
259
|
+
|
|
260
|
+
**Configuration & Utilities**
|
|
261
|
+
|
|
262
|
+
| Command | Description |
|
|
263
|
+
| ---------------------- | ------------------------------------------------------ |
|
|
264
|
+
| `$gsd-set-profile <P>` | Switch model profile (`quality`, `balanced`, `budget`) |
|
|
265
|
+
| `$gsd-settings` | View or edit project config |
|
|
266
|
+
| `$gsd-health` | Project health check |
|
|
267
|
+
| `$gsd-add-tests` | Add tests for a phase |
|
|
268
|
+
| `$gsd-add-todo` | Add a todo item |
|
|
269
|
+
| `$gsd-check-todos` | Review open todos |
|
|
270
|
+
| `$gsd-reapply-patches` | Reapply saved patches |
|
|
271
|
+
| `$gsd-update` | Check for and install updates |
|
|
272
|
+
| `$gsd-help` | Show all commands |
|
|
220
273
|
|
|
221
274
|
## Why It Works
|
|
222
275
|
|
package/get-shit-done/AGENTS.md
CHANGED
|
@@ -83,29 +83,65 @@ Each task gets its own commit immediately after completion:
|
|
|
83
83
|
|
|
84
84
|
The following commands are available. Invoke them with `$gsd-command-name`:
|
|
85
85
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
| `$gsd-
|
|
91
|
-
| `$gsd-
|
|
92
|
-
| `$gsd-
|
|
93
|
-
| `$gsd-
|
|
94
|
-
| `$gsd-
|
|
95
|
-
| `$gsd-plan
|
|
96
|
-
| `$gsd-
|
|
97
|
-
| `$gsd-
|
|
98
|
-
| `$gsd-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
| `$gsd-
|
|
105
|
-
| `$gsd-
|
|
106
|
-
| `$gsd-
|
|
107
|
-
| `$gsd-
|
|
108
|
-
| `$gsd-
|
|
86
|
+
**Core Workflow**
|
|
87
|
+
|
|
88
|
+
| Command | Description |
|
|
89
|
+
| -------------------------- | ------------------------------------------- |
|
|
90
|
+
| `$gsd-new-project` | Initialize project through deep questioning |
|
|
91
|
+
| `$gsd-create-roadmap` | Create roadmap and state tracking |
|
|
92
|
+
| `$gsd-map-codebase` | Map existing codebase (brownfield projects) |
|
|
93
|
+
| `$gsd-plan-phase [N]` | Generate task plans for phase N |
|
|
94
|
+
| `$gsd-execute-phase [N]` | Execute all plans in parallel waves |
|
|
95
|
+
| `$gsd-execute-plan [path]` | Execute a PLAN.md file |
|
|
96
|
+
| `$gsd-verify-work [N]` | User acceptance testing |
|
|
97
|
+
| `$gsd-progress` | Show current position and what's next |
|
|
98
|
+
| `$gsd-quick` | Quick-start shortcut for small tasks |
|
|
99
|
+
|
|
100
|
+
**Phase Management**
|
|
101
|
+
|
|
102
|
+
| Command | Description |
|
|
103
|
+
| --------------------------------- | ---------------------------------- |
|
|
104
|
+
| `$gsd-add-phase` | Append phase to roadmap |
|
|
105
|
+
| `$gsd-insert-phase [N]` | Insert urgent work at position N |
|
|
106
|
+
| `$gsd-remove-phase [N]` | Remove future phase |
|
|
107
|
+
| `$gsd-discuss-phase [N]` | Gather context before planning |
|
|
108
|
+
| `$gsd-research-phase [N]` | Deep ecosystem research |
|
|
109
|
+
| `$gsd-list-phase-assumptions [N]` | Review assumptions before planning |
|
|
110
|
+
|
|
111
|
+
**Milestones**
|
|
112
|
+
|
|
113
|
+
| Command | Description |
|
|
114
|
+
| --------------------------- | ------------------------------------ |
|
|
115
|
+
| `$gsd-complete-milestone` | Archive milestone, prep next version |
|
|
116
|
+
| `$gsd-discuss-milestone` | Gather context for next milestone |
|
|
117
|
+
| `$gsd-new-milestone [name]` | Create new milestone with phases |
|
|
118
|
+
| `$gsd-audit-milestone` | Audit milestone completeness |
|
|
119
|
+
| `$gsd-plan-milestone-gaps` | Plan for gaps in current milestone |
|
|
120
|
+
|
|
121
|
+
**Session & Debugging**
|
|
122
|
+
|
|
123
|
+
| Command | Description |
|
|
124
|
+
| ---------------------- | -------------------------------------- |
|
|
125
|
+
| `$gsd-pause-work` | Create handoff when stopping mid-phase |
|
|
126
|
+
| `$gsd-resume-work` | Restore from last session |
|
|
127
|
+
| `$gsd-consider-issues` | Review deferred issues |
|
|
128
|
+
| `$gsd-plan-fix [plan]` | Plan fixes for UAT issues |
|
|
129
|
+
| `$gsd-debug` | Diagnose and debug issues |
|
|
130
|
+
| `$gsd-cleanup` | Clean up planning artifacts |
|
|
131
|
+
|
|
132
|
+
**Configuration & Utilities**
|
|
133
|
+
|
|
134
|
+
| Command | Description |
|
|
135
|
+
| ---------------------- | ------------------------------------------------ |
|
|
136
|
+
| `$gsd-set-profile <P>` | Switch model profile (quality, balanced, budget) |
|
|
137
|
+
| `$gsd-settings` | View or edit project config |
|
|
138
|
+
| `$gsd-health` | Project health check |
|
|
139
|
+
| `$gsd-add-tests` | Add tests for a phase |
|
|
140
|
+
| `$gsd-add-todo` | Add a todo item |
|
|
141
|
+
| `$gsd-check-todos` | Review open todos |
|
|
142
|
+
| `$gsd-reapply-patches` | Reapply saved patches |
|
|
143
|
+
| `$gsd-update` | Check for and install updates |
|
|
144
|
+
| `$gsd-help` | Show all commands |
|
|
109
145
|
|
|
110
146
|
## Workflow
|
|
111
147
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@undeemed/get-shit-done-codex",
|
|
3
|
-
"version": "1.24.
|
|
3
|
+
"version": "1.24.3",
|
|
4
4
|
"description": "A meta-prompting, context engineering and spec-driven development system for OpenAI Codex (CLI and Desktop). Fork of get-shit-done by TÂCHES, adapted for Codex.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"get-shit-done-codex": "bin/install.js"
|