@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.
Files changed (106) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  3. package/agents/ez-plan-checker.md +2 -2
  4. package/agents/ez-research-synthesizer.md +1 -1
  5. package/agents/ez-ui-researcher.md +1 -1
  6. package/agents/ez-verifier.md +1 -1
  7. package/bin/install.js +132 -132
  8. package/get-shit-done/bin/lib/assistant-adapter.cjs +205 -205
  9. package/get-shit-done/bin/lib/audit-exec.cjs +150 -150
  10. package/get-shit-done/bin/lib/auth.cjs +175 -175
  11. package/get-shit-done/bin/lib/circuit-breaker.cjs +118 -118
  12. package/get-shit-done/bin/lib/commands.cjs +666 -666
  13. package/get-shit-done/bin/lib/config.cjs +183 -183
  14. package/get-shit-done/bin/lib/core.cjs +495 -495
  15. package/get-shit-done/bin/lib/file-lock.cjs +236 -236
  16. package/get-shit-done/bin/lib/frontmatter.cjs +299 -299
  17. package/get-shit-done/bin/lib/fs-utils.cjs +153 -153
  18. package/get-shit-done/bin/lib/git-utils.cjs +203 -203
  19. package/get-shit-done/bin/lib/health-check.cjs +163 -163
  20. package/get-shit-done/bin/lib/index.cjs +113 -113
  21. package/get-shit-done/bin/lib/init.cjs +710 -710
  22. package/get-shit-done/bin/lib/logger.cjs +117 -117
  23. package/get-shit-done/bin/lib/milestone.cjs +241 -241
  24. package/get-shit-done/bin/lib/model-provider.cjs +146 -146
  25. package/get-shit-done/bin/lib/phase.cjs +908 -908
  26. package/get-shit-done/bin/lib/retry.cjs +119 -119
  27. package/get-shit-done/bin/lib/roadmap.cjs +305 -305
  28. package/get-shit-done/bin/lib/safe-exec.cjs +128 -128
  29. package/get-shit-done/bin/lib/safe-path.cjs +130 -130
  30. package/get-shit-done/bin/lib/state.cjs +721 -721
  31. package/get-shit-done/bin/lib/temp-file.cjs +239 -239
  32. package/get-shit-done/bin/lib/template.cjs +222 -222
  33. package/get-shit-done/bin/lib/test-file-lock.cjs +112 -112
  34. package/get-shit-done/bin/lib/test-graceful.cjs +93 -93
  35. package/get-shit-done/bin/lib/test-logger.cjs +60 -60
  36. package/get-shit-done/bin/lib/test-safe-exec.cjs +38 -38
  37. package/get-shit-done/bin/lib/test-safe-path.cjs +33 -33
  38. package/get-shit-done/bin/lib/test-temp-file.cjs +125 -125
  39. package/get-shit-done/bin/lib/timeout-exec.cjs +62 -62
  40. package/get-shit-done/bin/lib/verify.cjs +820 -820
  41. package/get-shit-done/references/checkpoints.md +776 -776
  42. package/get-shit-done/references/questioning.md +162 -162
  43. package/get-shit-done/references/tdd.md +263 -263
  44. package/get-shit-done/templates/codebase/concerns.md +310 -310
  45. package/get-shit-done/templates/codebase/conventions.md +307 -307
  46. package/get-shit-done/templates/codebase/integrations.md +280 -280
  47. package/get-shit-done/templates/codebase/stack.md +186 -186
  48. package/get-shit-done/templates/codebase/testing.md +480 -480
  49. package/get-shit-done/templates/config.json +37 -37
  50. package/get-shit-done/templates/continue-here.md +78 -78
  51. package/get-shit-done/templates/milestone-archive.md +123 -123
  52. package/get-shit-done/templates/milestone.md +115 -115
  53. package/get-shit-done/templates/requirements.md +231 -231
  54. package/get-shit-done/templates/research-project/ARCHITECTURE.md +204 -204
  55. package/get-shit-done/templates/research-project/FEATURES.md +147 -147
  56. package/get-shit-done/templates/research-project/PITFALLS.md +200 -200
  57. package/get-shit-done/templates/research-project/STACK.md +120 -120
  58. package/get-shit-done/templates/research-project/SUMMARY.md +170 -170
  59. package/get-shit-done/templates/retrospective.md +54 -54
  60. package/get-shit-done/templates/roadmap.md +202 -202
  61. package/get-shit-done/templates/summary-minimal.md +41 -41
  62. package/get-shit-done/templates/summary-standard.md +48 -48
  63. package/get-shit-done/templates/summary.md +248 -248
  64. package/get-shit-done/templates/user-setup.md +311 -311
  65. package/get-shit-done/templates/verification-report.md +322 -322
  66. package/get-shit-done/workflows/add-phase.md +112 -112
  67. package/get-shit-done/workflows/add-tests.md +351 -351
  68. package/get-shit-done/workflows/add-todo.md +158 -158
  69. package/get-shit-done/workflows/audit-milestone.md +332 -332
  70. package/get-shit-done/workflows/autonomous.md +743 -743
  71. package/get-shit-done/workflows/check-todos.md +177 -177
  72. package/get-shit-done/workflows/cleanup.md +152 -152
  73. package/get-shit-done/workflows/complete-milestone.md +766 -766
  74. package/get-shit-done/workflows/diagnose-issues.md +219 -219
  75. package/get-shit-done/workflows/discovery-phase.md +289 -289
  76. package/get-shit-done/workflows/discuss-phase.md +762 -762
  77. package/get-shit-done/workflows/execute-phase.md +468 -468
  78. package/get-shit-done/workflows/execute-plan.md +483 -483
  79. package/get-shit-done/workflows/health.md +159 -159
  80. package/get-shit-done/workflows/help.md +492 -492
  81. package/get-shit-done/workflows/insert-phase.md +130 -130
  82. package/get-shit-done/workflows/list-phase-assumptions.md +178 -178
  83. package/get-shit-done/workflows/map-codebase.md +316 -316
  84. package/get-shit-done/workflows/new-milestone.md +384 -384
  85. package/get-shit-done/workflows/new-project.md +1111 -1111
  86. package/get-shit-done/workflows/node-repair.md +92 -92
  87. package/get-shit-done/workflows/pause-work.md +122 -122
  88. package/get-shit-done/workflows/plan-milestone-gaps.md +274 -274
  89. package/get-shit-done/workflows/plan-phase.md +651 -651
  90. package/get-shit-done/workflows/progress.md +382 -382
  91. package/get-shit-done/workflows/quick.md +610 -610
  92. package/get-shit-done/workflows/remove-phase.md +155 -155
  93. package/get-shit-done/workflows/research-phase.md +74 -74
  94. package/get-shit-done/workflows/resume-project.md +307 -307
  95. package/get-shit-done/workflows/set-profile.md +81 -81
  96. package/get-shit-done/workflows/settings.md +242 -242
  97. package/get-shit-done/workflows/stats.md +57 -57
  98. package/get-shit-done/workflows/transition.md +544 -544
  99. package/get-shit-done/workflows/ui-phase.md +290 -290
  100. package/get-shit-done/workflows/ui-review.md +157 -157
  101. package/get-shit-done/workflows/update.md +320 -320
  102. package/get-shit-done/workflows/validate-phase.md +167 -167
  103. package/get-shit-done/workflows/verify-phase.md +243 -243
  104. package/package.json +1 -1
  105. package/scripts/build-hooks.js +43 -43
  106. 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
