@howlil/ez-agents 3.4.1 → 3.4.2
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 +7 -18
- package/bin/install.js +52 -10
- package/commands/ez/join-discord.md +18 -18
- package/ez-agents/bin/lib/assistant-adapter.cjs +264 -264
- package/ez-agents/bin/lib/audit-exec.cjs +7 -2
- package/ez-agents/bin/lib/circuit-breaker.cjs +118 -118
- package/ez-agents/bin/lib/config.cjs +190 -190
- package/ez-agents/bin/lib/file-lock.cjs +236 -236
- package/ez-agents/bin/lib/frontmatter.cjs +299 -299
- package/ez-agents/bin/lib/fs-utils.cjs +153 -153
- package/ez-agents/bin/lib/git-utils.cjs +203 -203
- package/ez-agents/bin/lib/index.cjs +113 -113
- package/ez-agents/bin/lib/init.cjs +757 -757
- package/ez-agents/bin/lib/logger.cjs +47 -17
- package/ez-agents/bin/lib/milestone.cjs +241 -241
- package/ez-agents/bin/lib/model-provider.cjs +241 -241
- package/ez-agents/bin/lib/phase.cjs +925 -925
- package/ez-agents/bin/lib/planning-write.cjs +107 -107
- package/ez-agents/bin/lib/retry.cjs +119 -119
- package/ez-agents/bin/lib/roadmap.cjs +306 -306
- package/ez-agents/bin/lib/safe-exec.cjs +90 -4
- package/ez-agents/bin/lib/safe-path.cjs +130 -130
- package/ez-agents/bin/lib/state.cjs +736 -736
- package/ez-agents/bin/lib/temp-file.cjs +239 -239
- package/ez-agents/bin/lib/template.cjs +223 -223
- package/ez-agents/bin/lib/test-file-lock.cjs +112 -112
- package/ez-agents/bin/lib/test-graceful.cjs +93 -93
- package/ez-agents/bin/lib/test-logger.cjs +60 -60
- package/ez-agents/bin/lib/test-safe-exec.cjs +38 -38
- package/ez-agents/bin/lib/test-safe-path.cjs +33 -33
- package/ez-agents/bin/lib/test-temp-file.cjs +125 -125
- package/ez-agents/bin/lib/timeout-exec.cjs +63 -63
- package/ez-agents/bin/lib/verify.cjs +15 -1
- package/ez-agents/references/checkpoints.md +776 -776
- package/ez-agents/references/continuation-format.md +249 -249
- package/ez-agents/references/questioning.md +162 -162
- package/ez-agents/references/tdd.md +263 -263
- package/ez-agents/templates/codebase/concerns.md +310 -310
- package/ez-agents/templates/codebase/conventions.md +307 -307
- package/ez-agents/templates/codebase/integrations.md +280 -280
- package/ez-agents/templates/codebase/stack.md +186 -186
- package/ez-agents/templates/codebase/testing.md +480 -480
- package/ez-agents/templates/config.json +37 -37
- package/ez-agents/templates/continue-here.md +78 -78
- package/ez-agents/templates/milestone-archive.md +123 -123
- package/ez-agents/templates/milestone.md +115 -115
- package/ez-agents/templates/requirements.md +231 -231
- package/ez-agents/templates/research-project/ARCHITECTURE.md +204 -204
- package/ez-agents/templates/research-project/FEATURES.md +147 -147
- package/ez-agents/templates/research-project/PITFALLS.md +200 -200
- package/ez-agents/templates/research-project/STACK.md +120 -120
- package/ez-agents/templates/research-project/SUMMARY.md +170 -170
- package/ez-agents/templates/retrospective.md +54 -54
- package/ez-agents/templates/roadmap.md +202 -202
- package/ez-agents/templates/summary-minimal.md +41 -41
- package/ez-agents/templates/summary-standard.md +48 -48
- package/ez-agents/templates/summary.md +248 -248
- package/ez-agents/templates/user-setup.md +311 -311
- package/ez-agents/templates/verification-report.md +322 -322
- package/ez-agents/workflows/add-phase.md +112 -112
- package/ez-agents/workflows/add-tests.md +351 -351
- package/ez-agents/workflows/add-todo.md +158 -158
- package/ez-agents/workflows/audit-milestone.md +332 -332
- package/ez-agents/workflows/autonomous.md +743 -743
- package/ez-agents/workflows/check-todos.md +177 -177
- package/ez-agents/workflows/cleanup.md +152 -152
- package/ez-agents/workflows/complete-milestone.md +766 -766
- package/ez-agents/workflows/diagnose-issues.md +219 -219
- package/ez-agents/workflows/discovery-phase.md +289 -289
- package/ez-agents/workflows/discuss-phase.md +762 -762
- package/ez-agents/workflows/execute-phase.md +468 -468
- package/ez-agents/workflows/execute-plan.md +483 -483
- package/ez-agents/workflows/health.md +159 -159
- package/ez-agents/workflows/help.md +492 -492
- package/ez-agents/workflows/insert-phase.md +130 -130
- package/ez-agents/workflows/list-phase-assumptions.md +178 -178
- package/ez-agents/workflows/map-codebase.md +316 -316
- package/ez-agents/workflows/new-milestone.md +384 -384
- package/ez-agents/workflows/new-project.md +1113 -1113
- package/ez-agents/workflows/node-repair.md +92 -92
- package/ez-agents/workflows/pause-work.md +122 -122
- package/ez-agents/workflows/plan-milestone-gaps.md +274 -274
- package/ez-agents/workflows/plan-phase.md +651 -651
- package/ez-agents/workflows/progress.md +382 -382
- package/ez-agents/workflows/quick.md +610 -610
- package/ez-agents/workflows/remove-phase.md +155 -155
- package/ez-agents/workflows/research-phase.md +74 -74
- package/ez-agents/workflows/resume-project.md +307 -307
- package/ez-agents/workflows/set-profile.md +81 -81
- package/ez-agents/workflows/settings.md +242 -242
- package/ez-agents/workflows/stats.md +57 -57
- package/ez-agents/workflows/transition.md +544 -544
- package/ez-agents/workflows/ui-phase.md +290 -290
- package/ez-agents/workflows/ui-review.md +157 -157
- package/ez-agents/workflows/update.md +320 -320
- package/ez-agents/workflows/validate-phase.md +167 -167
- package/ez-agents/workflows/verify-phase.md +243 -243
- package/ez-agents/workflows/verify-work.md +584 -584
- package/package.json +2 -3
- package/scripts/build-hooks.js +43 -43
- package/scripts/run-tests.cjs +29 -29
|
@@ -1,112 +1,112 @@
|
|
|
1
|
-
<purpose>
|
|
2
|
-
Add a new integer phase to the end of the current milestone in the roadmap. Automatically calculates next phase number, creates phase directory, and updates roadmap structure.
|
|
3
|
-
</purpose>
|
|
4
|
-
|
|
5
|
-
<required_reading>
|
|
6
|
-
Read all files referenced by the invoking prompt's execution_context before starting.
|
|
7
|
-
</required_reading>
|
|
8
|
-
|
|
9
|
-
<process>
|
|
10
|
-
|
|
11
|
-
<step name="parse_arguments">
|
|
12
|
-
Parse the command arguments:
|
|
13
|
-
- All arguments become the phase description
|
|
14
|
-
- Example: `/ez:add-phase Add authentication` → description = "Add authentication"
|
|
15
|
-
- Example: `/ez:add-phase Fix critical performance issues` → description = "Fix critical performance issues"
|
|
16
|
-
|
|
17
|
-
If no arguments provided:
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
ERROR: Phase description required
|
|
21
|
-
Usage: /ez:add-phase <description>
|
|
22
|
-
Example: /ez:add-phase Add authentication system
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Exit.
|
|
26
|
-
</step>
|
|
27
|
-
|
|
28
|
-
<step name="init_context">
|
|
29
|
-
Load phase operation context:
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
INIT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" init phase-op "0")
|
|
33
|
-
if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Check `roadmap_exists` from init JSON. If false:
|
|
37
|
-
```
|
|
38
|
-
ERROR: No roadmap found (.planning/ROADMAP.md)
|
|
39
|
-
Run /ez:new-project to initialize.
|
|
40
|
-
```
|
|
41
|
-
Exit.
|
|
42
|
-
</step>
|
|
43
|
-
|
|
44
|
-
<step name="add_phase">
|
|
45
|
-
**Delegate the phase addition to ez-tools:**
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase add "${description}")
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
The CLI handles:
|
|
52
|
-
- Finding the highest existing integer phase number
|
|
53
|
-
- Calculating next phase number (max + 1)
|
|
54
|
-
- Generating slug from description
|
|
55
|
-
- Creating the phase directory (`.planning/phases/{NN}-{slug}/`)
|
|
56
|
-
- Inserting the phase entry into ROADMAP.md with Goal, Depends on, and Plans sections
|
|
57
|
-
|
|
58
|
-
Extract from result: `phase_number`, `padded`, `name`, `slug`, `directory`.
|
|
59
|
-
</step>
|
|
60
|
-
|
|
61
|
-
<step name="update_project_state">
|
|
62
|
-
Update STATE.md to reflect the new phase:
|
|
63
|
-
|
|
64
|
-
1. Read `.planning/STATE.md`
|
|
65
|
-
2. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
|
|
66
|
-
```
|
|
67
|
-
- Phase {N} added: {description}
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
If "Roadmap Evolution" section doesn't exist, create it.
|
|
71
|
-
</step>
|
|
72
|
-
|
|
73
|
-
<step name="completion">
|
|
74
|
-
Present completion summary:
|
|
75
|
-
|
|
76
|
-
```
|
|
77
|
-
Phase {N} added to current milestone:
|
|
78
|
-
- Description: {description}
|
|
79
|
-
- Directory: .planning/phases/{phase-num}-{slug}/
|
|
80
|
-
- Status: Not planned yet
|
|
81
|
-
|
|
82
|
-
Roadmap updated: .planning/ROADMAP.md
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## ▶ Next Up
|
|
87
|
-
|
|
88
|
-
**Phase {N}: {description}**
|
|
89
|
-
|
|
90
|
-
`/ez:plan-phase {N}`
|
|
91
|
-
|
|
92
|
-
<sub>`/clear` first → fresh context window</sub>
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
**Also available:**
|
|
97
|
-
- `/ez:add-phase <description>` — add another phase
|
|
98
|
-
- Review roadmap
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
```
|
|
102
|
-
</step>
|
|
103
|
-
|
|
104
|
-
</process>
|
|
105
|
-
|
|
106
|
-
<success_criteria>
|
|
107
|
-
- [ ] `ez-tools phase add` executed successfully
|
|
108
|
-
- [ ] Phase directory created
|
|
109
|
-
- [ ] Roadmap updated with new phase entry
|
|
110
|
-
- [ ] STATE.md updated with roadmap evolution note
|
|
111
|
-
- [ ] User informed of next steps
|
|
112
|
-
</success_criteria>
|
|
1
|
+
<purpose>
|
|
2
|
+
Add a new integer phase to the end of the current milestone in the roadmap. Automatically calculates next phase number, creates phase directory, and updates roadmap structure.
|
|
3
|
+
</purpose>
|
|
4
|
+
|
|
5
|
+
<required_reading>
|
|
6
|
+
Read all files referenced by the invoking prompt's execution_context before starting.
|
|
7
|
+
</required_reading>
|
|
8
|
+
|
|
9
|
+
<process>
|
|
10
|
+
|
|
11
|
+
<step name="parse_arguments">
|
|
12
|
+
Parse the command arguments:
|
|
13
|
+
- All arguments become the phase description
|
|
14
|
+
- Example: `/ez:add-phase Add authentication` → description = "Add authentication"
|
|
15
|
+
- Example: `/ez:add-phase Fix critical performance issues` → description = "Fix critical performance issues"
|
|
16
|
+
|
|
17
|
+
If no arguments provided:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
ERROR: Phase description required
|
|
21
|
+
Usage: /ez:add-phase <description>
|
|
22
|
+
Example: /ez:add-phase Add authentication system
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Exit.
|
|
26
|
+
</step>
|
|
27
|
+
|
|
28
|
+
<step name="init_context">
|
|
29
|
+
Load phase operation context:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
INIT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" init phase-op "0")
|
|
33
|
+
if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Check `roadmap_exists` from init JSON. If false:
|
|
37
|
+
```
|
|
38
|
+
ERROR: No roadmap found (.planning/ROADMAP.md)
|
|
39
|
+
Run /ez:new-project to initialize.
|
|
40
|
+
```
|
|
41
|
+
Exit.
|
|
42
|
+
</step>
|
|
43
|
+
|
|
44
|
+
<step name="add_phase">
|
|
45
|
+
**Delegate the phase addition to ez-tools:**
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
RESULT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" phase add "${description}")
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
The CLI handles:
|
|
52
|
+
- Finding the highest existing integer phase number
|
|
53
|
+
- Calculating next phase number (max + 1)
|
|
54
|
+
- Generating slug from description
|
|
55
|
+
- Creating the phase directory (`.planning/phases/{NN}-{slug}/`)
|
|
56
|
+
- Inserting the phase entry into ROADMAP.md with Goal, Depends on, and Plans sections
|
|
57
|
+
|
|
58
|
+
Extract from result: `phase_number`, `padded`, `name`, `slug`, `directory`.
|
|
59
|
+
</step>
|
|
60
|
+
|
|
61
|
+
<step name="update_project_state">
|
|
62
|
+
Update STATE.md to reflect the new phase:
|
|
63
|
+
|
|
64
|
+
1. Read `.planning/STATE.md`
|
|
65
|
+
2. Under "## Accumulated Context" → "### Roadmap Evolution" add entry:
|
|
66
|
+
```
|
|
67
|
+
- Phase {N} added: {description}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
If "Roadmap Evolution" section doesn't exist, create it.
|
|
71
|
+
</step>
|
|
72
|
+
|
|
73
|
+
<step name="completion">
|
|
74
|
+
Present completion summary:
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
Phase {N} added to current milestone:
|
|
78
|
+
- Description: {description}
|
|
79
|
+
- Directory: .planning/phases/{phase-num}-{slug}/
|
|
80
|
+
- Status: Not planned yet
|
|
81
|
+
|
|
82
|
+
Roadmap updated: .planning/ROADMAP.md
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## ▶ Next Up
|
|
87
|
+
|
|
88
|
+
**Phase {N}: {description}**
|
|
89
|
+
|
|
90
|
+
`/ez:plan-phase {N}`
|
|
91
|
+
|
|
92
|
+
<sub>`/clear` first → fresh context window</sub>
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
**Also available:**
|
|
97
|
+
- `/ez:add-phase <description>` — add another phase
|
|
98
|
+
- Review roadmap
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
```
|
|
102
|
+
</step>
|
|
103
|
+
|
|
104
|
+
</process>
|
|
105
|
+
|
|
106
|
+
<success_criteria>
|
|
107
|
+
- [ ] `ez-tools phase add` executed successfully
|
|
108
|
+
- [ ] Phase directory created
|
|
109
|
+
- [ ] Roadmap updated with new phase entry
|
|
110
|
+
- [ ] STATE.md updated with roadmap evolution note
|
|
111
|
+
- [ ] User informed of next steps
|
|
112
|
+
</success_criteria>
|