@howlil/ez-agents 2.0.1 → 3.1.0
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 -25
- package/README.zh-CN.md +84 -84
- package/agents/ez-ui-auditor.md +0 -2
- package/agents/ez-ui-checker.md +2 -4
- package/agents/ez-ui-researcher.md +0 -2
- package/bin/install.js +145 -102
- package/commands/ez/debug.md +1 -1
- package/commands/ez/map-codebase.md +1 -1
- package/commands/ez/reapply-patches.md +3 -3
- package/commands/ez/research-phase.md +1 -1
- package/{get-shit-done → ez-agents}/bin/ez-tools.cjs +1 -1
- package/{get-shit-done → ez-agents}/bin/lib/auth.cjs +2 -2
- package/{get-shit-done → ez-agents}/bin/lib/core.cjs +16 -16
- package/{get-shit-done → ez-agents}/bin/lib/init.cjs +20 -20
- package/{get-shit-done → ez-agents}/bin/lib/logger.cjs +2 -2
- package/{get-shit-done → ez-agents}/bin/lib/temp-file.cjs +2 -2
- package/{get-shit-done → ez-agents}/bin/lib/test-file-lock.cjs +1 -1
- package/{get-shit-done → ez-agents}/bin/lib/test-graceful.cjs +1 -1
- package/{get-shit-done → ez-agents}/bin/lib/test-logger.cjs +1 -1
- package/{get-shit-done → ez-agents}/bin/lib/test-temp-file.cjs +2 -2
- package/{get-shit-done → ez-agents}/workflows/add-phase.md +2 -2
- package/{get-shit-done → ez-agents}/workflows/audit-milestone.md +1 -1
- package/{get-shit-done → ez-agents}/workflows/complete-milestone.md +3 -3
- package/ez-agents/workflows/debug.md +0 -0
- package/{get-shit-done → ez-agents}/workflows/discovery-phase.md +5 -5
- package/{get-shit-done → ez-agents}/workflows/discuss-phase.md +2 -2
- package/{get-shit-done → ez-agents}/workflows/execute-phase.md +5 -5
- package/{get-shit-done → ez-agents}/workflows/execute-plan.md +10 -10
- package/{get-shit-done → ez-agents}/workflows/help.md +9 -9
- package/{get-shit-done → ez-agents}/workflows/insert-phase.md +2 -2
- package/{get-shit-done → ez-agents}/workflows/map-codebase.md +3 -3
- package/{get-shit-done → ez-agents}/workflows/new-milestone.md +4 -4
- package/{get-shit-done → ez-agents}/workflows/new-project.md +8 -8
- package/{get-shit-done → ez-agents}/workflows/plan-phase.md +9 -9
- package/{get-shit-done → ez-agents}/workflows/progress.md +2 -2
- package/{get-shit-done → ez-agents}/workflows/quick.md +10 -10
- package/{get-shit-done → ez-agents}/workflows/remove-phase.md +4 -4
- package/{get-shit-done → ez-agents}/workflows/research-phase.md +4 -4
- package/{get-shit-done → ez-agents}/workflows/resume-project.md +1 -1
- package/{get-shit-done → ez-agents}/workflows/set-profile.md +3 -3
- package/{get-shit-done → ez-agents}/workflows/transition.md +3 -3
- package/{get-shit-done → ez-agents}/workflows/ui-phase.md +12 -12
- package/{get-shit-done → ez-agents}/workflows/ui-review.md +6 -6
- package/{get-shit-done → ez-agents}/workflows/update.md +29 -29
- package/{get-shit-done → ez-agents}/workflows/validate-phase.md +5 -5
- package/{get-shit-done → ez-agents}/workflows/verify-phase.md +6 -6
- package/{get-shit-done → ez-agents}/workflows/verify-work.md +5 -5
- package/hooks/dist/ez-check-update.js +81 -0
- package/hooks/dist/ez-context-monitor.js +141 -0
- package/hooks/dist/ez-statusline.js +115 -0
- package/package.json +13 -3
- package/scripts/build-hooks.js +3 -3
- /package/{get-shit-done → ez-agents}/bin/lib/assistant-adapter.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/audit-exec.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/circuit-breaker.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/commands.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/config.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/file-lock.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/frontmatter.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/fs-utils.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/git-utils.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/health-check.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/index.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/milestone.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/model-provider.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/phase.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/retry.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/roadmap.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/safe-exec.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/safe-path.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/state.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/template.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/test-safe-exec.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/test-safe-path.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/timeout-exec.cjs +0 -0
- /package/{get-shit-done → ez-agents}/bin/lib/verify.cjs +0 -0
- /package/{get-shit-done → ez-agents}/references/checkpoints.md +0 -0
- /package/{get-shit-done → ez-agents}/references/continuation-format.md +0 -0
- /package/{get-shit-done → ez-agents}/references/decimal-phase-calculation.md +0 -0
- /package/{get-shit-done → ez-agents}/references/git-integration.md +0 -0
- /package/{get-shit-done → ez-agents}/references/git-planning-commit.md +0 -0
- /package/{get-shit-done → ez-agents}/references/model-profile-resolution.md +0 -0
- /package/{get-shit-done → ez-agents}/references/model-profiles.md +0 -0
- /package/{get-shit-done → ez-agents}/references/phase-argument-parsing.md +0 -0
- /package/{get-shit-done → ez-agents}/references/planning-config.md +0 -0
- /package/{get-shit-done → ez-agents}/references/questioning.md +0 -0
- /package/{get-shit-done → ez-agents}/references/tdd.md +0 -0
- /package/{get-shit-done → ez-agents}/references/ui-brand.md +0 -0
- /package/{get-shit-done → ez-agents}/references/verification-patterns.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/DEBUG.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/UAT.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/UI-SPEC.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/VALIDATION.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/architecture.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/concerns.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/conventions.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/integrations.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/stack.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/structure.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/codebase/testing.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/config.json +0 -0
- /package/{get-shit-done → ez-agents}/templates/context.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/continue-here.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/copilot-instructions.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/debug-subagent-prompt.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/discovery.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/milestone-archive.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/milestone.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/phase-prompt.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/planner-subagent-prompt.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/project.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/requirements.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research-project/ARCHITECTURE.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research-project/FEATURES.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research-project/PITFALLS.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research-project/STACK.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research-project/SUMMARY.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/research.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/retrospective.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/roadmap.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/state.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/summary-complex.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/summary-minimal.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/summary-standard.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/summary.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/user-setup.md +0 -0
- /package/{get-shit-done → ez-agents}/templates/verification-report.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/add-tests.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/add-todo.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/autonomous.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/check-todos.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/cleanup.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/diagnose-issues.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/health.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/list-phase-assumptions.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/node-repair.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/pause-work.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/plan-milestone-gaps.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/settings.md +0 -0
- /package/{get-shit-done → ez-agents}/workflows/stats.md +0 -0
|
@@ -115,7 +115,7 @@ node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" config-set workflow.research fal
|
|
|
115
115
|
mkdir -p .planning/research
|
|
116
116
|
```
|
|
117
117
|
|
|
118
|
-
Spawn 4 parallel
|
|
118
|
+
Spawn 4 parallel ez-project-researcher agents. Each uses this template with dimension-specific fields:
|
|
119
119
|
|
|
120
120
|
**Common structure for all 4 researchers:**
|
|
121
121
|
```
|
|
@@ -140,7 +140,7 @@ Focus ONLY on what's needed for the NEW features.
|
|
|
140
140
|
|
|
141
141
|
<output>
|
|
142
142
|
Write to: .planning/research/{FILE}
|
|
143
|
-
Use template: ~/.claude/
|
|
143
|
+
Use template: ~/.claude/ez-agents/templates/research-project/{FILE}
|
|
144
144
|
</output>
|
|
145
145
|
", subagent_type="ez-project-researcher", model="{researcher_model}", description="{DIMENSION} research")
|
|
146
146
|
```
|
|
@@ -169,7 +169,7 @@ Synthesize research outputs into SUMMARY.md.
|
|
|
169
169
|
</files_to_read>
|
|
170
170
|
|
|
171
171
|
Write to: .planning/research/SUMMARY.md
|
|
172
|
-
Use template: ~/.claude/
|
|
172
|
+
Use template: ~/.claude/ez-agents/templates/research-project/SUMMARY.md
|
|
173
173
|
Commit after writing.
|
|
174
174
|
", subagent_type="ez-research-synthesizer", model="{synthesizer_model}", description="Synthesize research")
|
|
175
175
|
```
|
|
@@ -373,7 +373,7 @@ Also: `/ez:plan-phase [N]` — skip discussion, plan directly
|
|
|
373
373
|
- [ ] Research completed (if selected) — 4 parallel agents, milestone-aware
|
|
374
374
|
- [ ] Requirements gathered and scoped per category
|
|
375
375
|
- [ ] REQUIREMENTS.md created with REQ-IDs
|
|
376
|
-
- [ ]
|
|
376
|
+
- [ ] ez-roadmapper spawned with phase numbering context
|
|
377
377
|
- [ ] Roadmap files written immediately (not draft)
|
|
378
378
|
- [ ] User feedback incorporated (if any)
|
|
379
379
|
- [ ] ROADMAP.md phases continue from previous milestone
|
|
@@ -544,7 +544,7 @@ Display spawning indicator:
|
|
|
544
544
|
→ Pitfalls research
|
|
545
545
|
```
|
|
546
546
|
|
|
547
|
-
Spawn 4 parallel
|
|
547
|
+
Spawn 4 parallel ez-project-researcher agents with path references:
|
|
548
548
|
|
|
549
549
|
```
|
|
550
550
|
Task(prompt="<research_type>
|
|
@@ -581,7 +581,7 @@ Your STACK.md feeds into roadmap creation. Be prescriptive:
|
|
|
581
581
|
|
|
582
582
|
<output>
|
|
583
583
|
Write to: .planning/research/STACK.md
|
|
584
|
-
Use template: ~/.claude/
|
|
584
|
+
Use template: ~/.claude/ez-agents/templates/research-project/STACK.md
|
|
585
585
|
</output>
|
|
586
586
|
", subagent_type="ez-project-researcher", model="{researcher_model}", description="Stack research")
|
|
587
587
|
|
|
@@ -619,7 +619,7 @@ Your FEATURES.md feeds into requirements definition. Categorize clearly:
|
|
|
619
619
|
|
|
620
620
|
<output>
|
|
621
621
|
Write to: .planning/research/FEATURES.md
|
|
622
|
-
Use template: ~/.claude/
|
|
622
|
+
Use template: ~/.claude/ez-agents/templates/research-project/FEATURES.md
|
|
623
623
|
</output>
|
|
624
624
|
", subagent_type="ez-project-researcher", model="{researcher_model}", description="Features research")
|
|
625
625
|
|
|
@@ -657,7 +657,7 @@ Your ARCHITECTURE.md informs phase structure in roadmap. Include:
|
|
|
657
657
|
|
|
658
658
|
<output>
|
|
659
659
|
Write to: .planning/research/ARCHITECTURE.md
|
|
660
|
-
Use template: ~/.claude/
|
|
660
|
+
Use template: ~/.claude/ez-agents/templates/research-project/ARCHITECTURE.md
|
|
661
661
|
</output>
|
|
662
662
|
", subagent_type="ez-project-researcher", model="{researcher_model}", description="Architecture research")
|
|
663
663
|
|
|
@@ -695,7 +695,7 @@ Your PITFALLS.md prevents mistakes in roadmap/planning. For each pitfall:
|
|
|
695
695
|
|
|
696
696
|
<output>
|
|
697
697
|
Write to: .planning/research/PITFALLS.md
|
|
698
|
-
Use template: ~/.claude/
|
|
698
|
+
Use template: ~/.claude/ez-agents/templates/research-project/PITFALLS.md
|
|
699
699
|
</output>
|
|
700
700
|
", subagent_type="ez-project-researcher", model="{researcher_model}", description="Pitfalls research")
|
|
701
701
|
```
|
|
@@ -717,7 +717,7 @@ Synthesize research outputs into SUMMARY.md.
|
|
|
717
717
|
|
|
718
718
|
<output>
|
|
719
719
|
Write to: .planning/research/SUMMARY.md
|
|
720
|
-
Use template: ~/.claude/
|
|
720
|
+
Use template: ~/.claude/ez-agents/templates/research-project/SUMMARY.md
|
|
721
721
|
Commit after writing.
|
|
722
722
|
</output>
|
|
723
723
|
", subagent_type="ez-research-synthesizer", model="{synthesizer_model}", description="Synthesize research")
|
|
@@ -896,7 +896,7 @@ Display stage banner:
|
|
|
896
896
|
◆ Spawning roadmapper...
|
|
897
897
|
```
|
|
898
898
|
|
|
899
|
-
Spawn
|
|
899
|
+
Spawn ez-roadmapper agent with path references:
|
|
900
900
|
|
|
901
901
|
```
|
|
902
902
|
Task(prompt="
|
|
@@ -1098,7 +1098,7 @@ Exit skill and invoke SlashCommand("/ez:discuss-phase 1 --auto")
|
|
|
1098
1098
|
- [ ] Requirements gathered (from research or conversation)
|
|
1099
1099
|
- [ ] User scoped each category (v1/v2/out of scope)
|
|
1100
1100
|
- [ ] REQUIREMENTS.md created with REQ-IDs → **committed**
|
|
1101
|
-
- [ ]
|
|
1101
|
+
- [ ] ez-roadmapper spawned with context
|
|
1102
1102
|
- [ ] Roadmap files written immediately (not draft)
|
|
1103
1103
|
- [ ] User feedback incorporated (if any)
|
|
1104
1104
|
- [ ] ROADMAP.md created with phases, requirement mappings, success criteria
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification. Default flow: Research (if needed) -> Plan -> Verify -> Done. Orchestrates
|
|
2
|
+
Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification. Default flow: Research (if needed) -> Plan -> Verify -> Done. Orchestrates ez-phase-researcher, ez-planner, and ez-plan-checker agents with a revision loop (max 3 iterations).
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
6
6
|
Read all files referenced by the invoking prompt's execution_context before starting.
|
|
7
7
|
|
|
8
|
-
@~/.claude/
|
|
8
|
+
@~/.claude/ez-agents/references/ui-brand.md
|
|
9
9
|
</required_reading>
|
|
10
10
|
|
|
11
11
|
<process>
|
|
@@ -189,7 +189,7 @@ Display banner:
|
|
|
189
189
|
◆ Spawning researcher...
|
|
190
190
|
```
|
|
191
191
|
|
|
192
|
-
### Spawn
|
|
192
|
+
### Spawn ez-phase-researcher
|
|
193
193
|
|
|
194
194
|
```bash
|
|
195
195
|
PHASE_DESC=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" roadmap get-phase "${PHASE}" | jq -r '.section')
|
|
@@ -247,7 +247,7 @@ grep -l "## Validation Architecture" "${PHASE_DIR}"/*-RESEARCH.md 2>/dev/null
|
|
|
247
247
|
```
|
|
248
248
|
|
|
249
249
|
**If found:**
|
|
250
|
-
1. Read template: `~/.claude/
|
|
250
|
+
1. Read template: `~/.claude/ez-agents/templates/VALIDATION.md`
|
|
251
251
|
2. Write to `${PHASE_DIR}/${PADDED_PHASE}-VALIDATION.md` (use Write tool)
|
|
252
252
|
3. Fill frontmatter: `{N}` → phase number, `{phase-slug}` → slug, `{date}` → current date
|
|
253
253
|
4. Verify:
|
|
@@ -336,7 +336,7 @@ If missing and Nyquist enabled — ask user:
|
|
|
336
336
|
|
|
337
337
|
Proceed to Step 8 only if user selects 2 or 3.
|
|
338
338
|
|
|
339
|
-
## 8. Spawn
|
|
339
|
+
## 8. Spawn ez-planner Agent
|
|
340
340
|
|
|
341
341
|
Display banner:
|
|
342
342
|
```
|
|
@@ -436,7 +436,7 @@ Task(
|
|
|
436
436
|
- **`## CHECKPOINT REACHED`:** Present to user, get response, spawn continuation (step 12)
|
|
437
437
|
- **`## PLANNING INCONCLUSIVE`:** Show attempts, offer: Add context / Retry / Manual
|
|
438
438
|
|
|
439
|
-
## 10. Spawn
|
|
439
|
+
## 10. Spawn ez-plan-checker Agent
|
|
440
440
|
|
|
441
441
|
Display banner:
|
|
442
442
|
```
|
|
@@ -640,11 +640,11 @@ Verification: {Passed | Passed with override | Skipped}
|
|
|
640
640
|
- [ ] Phase directory created if needed
|
|
641
641
|
- [ ] CONTEXT.md loaded early (step 4) and passed to ALL agents
|
|
642
642
|
- [ ] Research completed (unless --skip-research or --gaps or exists)
|
|
643
|
-
- [ ]
|
|
643
|
+
- [ ] ez-phase-researcher spawned with CONTEXT.md
|
|
644
644
|
- [ ] Existing plans checked
|
|
645
|
-
- [ ]
|
|
645
|
+
- [ ] ez-planner spawned with CONTEXT.md + RESEARCH.md
|
|
646
646
|
- [ ] Plans created (PLANNING COMPLETE or CHECKPOINT handled)
|
|
647
|
-
- [ ]
|
|
647
|
+
- [ ] ez-plan-checker spawned with CONTEXT.md
|
|
648
648
|
- [ ] Verification passed OR user override OR max iterations with user decision
|
|
649
649
|
- [ ] User sees status between agent spawns
|
|
650
650
|
- [ ] User knows next steps
|
|
@@ -38,7 +38,7 @@ If missing both ROADMAP.md and PROJECT.md: suggest `/ez:new-project`.
|
|
|
38
38
|
</step>
|
|
39
39
|
|
|
40
40
|
<step name="load">
|
|
41
|
-
**Use structured extraction from
|
|
41
|
+
**Use structured extraction from ez-tools:**
|
|
42
42
|
|
|
43
43
|
Instead of reading full files, use targeted tools to get only the data needed for the report:
|
|
44
44
|
- `ROADMAP=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" roadmap analyze)`
|
|
@@ -85,7 +85,7 @@ Use this instead of manually reading/parsing ROADMAP.md.
|
|
|
85
85
|
</step>
|
|
86
86
|
|
|
87
87
|
<step name="report">
|
|
88
|
-
**Generate progress bar from
|
|
88
|
+
**Generate progress bar from ez-tools, then present rich status report:**
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
91
|
# Get formatted progress bar
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Execute small, ad-hoc tasks with
|
|
2
|
+
Execute small, ad-hoc tasks with EZ Agents guarantees (atomic commits, STATE.md tracking). Quick mode spawns ez-planner (quick mode) + ez-executor(s), tracks tasks in `.planning/quick/`, and updates STATE.md's "Quick Tasks Completed" table.
|
|
3
3
|
|
|
4
4
|
With `--discuss` flag: lightweight discussion phase before planning. Surfaces assumptions, clarifies gray areas, captures decisions in CONTEXT.md so the planner treats them as locked.
|
|
5
5
|
|
|
@@ -39,7 +39,7 @@ Display banner based on active flags:
|
|
|
39
39
|
If `$DISCUSS_MODE` and `$FULL_MODE`:
|
|
40
40
|
```
|
|
41
41
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
42
|
-
|
|
42
|
+
EZ Agents ► QUICK TASK (DISCUSS + FULL)
|
|
43
43
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
44
44
|
|
|
45
45
|
◆ Discussion + plan checking + verification enabled
|
|
@@ -48,7 +48,7 @@ If `$DISCUSS_MODE` and `$FULL_MODE`:
|
|
|
48
48
|
If `$DISCUSS_MODE` only:
|
|
49
49
|
```
|
|
50
50
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
51
|
-
|
|
51
|
+
EZ Agents ► QUICK TASK (DISCUSS)
|
|
52
52
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
53
53
|
|
|
54
54
|
◆ Discussion phase enabled — surfacing gray areas before planning
|
|
@@ -57,7 +57,7 @@ If `$DISCUSS_MODE` only:
|
|
|
57
57
|
If `$FULL_MODE` only:
|
|
58
58
|
```
|
|
59
59
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
60
|
-
|
|
60
|
+
EZ Agents ► QUICK TASK (FULL MODE)
|
|
61
61
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
62
62
|
|
|
63
63
|
◆ Plan checking + verification enabled
|
|
@@ -114,7 +114,7 @@ Skip this step entirely if NOT `$DISCUSS_MODE`.
|
|
|
114
114
|
Display banner:
|
|
115
115
|
```
|
|
116
116
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
117
|
-
|
|
117
|
+
EZ Agents ► DISCUSSING QUICK TASK
|
|
118
118
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
119
119
|
|
|
120
120
|
◆ Surfacing gray areas for: ${DESCRIPTION}
|
|
@@ -295,7 +295,7 @@ Skip this step entirely if NOT `$FULL_MODE`.
|
|
|
295
295
|
Display banner:
|
|
296
296
|
```
|
|
297
297
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
298
|
-
|
|
298
|
+
EZ Agents ► CHECKING PLAN
|
|
299
299
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
300
300
|
|
|
301
301
|
◆ Spawning plan checker...
|
|
@@ -396,7 +396,7 @@ Offer: 1) Force proceed, 2) Abort
|
|
|
396
396
|
|
|
397
397
|
**Step 6: Spawn executor**
|
|
398
398
|
|
|
399
|
-
Spawn
|
|
399
|
+
Spawn ez-executor with plan reference:
|
|
400
400
|
|
|
401
401
|
```
|
|
402
402
|
Task(
|
|
@@ -443,7 +443,7 @@ Skip this step entirely if NOT `$FULL_MODE`.
|
|
|
443
443
|
Display banner:
|
|
444
444
|
```
|
|
445
445
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
446
|
-
|
|
446
|
+
EZ Agents ► VERIFYING RESULTS
|
|
447
447
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
448
448
|
|
|
449
449
|
◆ Spawning verifier...
|
|
@@ -562,7 +562,7 @@ Display completion output:
|
|
|
562
562
|
```
|
|
563
563
|
---
|
|
564
564
|
|
|
565
|
-
|
|
565
|
+
EZ Agents > QUICK TASK COMPLETE (FULL MODE)
|
|
566
566
|
|
|
567
567
|
Quick Task ${quick_id}: ${DESCRIPTION}
|
|
568
568
|
|
|
@@ -579,7 +579,7 @@ Ready for next task: /ez:quick
|
|
|
579
579
|
```
|
|
580
580
|
---
|
|
581
581
|
|
|
582
|
-
|
|
582
|
+
EZ Agents > QUICK TASK COMPLETE
|
|
583
583
|
|
|
584
584
|
Quick Task ${quick_id}: ${DESCRIPTION}
|
|
585
585
|
|
|
@@ -77,13 +77,13 @@ Wait for confirmation.
|
|
|
77
77
|
</step>
|
|
78
78
|
|
|
79
79
|
<step name="execute_removal">
|
|
80
|
-
**Delegate the entire removal operation to
|
|
80
|
+
**Delegate the entire removal operation to ez-tools:**
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
83
|
RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase remove "${target}")
|
|
84
84
|
```
|
|
85
85
|
|
|
86
|
-
If the phase has executed plans (SUMMARY.md files),
|
|
86
|
+
If the phase has executed plans (SUMMARY.md files), ez-tools will error. Use `--force` only if the user confirms:
|
|
87
87
|
|
|
88
88
|
```bash
|
|
89
89
|
RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase remove "${target}" --force)
|
|
@@ -140,7 +140,7 @@ Would you like to:
|
|
|
140
140
|
|
|
141
141
|
- Don't remove completed phases (have SUMMARY.md files) without --force
|
|
142
142
|
- Don't remove current or past phases
|
|
143
|
-
- Don't manually renumber — use `
|
|
143
|
+
- Don't manually renumber — use `ez-tools phase remove` which handles all renumbering
|
|
144
144
|
- Don't add "removed phase" notes to STATE.md — git commit is the record
|
|
145
145
|
- Don't modify completed phase directories
|
|
146
146
|
</anti_patterns>
|
|
@@ -149,7 +149,7 @@ Would you like to:
|
|
|
149
149
|
Phase removal is complete when:
|
|
150
150
|
|
|
151
151
|
- [ ] Target phase validated as future/unstarted
|
|
152
|
-
- [ ] `
|
|
152
|
+
- [ ] `ez-tools phase remove` executed successfully
|
|
153
153
|
- [ ] Changes committed with descriptive message
|
|
154
154
|
- [ ] User informed of changes
|
|
155
155
|
</success_criteria>
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Research how to implement a phase. Spawns
|
|
2
|
+
Research how to implement a phase. Spawns ez-phase-researcher with phase context.
|
|
3
3
|
|
|
4
4
|
Standalone research command. For most workflows, use `/ez:plan-phase` which integrates research automatically.
|
|
5
5
|
</purpose>
|
|
@@ -8,14 +8,14 @@ Standalone research command. For most workflows, use `/ez:plan-phase` which inte
|
|
|
8
8
|
|
|
9
9
|
## Step 0: Resolve Model Profile
|
|
10
10
|
|
|
11
|
-
@~/.claude/
|
|
11
|
+
@~/.claude/ez-agents/references/model-profile-resolution.md
|
|
12
12
|
|
|
13
13
|
Resolve model for:
|
|
14
|
-
- `
|
|
14
|
+
- `ez-phase-researcher`
|
|
15
15
|
|
|
16
16
|
## Step 1: Normalize and Validate Phase
|
|
17
17
|
|
|
18
|
-
@~/.claude/
|
|
18
|
+
@~/.claude/ez-agents/references/phase-argument-parsing.md
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
21
|
PHASE_INFO=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" roadmap get-phase "${PHASE}")
|
|
@@ -11,7 +11,7 @@ Instantly restore full project context so "Where were we?" has an immediate, com
|
|
|
11
11
|
</purpose>
|
|
12
12
|
|
|
13
13
|
<required_reading>
|
|
14
|
-
@~/.claude/
|
|
14
|
+
@~/.claude/ez-agents/references/continuation-format.md
|
|
15
15
|
</required_reading>
|
|
16
16
|
|
|
17
17
|
<process>
|
|
@@ -57,9 +57,9 @@ Agents will now use:
|
|
|
57
57
|
Example:
|
|
58
58
|
| Agent | Model |
|
|
59
59
|
|-------|-------|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
60
|
+
| ez-planner | opus |
|
|
61
|
+
| ez-executor | sonnet |
|
|
62
|
+
| ez-verifier | haiku |
|
|
63
63
|
| ... | ... |
|
|
64
64
|
|
|
65
65
|
Next spawned agents will use the new profile.
|
|
@@ -120,7 +120,7 @@ If found, delete them — phase is complete, handoffs are stale.
|
|
|
120
120
|
|
|
121
121
|
<step name="update_roadmap_and_state">
|
|
122
122
|
|
|
123
|
-
**Delegate ROADMAP.md and STATE.md updates to
|
|
123
|
+
**Delegate ROADMAP.md and STATE.md updates to ez-tools:**
|
|
124
124
|
|
|
125
125
|
```bash
|
|
126
126
|
TRANSITION=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase complete "${current_phase}")
|
|
@@ -233,7 +233,7 @@ After (Phase 2 shipped JWT auth, discovered rate limiting needed):
|
|
|
233
233
|
|
|
234
234
|
<step name="update_current_position_after_transition">
|
|
235
235
|
|
|
236
|
-
**Note:** Basic position updates (Current Phase, Status, Current Plan, Last Activity) were already handled by `
|
|
236
|
+
**Note:** Basic position updates (Current Phase, Status, Current Plan, Last Activity) were already handled by `ez-tools phase complete` in the update_roadmap_and_state step.
|
|
237
237
|
|
|
238
238
|
Verify the updates are correct by reading STATE.md. If the progress bar needs updating, use:
|
|
239
239
|
|
|
@@ -337,7 +337,7 @@ Resume file: None
|
|
|
337
337
|
|
|
338
338
|
**MANDATORY: Verify milestone status before presenting next steps.**
|
|
339
339
|
|
|
340
|
-
**Use the transition result from `
|
|
340
|
+
**Use the transition result from `ez-tools phase complete`:**
|
|
341
341
|
|
|
342
342
|
The `is_last_phase` field from the phase complete result tells you directly:
|
|
343
343
|
- `is_last_phase: false` → More phases remain → Go to **Route A**
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Generate a UI design contract (UI-SPEC.md) for frontend phases. Orchestrates
|
|
2
|
+
Generate a UI design contract (UI-SPEC.md) for frontend phases. Orchestrates ez-ui-researcher and ez-ui-checker with a revision loop. Inserts between discuss-phase and plan-phase in the lifecycle.
|
|
3
3
|
|
|
4
4
|
UI-SPEC.md locks spacing, typography, color, copywriting, and design system decisions before the planner creates tasks. This prevents design debt caused by ad-hoc styling decisions during execution.
|
|
5
5
|
</purpose>
|
|
6
6
|
|
|
7
7
|
<required_reading>
|
|
8
|
-
@~/.claude/
|
|
8
|
+
@~/.claude/ez-agents/references/ui-brand.md
|
|
9
9
|
</required_reading>
|
|
10
10
|
|
|
11
11
|
<process>
|
|
@@ -24,8 +24,8 @@ Parse JSON for: `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded
|
|
|
24
24
|
Resolve UI agent models:
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
UI_RESEARCHER_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model
|
|
28
|
-
UI_CHECKER_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model
|
|
27
|
+
UI_RESEARCHER_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model ez-ui-researcher --raw)
|
|
28
|
+
UI_CHECKER_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model ez-ui-checker --raw)
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
Check config:
|
|
@@ -87,7 +87,7 @@ If "View": display file contents, exit.
|
|
|
87
87
|
If "Skip": proceed to step 7 (checker).
|
|
88
88
|
If "Update": continue to step 5.
|
|
89
89
|
|
|
90
|
-
## 5. Spawn
|
|
90
|
+
## 5. Spawn ez-ui-researcher
|
|
91
91
|
|
|
92
92
|
Display:
|
|
93
93
|
```
|
|
@@ -101,7 +101,7 @@ Display:
|
|
|
101
101
|
Build prompt:
|
|
102
102
|
|
|
103
103
|
```markdown
|
|
104
|
-
Read ~/.claude/agents/
|
|
104
|
+
Read ~/.claude/agents/ez-ui-researcher.md for instructions.
|
|
105
105
|
|
|
106
106
|
<objective>
|
|
107
107
|
Create UI design contract for Phase {phase_number}: {phase_name}
|
|
@@ -118,7 +118,7 @@ Answer: "What visual and interaction contracts does this phase need?"
|
|
|
118
118
|
|
|
119
119
|
<output>
|
|
120
120
|
Write to: {phase_dir}/{padded_phase}-UI-SPEC.md
|
|
121
|
-
Template: ~/.claude/
|
|
121
|
+
Template: ~/.claude/ez-agents/templates/UI-SPEC.md
|
|
122
122
|
</output>
|
|
123
123
|
|
|
124
124
|
<config>
|
|
@@ -147,7 +147,7 @@ Display confirmation. Continue to step 7.
|
|
|
147
147
|
**If `## UI-SPEC BLOCKED`:**
|
|
148
148
|
Display blocker details and options. Exit workflow.
|
|
149
149
|
|
|
150
|
-
## 7. Spawn
|
|
150
|
+
## 7. Spawn ez-ui-checker
|
|
151
151
|
|
|
152
152
|
Display:
|
|
153
153
|
```
|
|
@@ -161,7 +161,7 @@ Display:
|
|
|
161
161
|
Build prompt:
|
|
162
162
|
|
|
163
163
|
```markdown
|
|
164
|
-
Read ~/.claude/agents/
|
|
164
|
+
Read ~/.claude/agents/ez-ui-checker.md for instructions.
|
|
165
165
|
|
|
166
166
|
<objective>
|
|
167
167
|
Validate UI design contract for Phase {phase_number}: {phase_name}
|
|
@@ -202,7 +202,7 @@ Track `revision_count` (starts at 0).
|
|
|
202
202
|
|
|
203
203
|
**If `revision_count` < 2:**
|
|
204
204
|
- Increment `revision_count`
|
|
205
|
-
- Re-spawn
|
|
205
|
+
- Re-spawn ez-ui-researcher with revision context:
|
|
206
206
|
|
|
207
207
|
```markdown
|
|
208
208
|
<revision>
|
|
@@ -279,9 +279,9 @@ node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" state record-session \
|
|
|
279
279
|
- [ ] Phase validated against roadmap
|
|
280
280
|
- [ ] Prerequisites checked (CONTEXT.md, RESEARCH.md — non-blocking warnings)
|
|
281
281
|
- [ ] Existing UI-SPEC handled (update/view/skip)
|
|
282
|
-
- [ ]
|
|
282
|
+
- [ ] ez-ui-researcher spawned with correct context and file paths
|
|
283
283
|
- [ ] UI-SPEC.md created in correct location
|
|
284
|
-
- [ ]
|
|
284
|
+
- [ ] ez-ui-checker spawned with UI-SPEC.md
|
|
285
285
|
- [ ] All 6 dimensions evaluated
|
|
286
286
|
- [ ] Revision loop if BLOCKED (max 2 iterations)
|
|
287
287
|
- [ ] Final status displayed with next steps
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Retroactive 6-pillar visual audit of implemented frontend code. Standalone command that works on any project —
|
|
2
|
+
Retroactive 6-pillar visual audit of implemented frontend code. Standalone command that works on any project — ez-managed or not. Produces scored UI-REVIEW.md with actionable findings.
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
6
|
-
@~/.claude/
|
|
6
|
+
@~/.claude/ez-agents/references/ui-brand.md
|
|
7
7
|
</required_reading>
|
|
8
8
|
|
|
9
9
|
<process>
|
|
@@ -18,7 +18,7 @@ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
|
|
|
18
18
|
Parse: `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`, `commit_docs`.
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
UI_AUDITOR_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model
|
|
21
|
+
UI_AUDITOR_MODEL=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model ez-ui-auditor --raw)
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
Display banner:
|
|
@@ -56,7 +56,7 @@ Build file list for auditor:
|
|
|
56
56
|
- UI-SPEC.md (if exists — audit baseline)
|
|
57
57
|
- CONTEXT.md (if exists — locked decisions)
|
|
58
58
|
|
|
59
|
-
## 3. Spawn
|
|
59
|
+
## 3. Spawn ez-ui-auditor
|
|
60
60
|
|
|
61
61
|
```
|
|
62
62
|
◆ Spawning UI auditor...
|
|
@@ -65,7 +65,7 @@ Build file list for auditor:
|
|
|
65
65
|
Build prompt:
|
|
66
66
|
|
|
67
67
|
```markdown
|
|
68
|
-
Read ~/.claude/agents/
|
|
68
|
+
Read ~/.claude/agents/ez-ui-auditor.md for instructions.
|
|
69
69
|
|
|
70
70
|
<objective>
|
|
71
71
|
Conduct 6-pillar visual audit of Phase {phase_number}: {phase_name}
|
|
@@ -150,7 +150,7 @@ node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" commit "docs(${padded_phase}): U
|
|
|
150
150
|
- [ ] Phase validated
|
|
151
151
|
- [ ] SUMMARY.md files found (execution completed)
|
|
152
152
|
- [ ] Existing review handled (re-audit/view)
|
|
153
|
-
- [ ]
|
|
153
|
+
- [ ] ez-ui-auditor spawned with correct context
|
|
154
154
|
- [ ] UI-REVIEW.md created in phase directory
|
|
155
155
|
- [ ] Score summary displayed to user
|
|
156
156
|
- [ ] Next steps presented
|