- "gsd-planner": { "provider": "alibaba", "model": "qwen-max" },
128
- "gsd-executor": { "provider": "anthropic", "model": "sonnet" },
129
- "gsd-verifier": { "provider": "moonshot", "model": "balanced" }
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 GSD. 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.
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
- GSD 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.
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
- GSD is designed for frictionless automation. Run Claude Code with:
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 GSD is intended to be used — stopping to approve `date` and `git commit` 50 times defeats the purpose.
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 `/gsd:map-codebase` first. It spawns parallel agents to analyze your stack, architecture, conventions, and concerns. Then `/gsd:new-project` knows your codebase — questions focus on what you're adding, and planning automatically loads your patterns.
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
- /gsd:new-project
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
- /gsd:discuss-phase 1
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
- /gsd:plan-phase 1
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
- /gsd:execute-phase 1
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
- /gsd:verify-work 1
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 `/gsd:execute-phase` again with the fix plans it created.
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
- /gsd:discuss-phase 2
475
- /gsd:plan-phase 2
476
- /gsd:execute-phase 2
477
- /gsd:verify-work 2
474
+ /ez:discuss-phase 2
475
+ /ez:plan-phase 2
476
+ /ez:execute-phase 2
477
+ /ez:verify-work 2
478
478
  ...
479
- /gsd:complete-milestone
480
- /gsd:new-milestone
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 `/gsd:discuss-phase <n> --batch` to answer a small grouped set of questions at once instead of one-by-one.
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, `/gsd:complete-milestone` archives the milestone and tags the release.
489
+ When all phases are done, `/ez:complete-milestone` archives the milestone and tags the release.
490
490
 
