@howlil/ez-agents 2.0.0 → 2.0.1
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/LICENSE +21 -21
- package/README.md +93 -93
- package/agents/ez-plan-checker.md +2 -2
- package/agents/ez-research-synthesizer.md +1 -1
- package/agents/ez-ui-researcher.md +1 -1
- package/agents/ez-verifier.md +1 -1
- package/bin/install.js +132 -132
- package/get-shit-done/bin/lib/assistant-adapter.cjs +205 -205
- package/get-shit-done/bin/lib/audit-exec.cjs +150 -150
- package/get-shit-done/bin/lib/auth.cjs +175 -175
- package/get-shit-done/bin/lib/circuit-breaker.cjs +118 -118
- package/get-shit-done/bin/lib/commands.cjs +666 -666
- package/get-shit-done/bin/lib/config.cjs +183 -183
- package/get-shit-done/bin/lib/core.cjs +495 -495
- package/get-shit-done/bin/lib/file-lock.cjs +236 -236
- package/get-shit-done/bin/lib/frontmatter.cjs +299 -299
- package/get-shit-done/bin/lib/fs-utils.cjs +153 -153
- package/get-shit-done/bin/lib/git-utils.cjs +203 -203
- package/get-shit-done/bin/lib/health-check.cjs +163 -163
- package/get-shit-done/bin/lib/index.cjs +113 -113
- package/get-shit-done/bin/lib/init.cjs +710 -710
- package/get-shit-done/bin/lib/logger.cjs +117 -117
- package/get-shit-done/bin/lib/milestone.cjs +241 -241
- package/get-shit-done/bin/lib/model-provider.cjs +146 -146
- package/get-shit-done/bin/lib/phase.cjs +908 -908
- package/get-shit-done/bin/lib/retry.cjs +119 -119
- package/get-shit-done/bin/lib/roadmap.cjs +305 -305
- package/get-shit-done/bin/lib/safe-exec.cjs +128 -128
- package/get-shit-done/bin/lib/safe-path.cjs +130 -130
- package/get-shit-done/bin/lib/state.cjs +721 -721
- package/get-shit-done/bin/lib/temp-file.cjs +239 -239
- package/get-shit-done/bin/lib/template.cjs +222 -222
- package/get-shit-done/bin/lib/test-file-lock.cjs +112 -112
- package/get-shit-done/bin/lib/test-graceful.cjs +93 -93
- package/get-shit-done/bin/lib/test-logger.cjs +60 -60
- package/get-shit-done/bin/lib/test-safe-exec.cjs +38 -38
- package/get-shit-done/bin/lib/test-safe-path.cjs +33 -33
- package/get-shit-done/bin/lib/test-temp-file.cjs +125 -125
- package/get-shit-done/bin/lib/timeout-exec.cjs +62 -62
- package/get-shit-done/bin/lib/verify.cjs +820 -820
- package/get-shit-done/references/checkpoints.md +776 -776
- package/get-shit-done/references/questioning.md +162 -162
- package/get-shit-done/references/tdd.md +263 -263
- package/get-shit-done/templates/codebase/concerns.md +310 -310
- package/get-shit-done/templates/codebase/conventions.md +307 -307
- package/get-shit-done/templates/codebase/integrations.md +280 -280
- package/get-shit-done/templates/codebase/stack.md +186 -186
- package/get-shit-done/templates/codebase/testing.md +480 -480
- package/get-shit-done/templates/config.json +37 -37
- package/get-shit-done/templates/continue-here.md +78 -78
- package/get-shit-done/templates/milestone-archive.md +123 -123
- package/get-shit-done/templates/milestone.md +115 -115
- package/get-shit-done/templates/requirements.md +231 -231
- package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -204
- package/get-shit-done/templates/research-project/FEATURES.md +147 -147
- package/get-shit-done/templates/research-project/PITFALLS.md +200 -200
- package/get-shit-done/templates/research-project/STACK.md +120 -120
- package/get-shit-done/templates/research-project/SUMMARY.md +170 -170
- package/get-shit-done/templates/retrospective.md +54 -54
- package/get-shit-done/templates/roadmap.md +202 -202
- package/get-shit-done/templates/summary-minimal.md +41 -41
- package/get-shit-done/templates/summary-standard.md +48 -48
- package/get-shit-done/templates/summary.md +248 -248
- package/get-shit-done/templates/user-setup.md +311 -311
- package/get-shit-done/templates/verification-report.md +322 -322
- package/get-shit-done/workflows/add-phase.md +112 -112
- package/get-shit-done/workflows/add-tests.md +351 -351
- package/get-shit-done/workflows/add-todo.md +158 -158
- package/get-shit-done/workflows/audit-milestone.md +332 -332
- package/get-shit-done/workflows/autonomous.md +743 -743
- package/get-shit-done/workflows/check-todos.md +177 -177
- package/get-shit-done/workflows/cleanup.md +152 -152
- package/get-shit-done/workflows/complete-milestone.md +766 -766
- package/get-shit-done/workflows/diagnose-issues.md +219 -219
- package/get-shit-done/workflows/discovery-phase.md +289 -289
- package/get-shit-done/workflows/discuss-phase.md +762 -762
- package/get-shit-done/workflows/execute-phase.md +468 -468
- package/get-shit-done/workflows/execute-plan.md +483 -483
- package/get-shit-done/workflows/health.md +159 -159
- package/get-shit-done/workflows/help.md +492 -492
- package/get-shit-done/workflows/insert-phase.md +130 -130
- package/get-shit-done/workflows/list-phase-assumptions.md +178 -178
- package/get-shit-done/workflows/map-codebase.md +316 -316
- package/get-shit-done/workflows/new-milestone.md +384 -384
- package/get-shit-done/workflows/new-project.md +1111 -1111
- package/get-shit-done/workflows/node-repair.md +92 -92
- package/get-shit-done/workflows/pause-work.md +122 -122
- package/get-shit-done/workflows/plan-milestone-gaps.md +274 -274
- package/get-shit-done/workflows/plan-phase.md +651 -651
- package/get-shit-done/workflows/progress.md +382 -382
- package/get-shit-done/workflows/quick.md +610 -610
- package/get-shit-done/workflows/remove-phase.md +155 -155
- package/get-shit-done/workflows/research-phase.md +74 -74
- package/get-shit-done/workflows/resume-project.md +307 -307
- package/get-shit-done/workflows/set-profile.md +81 -81
- package/get-shit-done/workflows/settings.md +242 -242
- package/get-shit-done/workflows/stats.md +57 -57
- package/get-shit-done/workflows/transition.md +544 -544
- package/get-shit-done/workflows/ui-phase.md +290 -290
- package/get-shit-done/workflows/ui-review.md +157 -157
- package/get-shit-done/workflows/update.md +320 -320
- package/get-shit-done/workflows/validate-phase.md +167 -167
- package/get-shit-done/workflows/verify-phase.md +243 -243
- package/package.json +1 -1
- package/scripts/build-hooks.js +43 -43
- package/scripts/run-tests.cjs +29 -29
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 Lex Christopherson
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Lex Christopherson
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
**English** · [简体中文](README.zh-CN.md)
|
|
8
8
|
|
|
9
|
-
**An independent fork of GSD with multi-model support (Qwen, Kimi, OpenAI, Claude) and enhanced reliability features.**
|
|
9
|
+
**An independent fork of GSD (Get Shit Done) with multi-model support (Qwen, Kimi, OpenAI, Claude) and enhanced reliability features.**
|
|
10
10
|
|
|
11
11
|
**Solves context rot — with added security, error handling, and cross-platform support.**
|
|
12
12
|
|
|
@@ -24,7 +24,7 @@ npx github:howlil/ez-agents
|
|
|
24
24
|
|
|
25
25
|
<br>
|
|
26
26
|
|
|
27
|
-
**Original GSD by** [TÂCHES](https://github.com/glittercowboy/get-shit-done) | **EZ Agents Fork by** [@howlil](https://github.com/howlil)
|
|
27
|
+
**Original GSD (Get Shit Done) by** [TÂCHES](https://github.com/glittercowboy/get-shit-done) | **EZ Agents Fork by** [@howlil](https://github.com/howlil)
|
|
28
28
|
|
|
29
29
|
<br>
|
|
30
30
|
|
|
@@ -44,17 +44,17 @@ npx github:howlil/ez-agents
|
|
|
44
44
|
|
|
45
45
|
## 🚀 What's New in EZ Agents
|
|
46
46
|
|
|
47
|
-
> **Note:** This is an **independent fork** of GSD. Not affiliated with the original GSD project.
|
|
47
|
+
> **Note:** This is an **independent fork** of GSD (Get Shit Done). Not affiliated with the original GSD project.
|
|
48
48
|
>
|
|
49
|
-
> **Original GSD:** [glittercowboy/get-shit-done](https://github.com/glittercowboy/get-shit-done) by TÂCHES
|
|
49
|
+
> **Original GSD (Get Shit Done):** [glittercowboy/get-shit-done](https://github.com/glittercowboy/get-shit-done) by TÂCHES
|
|
50
50
|
>
|
|
51
51
|
> **This Fork:** [howlil/ez-agents](https://github.com/howlil/ez-agents) with multi-model support & enhancements
|
|
52
52
|
|
|
53
|
-
**EZ Agents** adds **multi-model support** and **enterprise-grade reliability** to GSD.
|
|
53
|
+
**EZ Agents** adds **multi-model support** and **enterprise-grade reliability** to GSD (Get Shit Done).
|
|
54
54
|
|
|
55
55
|
### Why This Fork Exists
|
|
56
56
|
|
|
57
|
-
I needed GSD to work with multiple AI providers (not just Anthropic) and run reliably on Windows. This fork adds:
|
|
57
|
+
I needed GSD (Get Shit Done) to work with multiple AI providers (not just Anthropic) and run reliably on Windows. This fork adds:
|
|
58
58
|
|
|
59
59
|
- 🌍 **Multi-Model**: Qwen (Alibaba), Kimi (Moonshot), OpenAI, and Anthropic
|
|
60
60
|
- 🔒 **Security**: Command injection prevention, path validation, audit logging
|
|
@@ -64,8 +64,8 @@ I needed GSD to work with multiple AI providers (not just Anthropic) and run rel
|
|
|
64
64
|
|
|
65
65
|
### Features Comparison
|
|
66
66
|
|
|
67
|
-
| Feature | Original GSD | EZ Agents Fork |
|
|
68
|
-
|
|
67
|
+
| Feature | Original GSD (Get Shit Done) | EZ Agents Fork |
|
|
68
|
+
|---------|------------------------------|-----------|
|
|
69
69
|
| **Multi-Model** | Anthropic only | ✓ Anthropic, Qwen, Kimi, OpenAI |
|
|
70
70
|
| **Security** | Basic | ✓ Command allowlist, path validation, audit log |
|
|
71
71
|
| **Error Handling** | Basic | ✓ Retry with backoff, circuit breaker |
|
|
@@ -124,9 +124,9 @@ Configure different AI providers per agent:
|
|
|
124
124
|
}
|
|
125
125
|
},
|
|
126
126
|
"agent_overrides": {
|
|
127
|
-
"
|
|
128
|
-
"
|
|
129
|
-
"
|
|
127
|
+
"ez-planner": { "provider": "alibaba", "model": "qwen-max" },
|
|
128
|
+
"ez-executor": { "provider": "anthropic", "model": "sonnet" },
|
|
129
|
+
"ez-verifier": { "provider": "moonshot", "model": "balanced" }
|
|
130
130
|
}
|
|
131
131
|
}
|
|
132
132
|
```
|
|
@@ -189,7 +189,7 @@ I'm a solo developer. I don't write code — Claude Code does.
|
|
|
189
189
|
|
|
190
190
|
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.
|
|
191
191
|
|
|
192
|
-
So I built
|
|
192
|
+
So I built EZ Agents. 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.
|
|
193
193
|
|
|
194
194
|
The system gives Claude everything it needs to do the work *and* verify it. I trust the workflow. It just does a good job.
|
|
195
195
|
|
|
@@ -201,7 +201,7 @@ That's what this is. No enterprise roleplay bullshit. Just an incredibly effecti
|
|
|
201
201
|
|
|
202
202
|
Vibecoding has a bad reputation. You describe what you want, AI generates code, and you get inconsistent garbage that falls apart at scale.
|
|
203
203
|
|
|
204
|
-
|
|
204
|
+
EZ Agents 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.
|
|
205
205
|
|
|
206
206
|
---
|
|
207
207
|
|
|
@@ -281,14 +281,14 @@ Installs to `./.claude/` for testing modifications before contributing.
|
|
|
281
281
|
|
|
282
282
|
### Recommended: Skip Permissions Mode
|
|
283
283
|
|
|
284
|
-
|
|
284
|
+
EZ Agents is designed for frictionless automation. Run Claude Code with:
|
|
285
285
|
|
|
286
286
|
```bash
|
|
287
287
|
claude --dangerously-skip-permissions
|
|
288
288
|
```
|
|
289
289
|
|
|
290
290
|
> [!TIP]
|
|
291
|
-
> This is how
|
|
291
|
+
> This is how EZ Agents is intended to be used — stopping to approve `date` and `git commit` 50 times defeats the purpose.
|
|
292
292
|
|
|
293
293
|
<details>
|
|
294
294
|
<summary><strong>Alternative: Granular Permissions</strong></summary>
|
|
@@ -327,12 +327,12 @@ If you prefer not to use that flag, add this to your project's `.claude/settings
|
|
|
327
327
|
|
|
328
328
|
## How It Works
|
|
329
329
|
|
|
330
|
-
> **Already have code?** Run `/
|
|
330
|
+
> **Already have code?** Run `/ez:map-codebase` first. It spawns parallel agents to analyze your stack, architecture, conventions, and concerns. Then `/ez:new-project` knows your codebase — questions focus on what you're adding, and planning automatically loads your patterns.
|
|
331
331
|
|
|
332
332
|
### 1. Initialize Project
|
|
333
333
|
|
|
334
334
|
```
|
|
335
|
-
/
|
|
335
|
+
/ez:new-project
|
|
336
336
|
```
|
|
337
337
|
|
|
338
338
|
One command, one flow. The system:
|
|
@@ -351,7 +351,7 @@ You approve the roadmap. Now you're ready to build.
|
|
|
351
351
|
### 2. Discuss Phase
|
|
352
352
|
|
|
353
353
|
```
|
|
354
|
-
/
|
|
354
|
+
/ez:discuss-phase 1
|
|
355
355
|
```
|
|
356
356
|
|
|
357
357
|
**This is where you shape the implementation.**
|
|
@@ -379,7 +379,7 @@ The deeper you go here, the more the system builds what you actually want. Skip
|
|
|
379
379
|
### 3. Plan Phase
|
|
380
380
|
|
|
381
381
|
```
|
|
382
|
-
/
|
|
382
|
+
/ez:plan-phase 1
|
|
383
383
|
```
|
|
384
384
|
|
|
385
385
|
The system:
|
|
@@ -397,7 +397,7 @@ Each plan is small enough to execute in a fresh context window. No degradation,
|
|
|
397
397
|
### 4. Execute Phase
|
|
398
398
|
|
|
399
399
|
```
|
|
400
|
-
/
|
|
400
|
+
/ez:execute-phase 1
|
|
401
401
|
```
|
|
402
402
|
|
|
403
403
|
The system:
|
|
@@ -448,7 +448,7 @@ This is why "vertical slices" (Plan 01: User feature end-to-end) parallelize bet
|
|
|
448
448
|
### 5. Verify Work
|
|
449
449
|
|
|
450
450
|
```
|
|
451
|
-
/
|
|
451
|
+
/ez:verify-work 1
|
|
452
452
|
```
|
|
453
453
|
|
|
454
454
|
**This is where you confirm it actually works.**
|
|
@@ -462,7 +462,7 @@ The system:
|
|
|
462
462
|
3. **Diagnoses failures automatically** — Spawns debug agents to find root causes
|
|
463
463
|
4. **Creates verified fix plans** — Ready for immediate re-execution
|
|
464
464
|
|
|
465
|
-
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/
|
|
465
|
+
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/ez:execute-phase` again with the fix plans it created.
|
|
466
466
|
|
|
467
467
|
**Creates:** `{phase_num}-UAT.md`, fix plans if issues found
|
|
468
468
|
|
|
@@ -471,36 +471,36 @@ If everything passes, you move on. If something's broken, you don't manually deb
|
|
|
471
471
|
### 6. Repeat → Complete → Next Milestone
|
|
472
472
|
|
|
473
473
|
```
|
|
474
|
-
/
|
|
475
|
-
/
|
|
476
|
-
/
|
|
477
|
-
/
|
|
474
|
+
/ez:discuss-phase 2
|
|
475
|
+
/ez:plan-phase 2
|
|
476
|
+
/ez:execute-phase 2
|
|
477
|
+
/ez:verify-work 2
|
|
478
478
|
...
|
|
479
|
-
/
|
|
480
|
-
/
|
|
479
|
+
/ez:complete-milestone
|
|
480
|
+
/ez:new-milestone
|
|
481
481
|
```
|
|
482
482
|
|
|
483
483
|
Loop **discuss → plan → execute → verify** until milestone complete.
|
|
484
484
|
|
|
485
|
-
If you want faster intake during discussion, use `/
|
|
485
|
+
If you want faster intake during discussion, use `/ez:discuss-phase <n> --batch` to answer a small grouped set of questions at once instead of one-by-one.
|
|
486
486
|
|
|
487
487
|
Each phase gets your input (discuss), proper research (plan), clean execution (execute), and human verification (verify). Context stays fresh. Quality stays high.
|
|
488
488
|
|
|
489
|
-
When all phases are done, `/
|
|
489
|
+
When all phases are done, `/ez:complete-milestone` archives the milestone and tags the release.
|
|
490
490
|
|
|
491
|
-
Then `/
|
|
491
|
+
Then `/ez: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.
|
|
492
492
|
|
|
493
493
|
---
|
|
494
494
|
|
|
495
495
|
### Quick Mode
|
|
496
496
|
|
|
497
497
|
```
|
|
498
|
-
/
|
|
498
|
+
/ez:quick
|
|
499
499
|
```
|
|
500
500
|
|
|
501
501
|
**For ad-hoc tasks that don't need full planning.**
|
|
502
502
|
|
|
503
|
-
Quick mode gives you
|
|
503
|
+
Quick mode gives you EZ Agents guarantees (atomic commits, state tracking) with a faster path:
|
|
504
504
|
|
|
505
505
|
- **Same agents** — Planner + executor, same quality
|
|
506
506
|
- **Skips optional steps** — No research, no plan checker, no verifier
|
|
@@ -509,7 +509,7 @@ Quick mode gives you GSD guarantees (atomic commits, state tracking) with a fast
|
|
|
509
509
|
Use for: bug fixes, small features, config changes, one-off tasks.
|
|
510
510
|
|
|
511
511
|
```
|
|
512
|
-
/
|
|
512
|
+
/ez:quick
|
|
513
513
|
> What do you want to do? "Add dark mode toggle to settings"
|
|
514
514
|
```
|
|
515
515
|
|
|
@@ -523,7 +523,7 @@ Use for: bug fixes, small features, config changes, one-off tasks.
|
|
|
523
523
|
|
|
524
524
|
Claude Code is incredibly powerful *if* you give it the context it needs. Most people don't.
|
|
525
525
|
|
|
526
|
-
|
|
526
|
+
EZ Agents handles it for you:
|
|
527
527
|
|
|
528
528
|
| File | What it does |
|
|
529
529
|
|------|--------------|
|
|
@@ -606,58 +606,58 @@ You're never locked in. The system adapts.
|
|
|
606
606
|
|
|
607
607
|
| Command | What it does |
|
|
608
608
|
|---------|--------------|
|
|
609
|
-
| `/
|
|
610
|
-
| `/
|
|
611
|
-
| `/
|
|
612
|
-
| `/
|
|
613
|
-
| `/
|
|
614
|
-
| `/
|
|
615
|
-
| `/
|
|
616
|
-
| `/
|
|
609
|
+
| `/ez:new-project [--auto]` | Full initialization: questions → research → requirements → roadmap |
|
|
610
|
+
| `/ez:discuss-phase [N] [--auto]` | Capture implementation decisions before planning |
|
|
611
|
+
| `/ez:plan-phase [N] [--auto]` | Research + plan + verify for a phase |
|
|
612
|
+
| `/ez:execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
|
|
613
|
+
| `/ez:verify-work [N]` | Manual user acceptance testing ¹ |
|
|
614
|
+
| `/ez:audit-milestone` | Verify milestone achieved its definition of done |
|
|
615
|
+
| `/ez:complete-milestone` | Archive milestone, tag release |
|
|
616
|
+
| `/ez:new-milestone [name]` | Start next version: questions → research → requirements → roadmap |
|
|
617
617
|
|
|
618
618
|
### Navigation
|
|
619
619
|
|
|
620
620
|
| Command | What it does |
|
|
621
621
|
|---------|--------------|
|
|
622
|
-
| `/
|
|
623
|
-
| `/
|
|
624
|
-
| `/
|
|
625
|
-
| `/
|
|
622
|
+
| `/ez:progress` | Where am I? What's next? |
|
|
623
|
+
| `/ez:help` | Show all commands and usage guide |
|
|
624
|
+
| `/ez:update` | Update EZ Agents with changelog preview |
|
|
625
|
+
| `/ez:join-discord` | Join the EZ Agents Discord community |
|
|
626
626
|
|
|
627
627
|
### Brownfield
|
|
628
628
|
|
|
629
629
|
| Command | What it does |
|
|
630
630
|
|---------|--------------|
|
|
631
|
-
| `/
|
|
631
|
+
| `/ez:map-codebase [area]` | Analyze existing codebase before new-project |
|
|
632
632
|
|
|
633
633
|
### Phase Management
|
|
634
634
|
|
|
635
635
|
| Command | What it does |
|
|
636
636
|
|---------|--------------|
|
|
637
|
-
| `/
|
|
638
|
-
| `/
|
|
639
|
-
| `/
|
|
640
|
-
| `/
|
|
641
|
-
| `/
|
|
637
|
+
| `/ez:add-phase` | Append phase to roadmap |
|
|
638
|
+
| `/ez:insert-phase [N]` | Insert urgent work between phases |
|
|
639
|
+
| `/ez:remove-phase [N]` | Remove future phase, renumber |
|
|
640
|
+
| `/ez:list-phase-assumptions [N]` | See Claude's intended approach before planning |
|
|
641
|
+
| `/ez:plan-milestone-gaps` | Create phases to close gaps from audit |
|
|
642
642
|
|
|
643
643
|
### Session
|
|
644
644
|
|
|
645
645
|
| Command | What it does |
|
|
646
646
|
|---------|--------------|
|
|
647
|
-
| `/
|
|
648
|
-
| `/
|
|
647
|
+
| `/ez:pause-work` | Create handoff when stopping mid-phase |
|
|
648
|
+
| `/ez:resume-work` | Restore from last session |
|
|
649
649
|
|
|
650
650
|
### Utilities
|
|
651
651
|
|
|
652
652
|
| Command | What it does |
|
|
653
653
|
|---------|--------------|
|
|
654
|
-
| `/
|
|
655
|
-
| `/
|
|
656
|
-
| `/
|
|
657
|
-
| `/
|
|
658
|
-
| `/
|
|
659
|
-
| `/
|
|
660
|
-
| `/
|
|
654
|
+
| `/ez:settings` | Configure model profile and workflow agents |
|
|
655
|
+
| `/ez:set-profile <profile>` | Switch model profile (quality/balanced/budget) |
|
|
656
|
+
| `/ez:add-todo [desc]` | Capture idea for later |
|
|
657
|
+
| `/ez:check-todos` | List pending todos |
|
|
658
|
+
| `/ez:debug [desc]` | Systematic debugging with persistent state |
|
|
659
|
+
| `/ez:quick [--full] [--discuss]` | Execute ad-hoc task with EZ Agents guarantees (`--full` adds plan-checking and verification, `--discuss` gathers context first) |
|
|
660
|
+
| `/ez:health [--repair]` | Validate `.planning/` directory integrity, auto-repair with `--repair` |
|
|
661
661
|
|
|
662
662
|
<sup>¹ Contributed by reddit user OracleGreyBeard</sup>
|
|
663
663
|
|
|
@@ -665,7 +665,7 @@ You're never locked in. The system adapts.
|
|
|
665
665
|
|
|
666
666
|
## Configuration
|
|
667
667
|
|
|
668
|
-
|
|
668
|
+
EZ Agents stores project settings in `.planning/config.json`. Configure during `/ez:new-project` or update later with `/ez:settings`. For the full config schema, workflow toggles, git branching options, and per-agent model breakdown, see the [User Guide](docs/USER-GUIDE.md#configuration-reference).
|
|
669
669
|
|
|
670
670
|
### Core Settings
|
|
671
671
|
|
|
@@ -686,10 +686,10 @@ Control which Claude model each agent uses. Balance quality vs token spend.
|
|
|
686
686
|
|
|
687
687
|
Switch profiles:
|
|
688
688
|
```
|
|
689
|
-
/
|
|
689
|
+
/ez:set-profile budget
|
|
690
690
|
```
|
|
691
691
|
|
|
692
|
-
Or configure via `/
|
|
692
|
+
Or configure via `/ez:settings`.
|
|
693
693
|
|
|
694
694
|
### Workflow Agents
|
|
695
695
|
|
|
@@ -702,9 +702,9 @@ These spawn additional agents during planning/execution. They improve quality bu
|
|
|
702
702
|
| `workflow.verifier` | `true` | Confirms must-haves were delivered after execution |
|
|
703
703
|
| `workflow.auto_advance` | `false` | Auto-chain discuss → plan → execute without stopping |
|
|
704
704
|
|
|
705
|
-
Use `/
|
|
706
|
-
- `/
|
|
707
|
-
- `/
|
|
705
|
+
Use `/ez:settings` to toggle these, or override per-invocation:
|
|
706
|
+
- `/ez:plan-phase --skip-research`
|
|
707
|
+
- `/ez:plan-phase --skip-verify`
|
|
708
708
|
|
|
709
709
|
### Execution
|
|
710
710
|
|
|
@@ -715,20 +715,20 @@ Use `/gsd:settings` to toggle these, or override per-invocation:
|
|
|
715
715
|
|
|
716
716
|
### Git Branching
|
|
717
717
|
|
|
718
|
-
Control how
|
|
718
|
+
Control how EZ Agents handles branches during execution.
|
|
719
719
|
|
|
720
720
|
| Setting | Options | Default | What it does |
|
|
721
721
|
|---------|---------|---------|--------------|
|
|
722
722
|
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | Branch creation strategy |
|
|
723
|
-
| `git.phase_branch_template` | string | `
|
|
724
|
-
| `git.milestone_branch_template` | string | `
|
|
723
|
+
| `git.phase_branch_template` | string | `ez/phase-{phase}-{slug}` | Template for phase branches |
|
|
724
|
+
| `git.milestone_branch_template` | string | `ez/{milestone}-{slug}` | Template for milestone branches |
|
|
725
725
|
|
|
726
726
|
**Strategies:**
|
|
727
|
-
- **`none`** — Commits to current branch (default
|
|
727
|
+
- **`none`** — Commits to current branch (default EZ Agents behavior)
|
|
728
728
|
- **`phase`** — Creates a branch per phase, merges at phase completion
|
|
729
729
|
- **`milestone`** — Creates one branch for entire milestone, merges at completion
|
|
730
730
|
|
|
731
|
-
At milestone completion,
|
|
731
|
+
At milestone completion, EZ Agents offers squash merge (recommended) or merge with history.
|
|
732
732
|
|
|
733
733
|
---
|
|
734
734
|
|
|
@@ -736,7 +736,7 @@ At milestone completion, GSD offers squash merge (recommended) or merge with his
|
|
|
736
736
|
|
|
737
737
|
### Protecting Sensitive Files
|
|
738
738
|
|
|
739
|
-
|
|
739
|
+
EZ Agents' codebase mapping and analysis commands read files to understand your project. **Protect files containing secrets** by adding them to Claude Code's deny list:
|
|
740
740
|
|
|
741
741
|
1. Open Claude Code settings (`.claude/settings.json` or global)
|
|
742
742
|
2. Add sensitive file patterns to the deny list:
|
|
@@ -759,7 +759,7 @@ GSD's codebase mapping and analysis commands read files to understand your proje
|
|
|
759
759
|
This prevents Claude from reading these files entirely, regardless of what commands you run.
|
|
760
760
|
|
|
761
761
|
> [!IMPORTANT]
|
|
762
|
-
>
|
|
762
|
+
> EZ Agents includes built-in protections against committing secrets, but defense-in-depth is best practice. Deny read access to sensitive files as a first line of defense.
|
|
763
763
|
|
|
764
764
|
---
|
|
765
765
|
|
|
@@ -767,56 +767,56 @@ This prevents Claude from reading these files entirely, regardless of what comma
|
|
|
767
767
|
|
|
768
768
|
**Commands not found after install?**
|
|
769
769
|
- Restart your runtime to reload commands/skills
|
|
770
|
-
- Verify files exist in `~/.claude/commands/
|
|
771
|
-
- For Codex, verify skills exist in `~/.codex/skills/
|
|
770
|
+
- Verify files exist in `~/.claude/commands/ez/` (global) or `./.claude/commands/ez/` (local)
|
|
771
|
+
- For Codex, verify skills exist in `~/.codex/skills/ez-*/SKILL.md` (global) or `./.codex/skills/ez-*/SKILL.md` (local)
|
|
772
772
|
|
|
773
773
|
**Commands not working as expected?**
|
|
774
|
-
- Run `/
|
|
775
|
-
- Re-run `
|
|
774
|
+
- Run `/ez:help` to verify installation
|
|
775
|
+
- Re-run `ez-agents` to reinstall
|
|
776
776
|
|
|
777
777
|
**Updating to the latest version?**
|
|
778
778
|
```bash
|
|
779
|
-
|
|
779
|
+
ez-agents-update
|
|
780
780
|
```
|
|
781
781
|
|
|
782
782
|
**Using Docker or containerized environments?**
|
|
783
783
|
|
|
784
784
|
If file reads fail with tilde paths (`~/.claude/...`), set `CLAUDE_CONFIG_DIR` before installing:
|
|
785
785
|
```bash
|
|
786
|
-
CLAUDE_CONFIG_DIR=/home/youruser/.claude
|
|
786
|
+
CLAUDE_CONFIG_DIR=/home/youruser/.claude ez-agents --global
|
|
787
787
|
```
|
|
788
788
|
This ensures absolute paths are used instead of `~` which may not expand correctly in containers.
|
|
789
789
|
|
|
790
790
|
### Uninstalling
|
|
791
791
|
|
|
792
|
-
To remove
|
|
792
|
+
To remove EZ Agents completely:
|
|
793
793
|
|
|
794
794
|
```bash
|
|
795
795
|
# Global installs
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
796
|
+
ez-agents --claude --global --uninstall
|
|
797
|
+
ez-agents --opencode --global --uninstall
|
|
798
|
+
ez-agents --codex --global --uninstall
|
|
799
799
|
|
|
800
800
|
# Local installs (current project)
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
801
|
+
ez-agents --claude --local --uninstall
|
|
802
|
+
ez-agents --opencode --local --uninstall
|
|
803
|
+
ez-agents --codex --local --uninstall
|
|
804
804
|
```
|
|
805
805
|
|
|
806
|
-
This removes all
|
|
806
|
+
This removes all EZ Agents commands, agents, hooks, and settings while preserving your other configurations.
|
|
807
807
|
|
|
808
808
|
---
|
|
809
809
|
|
|
810
810
|
## Community Ports
|
|
811
811
|
|
|
812
|
-
OpenCode, Gemini CLI, and Codex are now natively supported via `
|
|
812
|
+
OpenCode, Gemini CLI, and Codex are now natively supported via `ez-agents`.
|
|
813
813
|
|
|
814
814
|
These community ports pioneered multi-runtime support:
|
|
815
815
|
|
|
816
816
|
| Project | Platform | Description |
|
|
817
817
|
|---------|----------|-------------|
|
|
818
|
-
| [
|
|
819
|
-
|
|
|
818
|
+
| [ez-opencode](https://github.com/rokicool/gsd-opencode) | OpenCode | Original OpenCode adaptation |
|
|
819
|
+
| ez-gemini (archived) | Gemini CLI | Original Gemini adaptation by uberfuzzy |
|
|
820
820
|
|
|
821
821
|
---
|
|
822
822
|
|
|
@@ -840,6 +840,6 @@ MIT License. See [LICENSE](LICENSE) for details.
|
|
|
840
840
|
|
|
841
841
|
<div align="center">
|
|
842
842
|
|
|
843
|
-
**Claude Code is powerful.
|
|
843
|
+
**Claude Code is powerful. EZ Agents makes it reliable.**
|
|
844
844
|
|
|
845
845
|
</div>
|
|
@@ -72,7 +72,7 @@ Goal-backward verification works backwards from outcome:
|
|
|
72
72
|
Then verify each level against the actual plan files.
|
|
73
73
|
|
|
74
74
|
**The difference:**
|
|
75
|
-
- `
|
|
75
|
+
- `ez-verifier`: Verifies code DID achieve goal (after execution)
|
|
76
76
|
- `ez-plan-checker`: Verifies plans WILL achieve goal (before execution)
|
|
77
77
|
|
|
78
78
|
Same methodology (goal-backward), different timing, different subject matter.
|
|
@@ -666,7 +666,7 @@ Plans verified. Run `/ez:execute-phase {phase}` to proceed.
|
|
|
666
666
|
|
|
667
667
|
<anti_patterns>
|
|
668
668
|
|
|
669
|
-
**DO NOT** check code existence — that's
|
|
669
|
+
**DO NOT** check code existence — that's ez-verifier's job. You verify plans, not codebase.
|
|
670
670
|
|
|
671
671
|
**DO NOT** run the application. Static plan analysis only.
|
|
672
672
|
|
|
@@ -33,7 +33,7 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
|
|
|
33
33
|
</role>
|
|
34
34
|
|
|
35
35
|
<downstream_consumer>
|
|
36
|
-
Your SUMMARY.md is consumed by the
|
|
36
|
+
Your SUMMARY.md is consumed by the ez-roadmapper agent which uses it to:
|
|
37
37
|
|
|
38
38
|
| Section | How Roadmapper Uses It |
|
|
39
39
|
|---------|------------------------|
|
|
@@ -4,7 +4,7 @@ description: Produces UI-SPEC.md design contract for frontend phases. Reads upst
|
|
|
4
4
|
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
|
|
5
5
|
color: "#E879F9"
|
|
6
6
|
skills:
|
|
7
|
-
-
|
|
7
|
+
- ez-ui-researcher-workflow
|
|
8
8
|
# hooks:
|
|
9
9
|
# PostToolUse:
|
|
10
10
|
# - matcher: "Write|Edit"
|