@howlil/ez-agents 3.4.1 → 3.5.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.
Files changed (162) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +84 -20
  3. package/agents/ez-observer-agent.md +260 -0
  4. package/agents/ez-release-agent.md +333 -0
  5. package/agents/ez-requirements-agent.md +377 -0
  6. package/agents/ez-scrum-master-agent.md +242 -0
  7. package/agents/ez-tech-lead-agent.md +267 -0
  8. package/bin/install.js +3221 -3230
  9. package/commands/ez/arch-review.md +102 -0
  10. package/commands/ez/execute-phase.md +11 -0
  11. package/commands/ez/export-session.md +79 -0
  12. package/commands/ez/gather-requirements.md +117 -0
  13. package/commands/ez/git-workflow.md +72 -0
  14. package/commands/ez/hotfix.md +120 -0
  15. package/commands/ez/import-session.md +82 -0
  16. package/commands/ez/join-discord.md +18 -18
  17. package/commands/ez/list-sessions.md +96 -0
  18. package/commands/ez/package-manager.md +316 -0
  19. package/commands/ez/plan-phase.md +9 -1
  20. package/commands/ez/preflight.md +79 -0
  21. package/commands/ez/progress.md +13 -1
  22. package/commands/ez/release.md +153 -0
  23. package/commands/ez/resume.md +107 -0
  24. package/commands/ez/standup.md +85 -0
  25. package/ez-agents/bin/ez-tools.cjs +1095 -716
  26. package/ez-agents/bin/lib/assistant-adapter.cjs +264 -264
  27. package/ez-agents/bin/lib/audit-exec.cjs +7 -2
  28. package/ez-agents/bin/lib/bdd-validator.cjs +622 -0
  29. package/ez-agents/bin/lib/circuit-breaker.cjs +118 -118
  30. package/ez-agents/bin/lib/config.cjs +190 -190
  31. package/ez-agents/bin/lib/content-scanner.cjs +238 -0
  32. package/ez-agents/bin/lib/context-cache.cjs +154 -0
  33. package/ez-agents/bin/lib/context-errors.cjs +71 -0
  34. package/ez-agents/bin/lib/context-manager.cjs +220 -0
  35. package/ez-agents/bin/lib/discussion-synthesizer.cjs +458 -0
  36. package/ez-agents/bin/lib/file-access.cjs +207 -0
  37. package/ez-agents/bin/lib/file-lock.cjs +236 -236
  38. package/ez-agents/bin/lib/frontmatter.cjs +299 -299
  39. package/ez-agents/bin/lib/fs-utils.cjs +153 -153
  40. package/ez-agents/bin/lib/git-errors.cjs +83 -0
  41. package/ez-agents/bin/lib/git-utils.cjs +118 -0
  42. package/ez-agents/bin/lib/git-workflow-engine.cjs +1157 -0
  43. package/ez-agents/bin/lib/index.cjs +157 -113
  44. package/ez-agents/bin/lib/init.cjs +757 -757
  45. package/ez-agents/bin/lib/lockfile-validator.cjs +227 -0
  46. package/ez-agents/bin/lib/logger.cjs +124 -124
  47. package/ez-agents/bin/lib/memory-compression.cjs +256 -0
  48. package/ez-agents/bin/lib/metrics-tracker.cjs +406 -0
  49. package/ez-agents/bin/lib/milestone.cjs +241 -241
  50. package/ez-agents/bin/lib/model-provider.cjs +241 -241
  51. package/ez-agents/bin/lib/package-manager-detector.cjs +203 -0
  52. package/ez-agents/bin/lib/package-manager-executor.cjs +385 -0
  53. package/ez-agents/bin/lib/package-manager-service.cjs +216 -0
  54. package/ez-agents/bin/lib/phase.cjs +925 -925
  55. package/ez-agents/bin/lib/planning-write.cjs +107 -107
  56. package/ez-agents/bin/lib/release-validator.cjs +614 -0
  57. package/ez-agents/bin/lib/retry.cjs +119 -119
  58. package/ez-agents/bin/lib/roadmap.cjs +306 -306
  59. package/ez-agents/bin/lib/safe-exec.cjs +128 -128
  60. package/ez-agents/bin/lib/safe-path.cjs +130 -130
  61. package/ez-agents/bin/lib/session-chain.cjs +304 -0
  62. package/ez-agents/bin/lib/session-errors.cjs +81 -0
  63. package/ez-agents/bin/lib/session-export.cjs +251 -0
  64. package/ez-agents/bin/lib/session-import.cjs +262 -0
  65. package/ez-agents/bin/lib/session-manager.cjs +280 -0
  66. package/ez-agents/bin/lib/state.cjs +736 -736
  67. package/ez-agents/bin/lib/temp-file.cjs +239 -239
  68. package/ez-agents/bin/lib/template.cjs +223 -223
  69. package/ez-agents/bin/lib/test-file-lock.cjs +112 -112
  70. package/ez-agents/bin/lib/test-graceful.cjs +93 -93
  71. package/ez-agents/bin/lib/test-logger.cjs +60 -60
  72. package/ez-agents/bin/lib/test-safe-exec.cjs +38 -38
  73. package/ez-agents/bin/lib/test-safe-path.cjs +33 -33
  74. package/ez-agents/bin/lib/test-temp-file.cjs +125 -125
  75. package/ez-agents/bin/lib/tier-manager.cjs +428 -0
  76. package/ez-agents/bin/lib/timeout-exec.cjs +63 -63
  77. package/ez-agents/bin/lib/url-fetch.cjs +170 -0
  78. package/ez-agents/bin/lib/verify.cjs +15 -1
  79. package/ez-agents/references/checkpoints.md +776 -776
  80. package/ez-agents/references/continuation-format.md +249 -249
  81. package/ez-agents/references/metrics-schema.md +118 -0
  82. package/ez-agents/references/planning-config.md +140 -0
  83. package/ez-agents/references/questioning.md +162 -162
  84. package/ez-agents/references/tdd.md +263 -263
  85. package/ez-agents/references/tier-strategy.md +103 -0
  86. package/ez-agents/templates/bdd-feature.md +173 -0
  87. package/ez-agents/templates/codebase/concerns.md +310 -310
  88. package/ez-agents/templates/codebase/conventions.md +307 -307
  89. package/ez-agents/templates/codebase/integrations.md +280 -280
  90. package/ez-agents/templates/codebase/stack.md +186 -186
  91. package/ez-agents/templates/codebase/testing.md +480 -480
  92. package/ez-agents/templates/config.json +37 -37
  93. package/ez-agents/templates/continue-here.md +78 -78
  94. package/ez-agents/templates/discussion.md +68 -0
  95. package/ez-agents/templates/incident-runbook.md +205 -0
  96. package/ez-agents/templates/milestone-archive.md +123 -123
  97. package/ez-agents/templates/milestone.md +115 -115
  98. package/ez-agents/templates/release-checklist.md +133 -0
  99. package/ez-agents/templates/requirements.md +231 -231
  100. package/ez-agents/templates/research-project/ARCHITECTURE.md +204 -204
  101. package/ez-agents/templates/research-project/FEATURES.md +147 -147
  102. package/ez-agents/templates/research-project/PITFALLS.md +200 -200
  103. package/ez-agents/templates/research-project/STACK.md +120 -120
  104. package/ez-agents/templates/research-project/SUMMARY.md +170 -170
  105. package/ez-agents/templates/retrospective.md +54 -54
  106. package/ez-agents/templates/roadmap.md +202 -202
  107. package/ez-agents/templates/rollback-plan.md +201 -0
  108. package/ez-agents/templates/summary-minimal.md +41 -41
  109. package/ez-agents/templates/summary-standard.md +48 -48
  110. package/ez-agents/templates/summary.md +248 -248
  111. package/ez-agents/templates/user-setup.md +311 -311
  112. package/ez-agents/templates/verification-report.md +322 -322
  113. package/ez-agents/workflows/add-phase.md +112 -112
  114. package/ez-agents/workflows/add-tests.md +351 -351
  115. package/ez-agents/workflows/add-todo.md +158 -158
  116. package/ez-agents/workflows/arch-review.md +54 -0
  117. package/ez-agents/workflows/audit-milestone.md +332 -332
  118. package/ez-agents/workflows/autonomous.md +131 -30
  119. package/ez-agents/workflows/check-todos.md +177 -177
  120. package/ez-agents/workflows/cleanup.md +152 -152
  121. package/ez-agents/workflows/complete-milestone.md +766 -766
  122. package/ez-agents/workflows/diagnose-issues.md +219 -219
  123. package/ez-agents/workflows/discovery-phase.md +289 -289
  124. package/ez-agents/workflows/discuss-phase.md +762 -762
  125. package/ez-agents/workflows/execute-phase.md +513 -468
  126. package/ez-agents/workflows/execute-plan.md +483 -483
  127. package/ez-agents/workflows/export-session.md +255 -0
  128. package/ez-agents/workflows/gather-requirements.md +206 -0
  129. package/ez-agents/workflows/health.md +159 -159
  130. package/ez-agents/workflows/help.md +584 -492
  131. package/ez-agents/workflows/hotfix.md +291 -0
  132. package/ez-agents/workflows/import-session.md +303 -0
  133. package/ez-agents/workflows/insert-phase.md +130 -130
  134. package/ez-agents/workflows/list-phase-assumptions.md +178 -178
  135. package/ez-agents/workflows/map-codebase.md +316 -316
  136. package/ez-agents/workflows/new-milestone.md +339 -10
  137. package/ez-agents/workflows/new-project.md +293 -299
  138. package/ez-agents/workflows/node-repair.md +92 -92
  139. package/ez-agents/workflows/pause-work.md +122 -122
  140. package/ez-agents/workflows/plan-milestone-gaps.md +274 -274
  141. package/ez-agents/workflows/plan-phase.md +673 -651
  142. package/ez-agents/workflows/progress.md +372 -382
  143. package/ez-agents/workflows/quick.md +610 -610
  144. package/ez-agents/workflows/release.md +253 -0
  145. package/ez-agents/workflows/remove-phase.md +155 -155
  146. package/ez-agents/workflows/research-phase.md +74 -74
  147. package/ez-agents/workflows/resume-project.md +307 -307
  148. package/ez-agents/workflows/resume-session.md +215 -0
  149. package/ez-agents/workflows/set-profile.md +81 -81
  150. package/ez-agents/workflows/settings.md +242 -242
  151. package/ez-agents/workflows/standup.md +64 -0
  152. package/ez-agents/workflows/stats.md +57 -57
  153. package/ez-agents/workflows/transition.md +544 -544
  154. package/ez-agents/workflows/ui-phase.md +290 -290
  155. package/ez-agents/workflows/ui-review.md +157 -157
  156. package/ez-agents/workflows/update.md +320 -320
  157. package/ez-agents/workflows/validate-phase.md +167 -167
  158. package/ez-agents/workflows/verify-phase.md +243 -243
  159. package/ez-agents/workflows/verify-work.md +584 -584
  160. package/package.json +10 -4
  161. package/scripts/build-hooks.js +43 -43
  162. package/scripts/run-tests.cjs +29 -29
