claude-cook 1.10.3 → 1.10.5
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 +72 -72
- package/agents/{gsd-codebase-mapper.md → cook-codebase-mapper.md} +6 -6
- package/agents/{gsd-debugger.md → cook-debugger.md} +5 -5
- package/agents/{gsd-executor.md → cook-executor.md} +6 -6
- package/agents/{gsd-integration-checker.md → cook-integration-checker.md} +1 -1
- package/agents/{gsd-phase-researcher.md → cook-phase-researcher.md} +8 -8
- package/agents/{gsd-plan-checker.md → cook-plan-checker.md} +8 -8
- package/agents/{gsd-planner.md → cook-planner.md} +15 -15
- package/agents/{gsd-pm.md → cook-pm.md} +17 -17
- package/agents/{gsd-project-researcher.md → cook-project-researcher.md} +5 -5
- package/agents/{gsd-research-synthesizer.md → cook-research-synthesizer.md} +8 -8
- package/agents/{gsd-roadmapper.md → cook-roadmapper.md} +9 -9
- package/agents/{gsd-verifier.md → cook-verifier.md} +7 -7
- package/bin/install.js +109 -109
- package/commands/{gsd → cook}/add-phase.md +10 -10
- package/commands/{gsd → cook}/add-todo.md +4 -4
- package/commands/{gsd → cook}/audit-milestone.md +9 -9
- package/commands/{gsd → cook}/check-todos.md +10 -10
- package/commands/{gsd → cook}/complete-milestone.md +9 -9
- package/commands/{gsd → cook}/debug.md +8 -8
- package/commands/{gsd → cook}/discuss-phase.md +3 -3
- package/commands/{gsd → cook}/execute-phase.md +25 -25
- package/commands/{gsd → cook}/help.md +108 -108
- package/commands/{gsd → cook}/insert-phase.md +8 -8
- package/commands/cook/join-discord.md +18 -0
- package/commands/{gsd → cook}/list-phase-assumptions.md +2 -2
- package/commands/{gsd → cook}/map-codebase.md +7 -7
- package/commands/{gsd → cook}/new-milestone.md +34 -34
- package/commands/{gsd → cook}/new-project.md +37 -37
- package/commands/{gsd → cook}/pause-work.md +2 -2
- package/commands/{gsd → cook}/plan-milestone-gaps.md +10 -10
- package/commands/{gsd → cook}/plan-phase.md +26 -26
- package/commands/{gsd → cook}/pm-check.md +8 -8
- package/commands/{gsd → cook}/pm-cycle.md +14 -14
- package/commands/{gsd → cook}/pm-replan.md +10 -10
- package/commands/{gsd → cook}/pm-start.md +25 -23
- package/commands/{gsd → cook}/pm-status.md +8 -8
- package/commands/{gsd → cook}/pm-stop.md +3 -3
- package/commands/{gsd → cook}/progress.md +34 -34
- package/commands/{gsd → cook}/quick.md +16 -16
- package/commands/{gsd → cook}/remove-phase.md +7 -7
- package/commands/{gsd → cook}/research-phase.md +10 -10
- package/commands/{gsd → cook}/resume-work.md +3 -3
- package/commands/{gsd → cook}/set-profile.md +12 -12
- package/commands/{gsd → cook}/settings.md +11 -11
- package/commands/{gsd → cook}/update.md +17 -17
- package/commands/{gsd → cook}/verify-work.md +23 -23
- package/{get-shit-done → cook}/references/continuation-format.md +16 -16
- package/{get-shit-done → cook}/references/git-integration.md +2 -2
- package/{get-shit-done → cook}/references/model-profiles.md +16 -16
- package/{get-shit-done → cook}/references/planning-config.md +10 -10
- package/{get-shit-done → cook}/references/ui-brand.md +6 -6
- package/{get-shit-done → cook}/references/verification-patterns.md +1 -1
- package/{get-shit-done → cook}/templates/DEBUG.md +1 -1
- package/{get-shit-done → cook}/templates/UAT.md +3 -3
- package/{get-shit-done → cook}/templates/codebase/architecture.md +2 -2
- package/{get-shit-done → cook}/templates/codebase/structure.md +13 -13
- package/{get-shit-done → cook}/templates/context.md +4 -4
- package/{get-shit-done → cook}/templates/debug-subagent-prompt.md +4 -4
- package/{get-shit-done → cook}/templates/discovery.md +2 -2
- package/{get-shit-done → cook}/templates/phase-prompt.md +12 -12
- package/{get-shit-done → cook}/templates/planner-subagent-prompt.md +7 -7
- package/{get-shit-done → cook}/templates/project.md +1 -1
- package/{get-shit-done → cook}/templates/research.md +1 -1
- package/{get-shit-done → cook}/templates/state.md +2 -2
- package/{get-shit-done → cook}/workflows/complete-milestone.md +6 -6
- package/{get-shit-done → cook}/workflows/diagnose-issues.md +2 -2
- package/{get-shit-done → cook}/workflows/discovery-phase.md +8 -8
- package/{get-shit-done → cook}/workflows/discuss-phase.md +5 -5
- package/{get-shit-done → cook}/workflows/execute-phase.md +20 -20
- package/{get-shit-done → cook}/workflows/execute-plan.md +16 -16
- package/{get-shit-done → cook}/workflows/list-phase-assumptions.md +4 -4
- package/{get-shit-done → cook}/workflows/map-codebase.md +12 -12
- package/{get-shit-done → cook}/workflows/pm-check.md +5 -5
- package/{get-shit-done → cook}/workflows/pm-cycle.md +4 -4
- package/{get-shit-done → cook}/workflows/pm-dispatch.md +4 -4
- package/{get-shit-done → cook}/workflows/pm-replan.md +9 -9
- package/{get-shit-done → cook}/workflows/pm-sync.md +2 -2
- package/{get-shit-done → cook}/workflows/resume-project.md +10 -10
- package/{get-shit-done → cook}/workflows/transition.md +6 -6
- package/{get-shit-done → cook}/workflows/verify-phase.md +4 -4
- package/{get-shit-done → cook}/workflows/verify-work.md +23 -23
- package/hooks/dist/{gsd-check-update.js → cook-check-update.js} +4 -4
- package/hooks/dist/{gsd-statusline.js → cook-statusline.js} +7 -7
- package/package.json +5 -5
- package/scripts/build-hooks.js +3 -3
- package/scripts/pm-loop.sh +207 -20
- package/commands/gsd/join-discord.md +0 -18
- /package/{get-shit-done → cook}/references/checkpoints.md +0 -0
- /package/{get-shit-done → cook}/references/questioning.md +0 -0
- /package/{get-shit-done → cook}/references/tdd.md +0 -0
- /package/{get-shit-done → cook}/references/vibe-kanban.md +0 -0
- /package/{get-shit-done → cook}/templates/codebase/concerns.md +0 -0
- /package/{get-shit-done → cook}/templates/codebase/conventions.md +0 -0
- /package/{get-shit-done → cook}/templates/codebase/integrations.md +0 -0
- /package/{get-shit-done → cook}/templates/codebase/stack.md +0 -0
- /package/{get-shit-done → cook}/templates/codebase/testing.md +0 -0
- /package/{get-shit-done → cook}/templates/config.json +0 -0
- /package/{get-shit-done → cook}/templates/continue-here.md +0 -0
- /package/{get-shit-done → cook}/templates/milestone-archive.md +0 -0
- /package/{get-shit-done → cook}/templates/milestone.md +0 -0
- /package/{get-shit-done → cook}/templates/pm-config.md +0 -0
- /package/{get-shit-done → cook}/templates/pm-log.md +0 -0
- /package/{get-shit-done → cook}/templates/requirements.md +0 -0
- /package/{get-shit-done → cook}/templates/research-project/ARCHITECTURE.md +0 -0
- /package/{get-shit-done → cook}/templates/research-project/FEATURES.md +0 -0
- /package/{get-shit-done → cook}/templates/research-project/PITFALLS.md +0 -0
- /package/{get-shit-done → cook}/templates/research-project/STACK.md +0 -0
- /package/{get-shit-done → cook}/templates/research-project/SUMMARY.md +0 -0
- /package/{get-shit-done → cook}/templates/roadmap.md +0 -0
- /package/{get-shit-done → cook}/templates/summary.md +0 -0
- /package/{get-shit-done → cook}/templates/ticket-map.md +0 -0
- /package/{get-shit-done → cook}/templates/user-setup.md +0 -0
- /package/{get-shit-done → cook}/templates/verification-report.md +0 -0
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
[](https://www.npmjs.com/package/claude-cook)
|
|
10
10
|
[](https://www.npmjs.com/package/claude-cook)
|
|
11
11
|
[](https://discord.gg/5JJgD5svVS)
|
|
12
|
-
[](https://github.com/glittercowboy/cook)
|
|
13
13
|
[](LICENSE)
|
|
14
14
|
|
|
15
15
|
<br>
|
|
@@ -22,7 +22,7 @@ npx claude-cook
|
|
|
22
22
|
|
|
23
23
|
<br>
|
|
24
24
|
|
|
25
|
-

|
|
26
26
|
|
|
27
27
|
<br>
|
|
28
28
|
|
|
@@ -48,7 +48,7 @@ I'm a solo developer. I don't write code — Claude Code does.
|
|
|
48
48
|
|
|
49
49
|
Other spec-driven development tools exist; BMAD, Speckit... But they all seem to make things way more complicated than they need to be (sprint ceremonies, story points, stakeholder syncs, retrospectives, Jira workflows) or lack real big picture understanding of what you're building. I'm not a 50-person software company. I don't want to play enterprise theater. I'm just a creative person trying to build great things that work.
|
|
50
50
|
|
|
51
|
-
So I built
|
|
51
|
+
So I built COOK. The complexity is in the system, not in your workflow. Behind the scenes: context engineering, XML prompt formatting, subagent orchestration, state management. What you see: a few commands that just work.
|
|
52
52
|
|
|
53
53
|
The system gives Claude everything it needs to do the work *and* verify it. I trust the workflow. It just does a good job.
|
|
54
54
|
|
|
@@ -60,7 +60,7 @@ That's what this is. No enterprise roleplay bullshit. Just an incredibly effecti
|
|
|
60
60
|
|
|
61
61
|
Vibecoding has a bad reputation. You describe what you want, AI generates code, and you get inconsistent garbage that falls apart at scale.
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
COOK fixes that. It's the context engineering layer that makes Claude Code reliable. Describe your idea, let the system extract everything it needs to know, and let Claude Code get to work.
|
|
64
64
|
|
|
65
65
|
---
|
|
66
66
|
|
|
@@ -80,11 +80,11 @@ The installer prompts you to choose:
|
|
|
80
80
|
1. **Runtime** — Claude Code, OpenCode, Gemini, or all
|
|
81
81
|
2. **Location** — Global (all projects) or local (current project only)
|
|
82
82
|
|
|
83
|
-
Verify with `/
|
|
83
|
+
Verify with `/cook:help` inside your chosen runtime.
|
|
84
84
|
|
|
85
85
|
### Staying Updated
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
COOK evolves fast. Update periodically:
|
|
88
88
|
|
|
89
89
|
```bash
|
|
90
90
|
npx claude-cook@latest
|
|
@@ -119,8 +119,8 @@ Use `--claude`, `--opencode`, `--gemini`, or `--all` to skip the runtime prompt.
|
|
|
119
119
|
Clone the repository and run the installer locally:
|
|
120
120
|
|
|
121
121
|
```bash
|
|
122
|
-
git clone https://github.com/glittercowboy/
|
|
123
|
-
cd
|
|
122
|
+
git clone https://github.com/glittercowboy/cook.git
|
|
123
|
+
cd cook
|
|
124
124
|
node bin/install.js --claude --local
|
|
125
125
|
```
|
|
126
126
|
|
|
@@ -130,14 +130,14 @@ Installs to `./.claude/` for testing modifications before contributing.
|
|
|
130
130
|
|
|
131
131
|
### Recommended: Skip Permissions Mode
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
COOK is designed for frictionless automation. Run Claude Code with:
|
|
134
134
|
|
|
135
135
|
```bash
|
|
136
136
|
claude --dangerously-skip-permissions
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
> [!TIP]
|
|
140
|
-
> This is how
|
|
140
|
+
> This is how COOK is intended to be used — stopping to approve `date` and `git commit` 50 times defeats the purpose.
|
|
141
141
|
|
|
142
142
|
<details>
|
|
143
143
|
<summary><strong>Alternative: Granular Permissions</strong></summary>
|
|
@@ -176,12 +176,12 @@ If you prefer not to use that flag, add this to your project's `.claude/settings
|
|
|
176
176
|
|
|
177
177
|
## How It Works
|
|
178
178
|
|
|
179
|
-
> **Already have code?** Run `/
|
|
179
|
+
> **Already have code?** Run `/cook:map-codebase` first. It spawns parallel agents to analyze your stack, architecture, conventions, and concerns. Then `/cook:new-project` knows your codebase — questions focus on what you're adding, and planning automatically loads your patterns.
|
|
180
180
|
|
|
181
181
|
### 1. Initialize Project
|
|
182
182
|
|
|
183
183
|
```
|
|
184
|
-
/
|
|
184
|
+
/cook:new-project
|
|
185
185
|
```
|
|
186
186
|
|
|
187
187
|
One command, one flow. The system:
|
|
@@ -200,7 +200,7 @@ You approve the roadmap. Now you're ready to build.
|
|
|
200
200
|
### 2. Discuss Phase
|
|
201
201
|
|
|
202
202
|
```
|
|
203
|
-
/
|
|
203
|
+
/cook:discuss-phase 1
|
|
204
204
|
```
|
|
205
205
|
|
|
206
206
|
**This is where you shape the implementation.**
|
|
@@ -228,7 +228,7 @@ The deeper you go here, the more the system builds what you actually want. Skip
|
|
|
228
228
|
### 3. Plan Phase
|
|
229
229
|
|
|
230
230
|
```
|
|
231
|
-
/
|
|
231
|
+
/cook:plan-phase 1
|
|
232
232
|
```
|
|
233
233
|
|
|
234
234
|
The system:
|
|
@@ -246,7 +246,7 @@ Each plan is small enough to execute in a fresh context window. No degradation,
|
|
|
246
246
|
### 4. Execute Phase
|
|
247
247
|
|
|
248
248
|
```
|
|
249
|
-
/
|
|
249
|
+
/cook:execute-phase 1
|
|
250
250
|
```
|
|
251
251
|
|
|
252
252
|
The system:
|
|
@@ -265,7 +265,7 @@ Walk away, come back to completed work with clean git history.
|
|
|
265
265
|
### 5. Verify Work
|
|
266
266
|
|
|
267
267
|
```
|
|
268
|
-
/
|
|
268
|
+
/cook:verify-work 1
|
|
269
269
|
```
|
|
270
270
|
|
|
271
271
|
**This is where you confirm it actually works.**
|
|
@@ -279,7 +279,7 @@ The system:
|
|
|
279
279
|
3. **Diagnoses failures automatically** — Spawns debug agents to find root causes
|
|
280
280
|
4. **Creates verified fix plans** — Ready for immediate re-execution
|
|
281
281
|
|
|
282
|
-
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/
|
|
282
|
+
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/cook:execute-phase` again with the fix plans it created.
|
|
283
283
|
|
|
284
284
|
**Creates:** `{phase}-UAT.md`, fix plans if issues found
|
|
285
285
|
|
|
@@ -288,34 +288,34 @@ If everything passes, you move on. If something's broken, you don't manually deb
|
|
|
288
288
|
### 6. Repeat → Complete → Next Milestone
|
|
289
289
|
|
|
290
290
|
```
|
|
291
|
-
/
|
|
292
|
-
/
|
|
293
|
-
/
|
|
294
|
-
/
|
|
291
|
+
/cook:discuss-phase 2
|
|
292
|
+
/cook:plan-phase 2
|
|
293
|
+
/cook:execute-phase 2
|
|
294
|
+
/cook:verify-work 2
|
|
295
295
|
...
|
|
296
|
-
/
|
|
297
|
-
/
|
|
296
|
+
/cook:complete-milestone
|
|
297
|
+
/cook:new-milestone
|
|
298
298
|
```
|
|
299
299
|
|
|
300
300
|
Loop **discuss → plan → execute → verify** until milestone complete.
|
|
301
301
|
|
|
302
302
|
Each phase gets your input (discuss), proper research (plan), clean execution (execute), and human verification (verify). Context stays fresh. Quality stays high.
|
|
303
303
|
|
|
304
|
-
When all phases are done, `/
|
|
304
|
+
When all phases are done, `/cook:complete-milestone` archives the milestone and tags the release.
|
|
305
305
|
|
|
306
|
-
Then `/
|
|
306
|
+
Then `/cook:new-milestone` starts the next version — same flow as `new-project` but for your existing codebase. You describe what you want to build next, the system researches the domain, you scope requirements, and it creates a fresh roadmap. Each milestone is a clean cycle: define → build → ship.
|
|
307
307
|
|
|
308
308
|
---
|
|
309
309
|
|
|
310
310
|
### Quick Mode
|
|
311
311
|
|
|
312
312
|
```
|
|
313
|
-
/
|
|
313
|
+
/cook:quick
|
|
314
314
|
```
|
|
315
315
|
|
|
316
316
|
**For ad-hoc tasks that don't need full planning.**
|
|
317
317
|
|
|
318
|
-
Quick mode gives you
|
|
318
|
+
Quick mode gives you COOK guarantees (atomic commits, state tracking) with a faster path:
|
|
319
319
|
|
|
320
320
|
- **Same agents** — Planner + executor, same quality
|
|
321
321
|
- **Skips optional steps** — No research, no plan checker, no verifier
|
|
@@ -324,7 +324,7 @@ Quick mode gives you GSD guarantees (atomic commits, state tracking) with a fast
|
|
|
324
324
|
Use for: bug fixes, small features, config changes, one-off tasks.
|
|
325
325
|
|
|
326
326
|
```
|
|
327
|
-
/
|
|
327
|
+
/cook:quick
|
|
328
328
|
> What do you want to do? "Add dark mode toggle to settings"
|
|
329
329
|
```
|
|
330
330
|
|
|
@@ -338,7 +338,7 @@ Use for: bug fixes, small features, config changes, one-off tasks.
|
|
|
338
338
|
|
|
339
339
|
Claude Code is incredibly powerful *if* you give it the context it needs. Most people don't.
|
|
340
340
|
|
|
341
|
-
|
|
341
|
+
COOK handles it for you:
|
|
342
342
|
|
|
343
343
|
| File | What it does |
|
|
344
344
|
|------|--------------|
|
|
@@ -421,57 +421,57 @@ You're never locked in. The system adapts.
|
|
|
421
421
|
|
|
422
422
|
| Command | What it does |
|
|
423
423
|
|---------|--------------|
|
|
424
|
-
| `/
|
|
425
|
-
| `/
|
|
426
|
-
| `/
|
|
427
|
-
| `/
|
|
428
|
-
| `/
|
|
429
|
-
| `/
|
|
430
|
-
| `/
|
|
431
|
-
| `/
|
|
424
|
+
| `/cook:new-project` | Full initialization: questions → research → requirements → roadmap |
|
|
425
|
+
| `/cook:discuss-phase [N]` | Capture implementation decisions before planning |
|
|
426
|
+
| `/cook:plan-phase [N]` | Research + plan + verify for a phase |
|
|
427
|
+
| `/cook:execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
|
|
428
|
+
| `/cook:verify-work [N]` | Manual user acceptance testing ¹ |
|
|
429
|
+
| `/cook:audit-milestone` | Verify milestone achieved its definition of done |
|
|
430
|
+
| `/cook:complete-milestone` | Archive milestone, tag release |
|
|
431
|
+
| `/cook:new-milestone [name]` | Start next version: questions → research → requirements → roadmap |
|
|
432
432
|
|
|
433
433
|
### Navigation
|
|
434
434
|
|
|
435
435
|
| Command | What it does |
|
|
436
436
|
|---------|--------------|
|
|
437
|
-
| `/
|
|
438
|
-
| `/
|
|
439
|
-
| `/
|
|
440
|
-
| `/
|
|
437
|
+
| `/cook:progress` | Where am I? What's next? |
|
|
438
|
+
| `/cook:help` | Show all commands and usage guide |
|
|
439
|
+
| `/cook:update` | Update COOK with changelog preview |
|
|
440
|
+
| `/cook:join-discord` | Join the COOK Discord community |
|
|
441
441
|
|
|
442
442
|
### Brownfield
|
|
443
443
|
|
|
444
444
|
| Command | What it does |
|
|
445
445
|
|---------|--------------|
|
|
446
|
-
| `/
|
|
446
|
+
| `/cook:map-codebase` | Analyze existing codebase before new-project |
|
|
447
447
|
|
|
448
448
|
### Phase Management
|
|
449
449
|
|
|
450
450
|
| Command | What it does |
|
|
451
451
|
|---------|--------------|
|
|
452
|
-
| `/
|
|
453
|
-
| `/
|
|
454
|
-
| `/
|
|
455
|
-
| `/
|
|
456
|
-
| `/
|
|
452
|
+
| `/cook:add-phase` | Append phase to roadmap |
|
|
453
|
+
| `/cook:insert-phase [N]` | Insert urgent work between phases |
|
|
454
|
+
| `/cook:remove-phase [N]` | Remove future phase, renumber |
|
|
455
|
+
| `/cook:list-phase-assumptions [N]` | See Claude's intended approach before planning |
|
|
456
|
+
| `/cook:plan-milestone-gaps` | Create phases to close gaps from audit |
|
|
457
457
|
|
|
458
458
|
### Session
|
|
459
459
|
|
|
460
460
|
| Command | What it does |
|
|
461
461
|
|---------|--------------|
|
|
462
|
-
| `/
|
|
463
|
-
| `/
|
|
462
|
+
| `/cook:pause-work` | Create handoff when stopping mid-phase |
|
|
463
|
+
| `/cook:resume-work` | Restore from last session |
|
|
464
464
|
|
|
465
465
|
### Utilities
|
|
466
466
|
|
|
467
467
|
| Command | What it does |
|
|
468
468
|
|---------|--------------|
|
|
469
|
-
| `/
|
|
470
|
-
| `/
|
|
471
|
-
| `/
|
|
472
|
-
| `/
|
|
473
|
-
| `/
|
|
474
|
-
| `/
|
|
469
|
+
| `/cook:settings` | Configure model profile and workflow agents |
|
|
470
|
+
| `/cook:set-profile <profile>` | Switch model profile (quality/balanced/budget) |
|
|
471
|
+
| `/cook:add-todo [desc]` | Capture idea for later |
|
|
472
|
+
| `/cook:check-todos` | List pending todos |
|
|
473
|
+
| `/cook:debug [desc]` | Systematic debugging with persistent state |
|
|
474
|
+
| `/cook:quick` | Execute ad-hoc task with COOK guarantees |
|
|
475
475
|
|
|
476
476
|
<sup>¹ Contributed by reddit user OracleGreyBeard</sup>
|
|
477
477
|
|
|
@@ -479,7 +479,7 @@ You're never locked in. The system adapts.
|
|
|
479
479
|
|
|
480
480
|
## Configuration
|
|
481
481
|
|
|
482
|
-
|
|
482
|
+
COOK stores project settings in `.planning/config.json`. Configure during `/cook:new-project` or update later with `/cook:settings`.
|
|
483
483
|
|
|
484
484
|
### Core Settings
|
|
485
485
|
|
|
@@ -500,10 +500,10 @@ Control which Claude model each agent uses. Balance quality vs token spend.
|
|
|
500
500
|
|
|
501
501
|
Switch profiles:
|
|
502
502
|
```
|
|
503
|
-
/
|
|
503
|
+
/cook:set-profile budget
|
|
504
504
|
```
|
|
505
505
|
|
|
506
|
-
Or configure via `/
|
|
506
|
+
Or configure via `/cook:settings`.
|
|
507
507
|
|
|
508
508
|
### Workflow Agents
|
|
509
509
|
|
|
@@ -515,9 +515,9 @@ These spawn additional agents during planning/execution. They improve quality bu
|
|
|
515
515
|
| `workflow.plan_check` | `true` | Verifies plans achieve phase goals before execution |
|
|
516
516
|
| `workflow.verifier` | `true` | Confirms must-haves were delivered after execution |
|
|
517
517
|
|
|
518
|
-
Use `/
|
|
519
|
-
- `/
|
|
520
|
-
- `/
|
|
518
|
+
Use `/cook:settings` to toggle these, or override per-invocation:
|
|
519
|
+
- `/cook:plan-phase --skip-research`
|
|
520
|
+
- `/cook:plan-phase --skip-verify`
|
|
521
521
|
|
|
522
522
|
### Execution
|
|
523
523
|
|
|
@@ -532,10 +532,10 @@ Use `/gsd:settings` to toggle these, or override per-invocation:
|
|
|
532
532
|
|
|
533
533
|
**Commands not found after install?**
|
|
534
534
|
- Restart Claude Code to reload slash commands
|
|
535
|
-
- Verify files exist in `~/.claude/commands/
|
|
535
|
+
- Verify files exist in `~/.claude/commands/cook/` (global) or `./.claude/commands/cook/` (local)
|
|
536
536
|
|
|
537
537
|
**Commands not working as expected?**
|
|
538
|
-
- Run `/
|
|
538
|
+
- Run `/cook:help` to verify installation
|
|
539
539
|
- Re-run `npx claude-cook` to reinstall
|
|
540
540
|
|
|
541
541
|
**Updating to the latest version?**
|
|
@@ -553,7 +553,7 @@ This ensures absolute paths are used instead of `~` which may not expand correct
|
|
|
553
553
|
|
|
554
554
|
### Uninstalling
|
|
555
555
|
|
|
556
|
-
To remove
|
|
556
|
+
To remove COOK completely:
|
|
557
557
|
|
|
558
558
|
```bash
|
|
559
559
|
# Global installs
|
|
@@ -565,7 +565,7 @@ npx claude-cook --claude --local --uninstall
|
|
|
565
565
|
npx claude-cook --opencode --local --uninstall
|
|
566
566
|
```
|
|
567
567
|
|
|
568
|
-
This removes all
|
|
568
|
+
This removes all COOK commands, agents, hooks, and settings while preserving your other configurations.
|
|
569
569
|
|
|
570
570
|
---
|
|
571
571
|
|
|
@@ -577,18 +577,18 @@ These community ports pioneered multi-runtime support:
|
|
|
577
577
|
|
|
578
578
|
| Project | Platform | Description |
|
|
579
579
|
|---------|----------|-------------|
|
|
580
|
-
| [
|
|
581
|
-
| [
|
|
580
|
+
| [cook-opencode](https://github.com/rokicool/cook-opencode) | OpenCode | Original OpenCode adaptation |
|
|
581
|
+
| [cook-gemini](https://github.com/uberfuzzy/cook-gemini) | Gemini CLI | Original Gemini adaptation |
|
|
582
582
|
|
|
583
583
|
---
|
|
584
584
|
|
|
585
585
|
## Star History
|
|
586
586
|
|
|
587
|
-
<a href="https://star-history.com/#glittercowboy/
|
|
587
|
+
<a href="https://star-history.com/#glittercowboy/cook&Date">
|
|
588
588
|
<picture>
|
|
589
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=glittercowboy/
|
|
590
|
-
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=glittercowboy/
|
|
591
|
-
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=glittercowboy/
|
|
589
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=glittercowboy/cook&type=Date&theme=dark" />
|
|
590
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=glittercowboy/cook&type=Date" />
|
|
591
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=glittercowboy/cook&type=Date" />
|
|
592
592
|
</picture>
|
|
593
593
|
</a>
|
|
594
594
|
|
|
@@ -602,6 +602,6 @@ MIT License. See [LICENSE](LICENSE) for details.
|
|
|
602
602
|
|
|
603
603
|
<div align="center">
|
|
604
604
|
|
|
605
|
-
**Claude Code is powerful.
|
|
605
|
+
**Claude Code is powerful. COOK makes it reliable.**
|
|
606
606
|
|
|
607
607
|
</div>
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: cook-codebase-mapper
|
|
3
3
|
description: Explores codebase and writes structured analysis documents. Spawned by map-codebase with a focus area (tech, arch, quality, concerns). Writes documents directly to reduce orchestrator context load.
|
|
4
4
|
tools: Read, Bash, Grep, Glob, Write
|
|
5
5
|
color: cyan
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are a
|
|
9
|
+
You are a COOK codebase mapper. You explore a codebase for a specific focus area and write analysis documents directly to `.planning/codebase/`.
|
|
10
10
|
|
|
11
|
-
You are spawned by `/
|
|
11
|
+
You are spawned by `/cook:map-codebase` with one of four focus areas:
|
|
12
12
|
- **tech**: Analyze technology stack and external integrations → write STACK.md and INTEGRATIONS.md
|
|
13
13
|
- **arch**: Analyze architecture and file structure → write ARCHITECTURE.md and STRUCTURE.md
|
|
14
14
|
- **quality**: Analyze coding conventions and testing patterns → write CONVENTIONS.md and TESTING.md
|
|
@@ -18,9 +18,9 @@ Your job: Explore thoroughly, then write document(s) directly. Return confirmati
|
|
|
18
18
|
</role>
|
|
19
19
|
|
|
20
20
|
<why_this_matters>
|
|
21
|
-
**These documents are consumed by other
|
|
21
|
+
**These documents are consumed by other COOK commands:**
|
|
22
22
|
|
|
23
|
-
**`/
|
|
23
|
+
**`/cook:plan-phase`** loads relevant codebase docs when creating implementation plans:
|
|
24
24
|
| Phase Type | Documents Loaded |
|
|
25
25
|
|------------|------------------|
|
|
26
26
|
| UI, frontend, components | CONVENTIONS.md, STRUCTURE.md |
|
|
@@ -31,7 +31,7 @@ Your job: Explore thoroughly, then write document(s) directly. Return confirmati
|
|
|
31
31
|
| refactor, cleanup | CONCERNS.md, ARCHITECTURE.md |
|
|
32
32
|
| setup, config | STACK.md, STRUCTURE.md |
|
|
33
33
|
|
|
34
|
-
**`/
|
|
34
|
+
**`/cook:execute-phase`** references codebase docs to:
|
|
35
35
|
- Follow existing conventions when writing code
|
|
36
36
|
- Know where to place new files (STRUCTURE.md)
|
|
37
37
|
- Match testing patterns (TESTING.md)
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
3
|
-
description: Investigates bugs using scientific method, manages debug sessions, handles checkpoints. Spawned by /
|
|
2
|
+
name: cook-debugger
|
|
3
|
+
description: Investigates bugs using scientific method, manages debug sessions, handles checkpoints. Spawned by /cook:debug orchestrator.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
|
|
5
5
|
color: orange
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are a
|
|
9
|
+
You are a COOK debugger. You investigate bugs using systematic scientific method, manage persistent debug sessions, and handle checkpoints when user input is needed.
|
|
10
10
|
|
|
11
11
|
You are spawned by:
|
|
12
12
|
|
|
13
|
-
- `/
|
|
13
|
+
- `/cook:debug` command (interactive debugging)
|
|
14
14
|
- `diagnose-issues` workflow (parallel UAT diagnosis)
|
|
15
15
|
|
|
16
16
|
Your job: Find the root cause through hypothesis testing, maintain debug file state, optionally fix and verify (depending on mode).
|
|
@@ -894,7 +894,7 @@ Gather symptoms through questioning. Update file after EACH answer.
|
|
|
894
894
|
- Otherwise -> proceed to fix_and_verify
|
|
895
895
|
- **ELIMINATED:** Append to Eliminated section, form new hypothesis, return to Phase 2
|
|
896
896
|
|
|
897
|
-
**Context management:** After 5+ evidence entries, ensure Current Focus is updated. Suggest "/clear - run /
|
|
897
|
+
**Context management:** After 5+ evidence entries, ensure Current Focus is updated. Suggest "/clear - run /cook:debug to resume" if context filling up.
|
|
898
898
|
</step>
|
|
899
899
|
|
|
900
900
|
<step name="resume_from_file">
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
3
|
-
description: Executes
|
|
2
|
+
name: cook-executor
|
|
3
|
+
description: Executes COOK plans with atomic commits, deviation handling, checkpoint protocols, and state management. Spawned by execute-phase orchestrator or execute-plan command.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Grep, Glob
|
|
5
5
|
color: yellow
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are a
|
|
9
|
+
You are a COOK plan executor. You execute PLAN.md files atomically, creating per-task commits, handling deviations automatically, pausing at checkpoints, and producing SUMMARY.md files.
|
|
10
10
|
|
|
11
|
-
You are spawned by `/
|
|
11
|
+
You are spawned by `/cook:execute-phase` orchestrator.
|
|
12
12
|
|
|
13
13
|
Your job: Execute the plan completely, commit each task, create SUMMARY.md, update STATE.md.
|
|
14
14
|
</role>
|
|
@@ -353,7 +353,7 @@ Type "done" when authenticated.
|
|
|
353
353
|
Before any `checkpoint:human-verify`, ensure verification environment is ready. If plan lacks server startup task before checkpoint, ADD ONE (deviation Rule 3).
|
|
354
354
|
|
|
355
355
|
For full automation-first patterns, server lifecycle, CLI handling, and error recovery:
|
|
356
|
-
**See @~/.claude/
|
|
356
|
+
**See @~/.claude/cook/references/checkpoints.md**
|
|
357
357
|
|
|
358
358
|
**Quick reference:**
|
|
359
359
|
- Users NEVER run CLI commands - Claude does all automation
|
|
@@ -610,7 +610,7 @@ After all tasks complete, create `{phase}-{plan}-SUMMARY.md`.
|
|
|
610
610
|
|
|
611
611
|
**Location:** `.planning/phases/XX-name/{phase}-{plan}-SUMMARY.md`
|
|
612
612
|
|
|
613
|
-
**Use template from:** @~/.claude/
|
|
613
|
+
**Use template from:** @~/.claude/cook/templates/summary.md
|
|
614
614
|
|
|
615
615
|
**Frontmatter population:**
|
|
616
616
|
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
3
|
-
description: Researches how to implement a phase before planning. Produces RESEARCH.md consumed by
|
|
2
|
+
name: cook-phase-researcher
|
|
3
|
+
description: Researches how to implement a phase before planning. Produces RESEARCH.md consumed by cook-planner. Spawned by /cook:plan-phase orchestrator.
|
|
4
4
|
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
|
|
5
5
|
color: cyan
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are a
|
|
9
|
+
You are a COOK phase researcher. You research how to implement a specific phase well, producing findings that directly inform planning.
|
|
10
10
|
|
|
11
11
|
You are spawned by:
|
|
12
12
|
|
|
13
|
-
- `/
|
|
14
|
-
- `/
|
|
13
|
+
- `/cook:plan-phase` orchestrator (integrated research before planning)
|
|
14
|
+
- `/cook:research-phase` orchestrator (standalone research)
|
|
15
15
|
|
|
16
16
|
Your job: Answer "What do I need to know to PLAN this phase well?" Produce a single RESEARCH.md file that the planner consumes immediately.
|
|
17
17
|
|
|
@@ -24,7 +24,7 @@ Your job: Answer "What do I need to know to PLAN this phase well?" Produce a sin
|
|
|
24
24
|
</role>
|
|
25
25
|
|
|
26
26
|
<upstream_input>
|
|
27
|
-
**CONTEXT.md** (if exists) — User decisions from `/
|
|
27
|
+
**CONTEXT.md** (if exists) — User decisions from `/cook:discuss-phase`
|
|
28
28
|
|
|
29
29
|
| Section | How You Use It |
|
|
30
30
|
|---------|----------------|
|
|
@@ -36,7 +36,7 @@ If CONTEXT.md exists, it constrains your research scope. Don't explore alternati
|
|
|
36
36
|
</upstream_input>
|
|
37
37
|
|
|
38
38
|
<downstream_consumer>
|
|
39
|
-
Your RESEARCH.md is consumed by `
|
|
39
|
+
Your RESEARCH.md is consumed by `cook-planner` which uses specific sections:
|
|
40
40
|
|
|
41
41
|
| Section | How Planner Uses It |
|
|
42
42
|
|---------|---------------------|
|
|
@@ -448,7 +448,7 @@ Orchestrator provides:
|
|
|
448
448
|
PADDED_PHASE=$(printf "%02d" $PHASE 2>/dev/null || echo "$PHASE")
|
|
449
449
|
PHASE_DIR=$(ls -d .planning/phases/$PADDED_PHASE-* .planning/phases/$PHASE-* 2>/dev/null | head -1)
|
|
450
450
|
|
|
451
|
-
# Read CONTEXT.md if exists (from /
|
|
451
|
+
# Read CONTEXT.md if exists (from /cook:discuss-phase)
|
|
452
452
|
cat "$PHASE_DIR"/*-CONTEXT.md 2>/dev/null
|
|
453
453
|
|
|
454
454
|
# Check if planning docs should be committed (default: true)
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
3
|
-
description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /
|
|
2
|
+
name: cook-plan-checker
|
|
3
|
+
description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /cook:plan-phase orchestrator.
|
|
4
4
|
tools: Read, Bash, Glob, Grep
|
|
5
5
|
color: green
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
<role>
|
|
9
|
-
You are a
|
|
9
|
+
You are a COOK plan checker. You verify that plans WILL achieve the phase goal, not just that they look complete.
|
|
10
10
|
|
|
11
11
|
You are spawned by:
|
|
12
12
|
|
|
13
|
-
- `/
|
|
13
|
+
- `/cook:plan-phase` orchestrator (after planner creates PLAN.md files)
|
|
14
14
|
- Re-verification (after planner revises based on your feedback)
|
|
15
15
|
|
|
16
16
|
Your job: Goal-backward verification of PLANS before execution. Start from what the phase SHOULD deliver, verify the plans address it.
|
|
@@ -41,8 +41,8 @@ Goal-backward plan verification starts from the outcome and works backwards:
|
|
|
41
41
|
Then verify each level against the actual plan files.
|
|
42
42
|
|
|
43
43
|
**The difference:**
|
|
44
|
-
- `
|
|
45
|
-
- `
|
|
44
|
+
- `cook-verifier`: Verifies code DID achieve goal (after execution)
|
|
45
|
+
- `cook-plan-checker`: Verifies plans WILL achieve goal (before execution)
|
|
46
46
|
|
|
47
47
|
Same methodology (goal-backward), different timing, different subject matter.
|
|
48
48
|
</core_principle>
|
|
@@ -658,7 +658,7 @@ When all checks pass:
|
|
|
658
658
|
|
|
659
659
|
### Ready for Execution
|
|
660
660
|
|
|
661
|
-
Plans verified. Run `/
|
|
661
|
+
Plans verified. Run `/cook:execute-phase {phase}` to proceed.
|
|
662
662
|
```
|
|
663
663
|
|
|
664
664
|
## ISSUES FOUND
|
|
@@ -709,7 +709,7 @@ issues:
|
|
|
709
709
|
|
|
710
710
|
<anti_patterns>
|
|
711
711
|
|
|
712
|
-
**DO NOT check code existence.** That's
|
|
712
|
+
**DO NOT check code existence.** That's cook-verifier's job after execution. You verify plans, not codebase.
|
|
713
713
|
|
|
714
714
|
**DO NOT run the application.** This is static plan analysis. No `npm start`, no `curl` to running server.
|
|
715
715
|
|