491
- Then `/gsd: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.
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
- /gsd:quick
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 GSD guarantees (atomic commits, state tracking) with a faster path:
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
- /gsd:quick
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
- GSD handles it for you:
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
- | `/gsd:new-project [--auto]` | Full initialization: questions → research → requirements → roadmap |
610
- | `/gsd:discuss-phase [N] [--auto]` | Capture implementation decisions before planning |
611
- | `/gsd:plan-phase [N] [--auto]` | Research + plan + verify for a phase |
612
- | `/gsd:execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
613
- | `/gsd:verify-work [N]` | Manual user acceptance testing ¹ |
614
- | `/gsd:audit-milestone` | Verify milestone achieved its definition of done |
615
- | `/gsd:complete-milestone` | Archive milestone, tag release |
616
- | `/gsd:new-milestone [name]` | Start next version: questions → research → requirements → roadmap |
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
- | `/gsd:progress` | Where am I? What's next? |
623
- | `/gsd:help` | Show all commands and usage guide |
624
- | `/gsd:update` | Update GSD with changelog preview |
625
- | `/gsd:join-discord` | Join the GSD Discord community |
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
- | `/gsd:map-codebase [area]` | Analyze existing codebase before new-project |
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
- | `/gsd:add-phase` | Append phase to roadmap |
638
- | `/gsd:insert-phase [N]` | Insert urgent work between phases |
639
- | `/gsd:remove-phase [N]` | Remove future phase, renumber |
640
- | `/gsd:list-phase-assumptions [N]` | See Claude's intended approach before planning |
641
- | `/gsd:plan-milestone-gaps` | Create phases to close gaps from audit |
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
- | `/gsd:pause-work` | Create handoff when stopping mid-phase |
648
- | `/gsd:resume-work` | Restore from last session |
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
- | `/gsd:settings` | Configure model profile and workflow agents |
655
- | `/gsd:set-profile <profile>` | Switch model profile (quality/balanced/budget) |
656
- | `/gsd:add-todo [desc]` | Capture idea for later |
657
- | `/gsd:check-todos` | List pending todos |
658
- | `/gsd:debug [desc]` | Systematic debugging with persistent state |
659
- | `/gsd:quick [--full] [--discuss]` | Execute ad-hoc task with GSD guarantees (`--full` adds plan-checking and verification, `--discuss` gathers context first) |
660
- | `/gsd:health [--repair]` | Validate `.planning/` directory integrity, auto-repair with `--repair` |
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
- GSD stores project settings in `.planning/config.json`. Configure during `/gsd:new-project` or update later with `/gsd: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).
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
- /gsd:set-profile budget
689
+ /ez:set-profile budget
690
690
  ```
691
691
 
692
- Or configure via `/gsd:settings`.
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 `/gsd:settings` to toggle these, or override per-invocation:
706
- - `/gsd:plan-phase --skip-research`
707
- - `/gsd:plan-phase --skip-verify`
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 GSD handles branches during execution.
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 | `gsd/phase-{phase}-{slug}` | Template for phase branches |
724
- | `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | Template for milestone branches |
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 GSD behavior)
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, GSD offers squash merge (recommended) or merge with history.
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
- GSD's codebase mapping and analysis commands read files to understand your project. **Protect files containing secrets** by adding them to Claude Code's deny list:
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
- > GSD 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.
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/gsd/` (global) or `./.claude/commands/gsd/` (local)
771
- - For Codex, verify skills exist in `~/.codex/skills/gsd-*/SKILL.md` (global) or `./.codex/skills/gsd-*/SKILL.md` (local)
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 `/gsd:help` to verify installation
775
- - Re-run `gsdm` to reinstall
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
- gsdm-update
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 gsdm --global
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 GSD completely:
792
+ To remove EZ Agents completely:
793
793
 
794
794
  ```bash
795
795
  # Global installs
796
- gsdm --claude --global --uninstall
797
- gsdm --opencode --global --uninstall
798
- gsdm --codex --global --uninstall
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
- gsdm --claude --local --uninstall
802
- gsdm --opencode --local --uninstall
803
- gsdm --codex --local --uninstall
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 GSD commands, agents, hooks, and settings while preserving your other configurations.
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 `gsdm`.
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
- | [gsd-opencode](https://github.com/rokicool/gsd-opencode) | OpenCode | Original OpenCode adaptation |
819
- | gsd-gemini (archived) | Gemini CLI | Original Gemini adaptation by uberfuzzy |
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. GSD makes it reliable.**
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
- - `gsd-verifier`: Verifies code DID achieve goal (after execution)
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 gsd-verifier's job. You verify plans, not codebase.
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 gsd-roadmapper agent which uses it to:
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
- - gsd-ui-researcher-workflow
7
+ - ez-ui-researcher-workflow
8
8
  # hooks:
9
9
  # PostToolUse:
10
10
  # - matcher: "Write|Edit"
@@ -453,7 +453,7 @@ human_verification: # Only if status: human_needed
453
453
  ---
454
454
 
455
455
  _Verified: {timestamp}_
456
- _Verifier: Claude (gsd-verifier)_
456
+ _Verifier: Claude (ez-verifier)_
457
457
  ```
458
458
 
459
459
  ## Return to Orchestrator