@@ -1,147 +1,147 @@
1
- # Features Research Template
2
-
3
- Template for `.planning/research/FEATURES.md` — feature landscape for the project domain.
4
-
5
- <template>
6
-
7
- ```markdown
8
- # Feature Research
9
-
10
- **Domain:** [domain type]
11
- **Researched:** [date]
12
- **Confidence:** [HIGH/MEDIUM/LOW]
13
-
14
- ## Feature Landscape
15
-
16
- ### Table Stakes (Users Expect These)
17
-
18
- Features users assume exist. Missing these = product feels incomplete.
19
-
20
- | Feature | Why Expected | Complexity | Notes |
21
- |---------|--------------|------------|-------|
22
- | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
23
- | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
24
- | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
25
-
26
- ### Differentiators (Competitive Advantage)
27
-
28
- Features that set the product apart. Not required, but valuable.
29
-
30
- | Feature | Value Proposition | Complexity | Notes |
31
- |---------|-------------------|------------|-------|
32
- | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
33
- | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
34
- | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
35
-
36
- ### Anti-Features (Commonly Requested, Often Problematic)
37
-
38
- Features that seem good but create problems.
39
-
40
- | Feature | Why Requested | Why Problematic | Alternative |
41
- |---------|---------------|-----------------|-------------|
42
- | [feature] | [surface appeal] | [actual problems] | [better approach] |
43
- | [feature] | [surface appeal] | [actual problems] | [better approach] |
44
-
45
- ## Feature Dependencies
46
-
47
- ```
48
- [Feature A]
49
- └──requires──> [Feature B]
50
- └──requires──> [Feature C]
51
-
52
- [Feature D] ──enhances──> [Feature A]
53
-
54
- [Feature E] ──conflicts──> [Feature F]
55
- ```
56
-
57
- ### Dependency Notes
58
-
59
- - **[Feature A] requires [Feature B]:** [why the dependency exists]
60
- - **[Feature D] enhances [Feature A]:** [how they work together]
61
- - **[Feature E] conflicts with [Feature F]:** [why they're incompatible]
62
-
63
- ## MVP Definition
64
-
65
- ### Launch With (v1)
66
-
67
- Minimum viable product — what's needed to validate the concept.
68
-
69
- - [ ] [Feature] — [why essential]
70
- - [ ] [Feature] — [why essential]
71
- - [ ] [Feature] — [why essential]
72
-
73
- ### Add After Validation (v1.x)
74
-
75
- Features to add once core is working.
76
-
77
- - [ ] [Feature] — [trigger for adding]
78
- - [ ] [Feature] — [trigger for adding]
79
-
80
- ### Future Consideration (v2+)
81
-
82
- Features to defer until product-market fit is established.
83
-
84
- - [ ] [Feature] — [why defer]
85
- - [ ] [Feature] — [why defer]
86
-
87
- ## Feature Prioritization Matrix
88
-
89
- | Feature | User Value | Implementation Cost | Priority |
90
- |---------|------------|---------------------|----------|
91
- | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
92
- | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
93
- | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
94
-
95
- **Priority key:**
96
- - P1: Must have for launch
97
- - P2: Should have, add when possible
98
- - P3: Nice to have, future consideration
99
-
100
- ## Competitor Feature Analysis
101
-
102
- | Feature | Competitor A | Competitor B | Our Approach |
103
- |---------|--------------|--------------|--------------|
104
- | [feature] | [how they do it] | [how they do it] | [our plan] |
105
- | [feature] | [how they do it] | [how they do it] | [our plan] |
106
-
107
- ## Sources
108
-
109
- - [Competitor products analyzed]
110
- - [User research or feedback sources]
111
- - [Industry standards referenced]
112
-
113
- ---
114
- *Feature research for: [domain]*
115
- *Researched: [date]*
116
- ```
117
-
118
- </template>
119
-
120
- <guidelines>
121
-
122
- **Table Stakes:**
123
- - These are non-negotiable for launch
124
- - Users don't give credit for having them, but penalize for missing them
125
- - Example: A community platform without user profiles is broken
126
-
127
- **Differentiators:**
128
- - These are where you compete
129
- - Should align with the Core Value from PROJECT.md
130
- - Don't try to differentiate on everything
131
-
132
- **Anti-Features:**
133
- - Prevent scope creep by documenting what seems good but isn't
134
- - Include the alternative approach
135
- - Example: "Real-time everything" often creates complexity without value
136
-
137
- **Feature Dependencies:**
138
- - Critical for roadmap phase ordering
139
- - If A requires B, B must be in an earlier phase
140
- - Conflicts inform what NOT to combine in same phase
141
-
142
- **MVP Definition:**
143
- - Be ruthless about what's truly minimum
144
- - "Nice to have" is not MVP
145
- - Launch with less, validate, then expand
146
-
147
- </guidelines>
1
+ # Features Research Template
2
+
3
+ Template for `.planning/research/FEATURES.md` — feature landscape for the project domain.
4
+
5
+ <template>
6
+
7
+ ```markdown
8
+ # Feature Research
9
+
10
+ **Domain:** [domain type]
11
+ **Researched:** [date]
12
+ **Confidence:** [HIGH/MEDIUM/LOW]
13
+
14
+ ## Feature Landscape
15
+
16
+ ### Table Stakes (Users Expect These)
17
+
18
+ Features users assume exist. Missing these = product feels incomplete.
19
+
20
+ | Feature | Why Expected | Complexity | Notes |
21
+ |---------|--------------|------------|-------|
22
+ | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
23
+ | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
24
+ | [feature] | [user expectation] | LOW/MEDIUM/HIGH | [implementation notes] |
25
+
26
+ ### Differentiators (Competitive Advantage)
27
+
28
+ Features that set the product apart. Not required, but valuable.
29
+
30
+ | Feature | Value Proposition | Complexity | Notes |
31
+ |---------|-------------------|------------|-------|
32
+ | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
33
+ | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
34
+ | [feature] | [why it matters] | LOW/MEDIUM/HIGH | [implementation notes] |
35
+
36
+ ### Anti-Features (Commonly Requested, Often Problematic)
37
+
38
+ Features that seem good but create problems.
39
+
40
+ | Feature | Why Requested | Why Problematic | Alternative |
41
+ |---------|---------------|-----------------|-------------|
42
+ | [feature] | [surface appeal] | [actual problems] | [better approach] |
43
+ | [feature] | [surface appeal] | [actual problems] | [better approach] |
44
+
45
+ ## Feature Dependencies
46
+
47
+ ```
48
+ [Feature A]
49
+ └──requires──> [Feature B]
50
+ └──requires──> [Feature C]
51
+
52
+ [Feature D] ──enhances──> [Feature A]
53
+
54
+ [Feature E] ──conflicts──> [Feature F]
55
+ ```
56
+
57
+ ### Dependency Notes
58
+
59
+ - **[Feature A] requires [Feature B]:** [why the dependency exists]
60
+ - **[Feature D] enhances [Feature A]:** [how they work together]
61
+ - **[Feature E] conflicts with [Feature F]:** [why they're incompatible]
62
+
63
+ ## MVP Definition
64
+
65
+ ### Launch With (v1)
66
+
67
+ Minimum viable product — what's needed to validate the concept.
68
+
69
+ - [ ] [Feature] — [why essential]
70
+ - [ ] [Feature] — [why essential]
71
+ - [ ] [Feature] — [why essential]
72
+
73
+ ### Add After Validation (v1.x)
74
+
75
+ Features to add once core is working.
76
+
77
+ - [ ] [Feature] — [trigger for adding]
78
+ - [ ] [Feature] — [trigger for adding]
79
+
80
+ ### Future Consideration (v2+)
81
+
82
+ Features to defer until product-market fit is established.
83
+
84
+ - [ ] [Feature] — [why defer]
85
+ - [ ] [Feature] — [why defer]
86
+
87
+ ## Feature Prioritization Matrix
88
+
89
+ | Feature | User Value | Implementation Cost | Priority |
90
+ |---------|------------|---------------------|----------|
91
+ | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
92
+ | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
93
+ | [feature] | HIGH/MEDIUM/LOW | HIGH/MEDIUM/LOW | P1/P2/P3 |
94
+
95
+ **Priority key:**
96
+ - P1: Must have for launch
97
+ - P2: Should have, add when possible
98
+ - P3: Nice to have, future consideration
99
+
100
+ ## Competitor Feature Analysis
101
+
102
+ | Feature | Competitor A | Competitor B | Our Approach |
103
+ |---------|--------------|--------------|--------------|
104
+ | [feature] | [how they do it] | [how they do it] | [our plan] |
105
+ | [feature] | [how they do it] | [how they do it] | [our plan] |
106
+
107
+ ## Sources
108
+
109
+ - [Competitor products analyzed]
110
+ - [User research or feedback sources]
111
+ - [Industry standards referenced]
112
+
113
+ ---
114
+ *Feature research for: [domain]*
115
+ *Researched: [date]*
116
+ ```
117
+
118
+ </template>
119
+
120
+ <guidelines>
121
+
122
+ **Table Stakes:**
123
+ - These are non-negotiable for launch
124
+ - Users don't give credit for having them, but penalize for missing them
125
+ - Example: A community platform without user profiles is broken
126
+
127
+ **Differentiators:**
128
+ - These are where you compete
129
+ - Should align with the Core Value from PROJECT.md
130
+ - Don't try to differentiate on everything
131
+
132
+ **Anti-Features:**
133
+ - Prevent scope creep by documenting what seems good but isn't
134
+ - Include the alternative approach
135
+ - Example: "Real-time everything" often creates complexity without value
136
+
137
+ **Feature Dependencies:**
138
+ - Critical for roadmap phase ordering
139
+ - If A requires B, B must be in an earlier phase
140
+ - Conflicts inform what NOT to combine in same phase
141
+
142
+ **MVP Definition:**
143
+ - Be ruthless about what's truly minimum
144
+ - "Nice to have" is not MVP
145
+ - Launch with less, validate, then expand
146
+
147
+ </guidelines>