@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
@@ -1,202 +1,202 @@
1
- # Roadmap Template
2
-
3
- Template for `.planning/ROADMAP.md`.
4
-
5
- ## Initial Roadmap (v1.0 Greenfield)
6
-
7
- ```markdown
8
- # Roadmap: [Project Name]
9
-
10
- ## Overview
11
-
12
- [One paragraph describing the journey from start to finish]
13
-
14
- ## Phases
15
-
16
- **Phase Numbering:**
17
- - Integer phases (1, 2, 3): Planned milestone work
18
- - Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)
19
-
20
- Decimal phases appear between their surrounding integers in numeric order.
21
-
22
- - [ ] **Phase 1: [Name]** - [One-line description]
23
- - [ ] **Phase 2: [Name]** - [One-line description]
24
- - [ ] **Phase 3: [Name]** - [One-line description]
25
- - [ ] **Phase 4: [Name]** - [One-line description]
26
-
27
- ## Phase Details
28
-
29
- ### Phase 1: [Name]
30
- **Goal**: [What this phase delivers]
31
- **Depends on**: Nothing (first phase)
32
- **Requirements**: [REQ-01, REQ-02, REQ-03] <!-- brackets optional, parser handles both formats -->
33
- **Success Criteria** (what must be TRUE):
34
- 1. [Observable behavior from user perspective]
35
- 2. [Observable behavior from user perspective]
36
- 3. [Observable behavior from user perspective]
37
- **Plans**: [Number of plans, e.g., "3 plans" or "TBD"]
38
-
39
- Plans:
40
- - [ ] 01-01: [Brief description of first plan]
41
- - [ ] 01-02: [Brief description of second plan]
42
- - [ ] 01-03: [Brief description of third plan]
43
-
44
- ### Phase 2: [Name]
45
- **Goal**: [What this phase delivers]
46
- **Depends on**: Phase 1
47
- **Requirements**: [REQ-04, REQ-05]
48
- **Success Criteria** (what must be TRUE):
49
- 1. [Observable behavior from user perspective]
50
- 2. [Observable behavior from user perspective]
51
- **Plans**: [Number of plans]
52
-
53
- Plans:
54
- - [ ] 02-01: [Brief description]
55
- - [ ] 02-02: [Brief description]
56
-
57
- ### Phase 2.1: Critical Fix (INSERTED)
58
- **Goal**: [Urgent work inserted between phases]
59
- **Depends on**: Phase 2
60
- **Success Criteria** (what must be TRUE):
61
- 1. [What the fix achieves]
62
- **Plans**: 1 plan
63
-
64
- Plans:
65
- - [ ] 02.1-01: [Description]
66
-
67
- ### Phase 3: [Name]
68
- **Goal**: [What this phase delivers]
69
- **Depends on**: Phase 2
70
- **Requirements**: [REQ-06, REQ-07, REQ-08]
71
- **Success Criteria** (what must be TRUE):
72
- 1. [Observable behavior from user perspective]
73
- 2. [Observable behavior from user perspective]
74
- 3. [Observable behavior from user perspective]
75
- **Plans**: [Number of plans]
76
-
77
- Plans:
78
- - [ ] 03-01: [Brief description]
79
- - [ ] 03-02: [Brief description]
80
-
81
- ### Phase 4: [Name]
82
- **Goal**: [What this phase delivers]
83
- **Depends on**: Phase 3
84
- **Requirements**: [REQ-09, REQ-10]
85
- **Success Criteria** (what must be TRUE):
86
- 1. [Observable behavior from user perspective]
87
- 2. [Observable behavior from user perspective]
88
- **Plans**: [Number of plans]
89
-
90
- Plans:
91
- - [ ] 04-01: [Brief description]
92
-
93
- ## Progress
94
-
95
- **Execution Order:**
96
- Phases execute in numeric order: 2 → 2.1 → 2.2 → 3 → 3.1 → 4
97
-
98
- | Phase | Plans Complete | Status | Completed |
99
- |-------|----------------|--------|-----------|
100
- | 1. [Name] | 0/3 | Not started | - |
101
- | 2. [Name] | 0/2 | Not started | - |
102
- | 3. [Name] | 0/2 | Not started | - |
103
- | 4. [Name] | 0/1 | Not started | - |
104
- ```
105
-
106
- <guidelines>
107
- **Initial planning (v1.0):**
108
- - Phase count depends on granularity setting (coarse: 3-5, standard: 5-8, fine: 8-12)
109
- - Each phase delivers something coherent
110
- - Phases can have 1+ plans (split if >3 tasks or multiple subsystems)
111
- - Plans use naming: {phase}-{plan}-PLAN.md (e.g., 01-02-PLAN.md)
112
- - No time estimates (this isn't enterprise PM)
113
- - Progress table updated by execute workflow
114
- - Plan count can be "TBD" initially, refined during planning
115
-
116
- **Success criteria:**
117
- - 2-5 observable behaviors per phase (from user's perspective)
118
- - Cross-checked against requirements during roadmap creation
119
- - Flow downstream to `must_haves` in plan-phase
120
- - Verified by verify-phase after execution
121
- - Format: "User can [action]" or "[Thing] works/exists"
122
-
123
- **After milestones ship:**
124
- - Collapse completed milestones in `<details>` tags
125
- - Add new milestone sections for upcoming work
126
- - Keep continuous phase numbering (never restart at 01)
127
- </guidelines>
128
-
129
- <status_values>
130
- - `Not started` - Haven't begun
131
- - `In progress` - Currently working
132
- - `Complete` - Done (add completion date)
133
- - `Deferred` - Pushed to later (with reason)
134
- </status_values>
135
-
136
- ## Milestone-Grouped Roadmap (After v1.0 Ships)
137
-
138
- After completing first milestone, reorganize with milestone groupings:
139
-
140
- ```markdown
141
- # Roadmap: [Project Name]
142
-
143
- ## Milestones
144
-
145
- - ✅ **v1.0 MVP** - Phases 1-4 (shipped YYYY-MM-DD)
146
- - 🚧 **v1.1 [Name]** - Phases 5-6 (in progress)
147
- - 📋 **v2.0 [Name]** - Phases 7-10 (planned)
148
-
149
- ## Phases
150
-
151
- <details>
152
- <summary>✅ v1.0 MVP (Phases 1-4) - SHIPPED YYYY-MM-DD</summary>
153
-
154
- ### Phase 1: [Name]
155
- **Goal**: [What this phase delivers]
156
- **Plans**: 3 plans
157
-
158
- Plans:
159
- - [x] 01-01: [Brief description]
160
- - [x] 01-02: [Brief description]
161
- - [x] 01-03: [Brief description]
162
-
163
- [... remaining v1.0 phases ...]
164
-
165
- </details>
166
-
167
- ### 🚧 v1.1 [Name] (In Progress)
168
-
169
- **Milestone Goal:** [What v1.1 delivers]
170
-
171
- #### Phase 5: [Name]
172
- **Goal**: [What this phase delivers]
173
- **Depends on**: Phase 4
174
- **Plans**: 2 plans
175
-
176
- Plans:
177
- - [ ] 05-01: [Brief description]
178
- - [ ] 05-02: [Brief description]
179
-
180
- [... remaining v1.1 phases ...]
181
-
182
- ### 📋 v2.0 [Name] (Planned)
183
-
184
- **Milestone Goal:** [What v2.0 delivers]
185
-
186
- [... v2.0 phases ...]
187
-
188
- ## Progress
189
-
190
- | Phase | Milestone | Plans Complete | Status | Completed |
191
- |-------|-----------|----------------|--------|-----------|
192
- | 1. Foundation | v1.0 | 3/3 | Complete | YYYY-MM-DD |
193
- | 2. Features | v1.0 | 2/2 | Complete | YYYY-MM-DD |
194
- | 5. Security | v1.1 | 0/2 | Not started | - |
195
- ```
196
-
197
- **Notes:**
198
- - Milestone emoji: ✅ shipped, 🚧 in progress, 📋 planned
199
- - Completed milestones collapsed in `<details>` for readability
200
- - Current/future milestones expanded
201
- - Continuous phase numbering (01-99)
202
- - Progress table includes milestone column
1
+ # Roadmap Template
2
+
3
+ Template for `.planning/ROADMAP.md`.
4
+
5
+ ## Initial Roadmap (v1.0 Greenfield)
6
+
7
+ ```markdown
8
+ # Roadmap: [Project Name]
9
+
10
+ ## Overview
11
+
12
+ [One paragraph describing the journey from start to finish]
13
+
14
+ ## Phases
15
+
16
+ **Phase Numbering:**
17
+ - Integer phases (1, 2, 3): Planned milestone work
18
+ - Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)
19
+
20
+ Decimal phases appear between their surrounding integers in numeric order.
21
+
22
+ - [ ] **Phase 1: [Name]** - [One-line description]
23
+ - [ ] **Phase 2: [Name]** - [One-line description]
24
+ - [ ] **Phase 3: [Name]** - [One-line description]
25
+ - [ ] **Phase 4: [Name]** - [One-line description]
26
+
27
+ ## Phase Details
28
+
29
+ ### Phase 1: [Name]
30
+ **Goal**: [What this phase delivers]
31
+ **Depends on**: Nothing (first phase)
32
+ **Requirements**: [REQ-01, REQ-02, REQ-03] <!-- brackets optional, parser handles both formats -->
33
+ **Success Criteria** (what must be TRUE):
34
+ 1. [Observable behavior from user perspective]
35
+ 2. [Observable behavior from user perspective]
36
+ 3. [Observable behavior from user perspective]
37
+ **Plans**: [Number of plans, e.g., "3 plans" or "TBD"]
38
+
39
+ Plans:
40
+ - [ ] 01-01: [Brief description of first plan]
41
+ - [ ] 01-02: [Brief description of second plan]
42
+ - [ ] 01-03: [Brief description of third plan]
43
+
44
+ ### Phase 2: [Name]
45
+ **Goal**: [What this phase delivers]
46
+ **Depends on**: Phase 1
47
+ **Requirements**: [REQ-04, REQ-05]
48
+ **Success Criteria** (what must be TRUE):
49
+ 1. [Observable behavior from user perspective]
50
+ 2. [Observable behavior from user perspective]
51
+ **Plans**: [Number of plans]
52
+
53
+ Plans:
54
+ - [ ] 02-01: [Brief description]
55
+ - [ ] 02-02: [Brief description]
56
+
57
+ ### Phase 2.1: Critical Fix (INSERTED)
58
+ **Goal**: [Urgent work inserted between phases]
59
+ **Depends on**: Phase 2
60
+ **Success Criteria** (what must be TRUE):
61
+ 1. [What the fix achieves]
62
+ **Plans**: 1 plan
63
+
64
+ Plans:
65
+ - [ ] 02.1-01: [Description]
66
+
67
+ ### Phase 3: [Name]
68
+ **Goal**: [What this phase delivers]
69
+ **Depends on**: Phase 2
70
+ **Requirements**: [REQ-06, REQ-07, REQ-08]
71
+ **Success Criteria** (what must be TRUE):
72
+ 1. [Observable behavior from user perspective]
73
+ 2. [Observable behavior from user perspective]
74
+ 3. [Observable behavior from user perspective]
75
+ **Plans**: [Number of plans]
76
+
77
+ Plans:
78
+ - [ ] 03-01: [Brief description]
79
+ - [ ] 03-02: [Brief description]
80
+
81
+ ### Phase 4: [Name]
82
+ **Goal**: [What this phase delivers]
83
+ **Depends on**: Phase 3
84
+ **Requirements**: [REQ-09, REQ-10]
85
+ **Success Criteria** (what must be TRUE):
86
+ 1. [Observable behavior from user perspective]
87
+ 2. [Observable behavior from user perspective]
88
+ **Plans**: [Number of plans]
89
+
90
+ Plans:
91
+ - [ ] 04-01: [Brief description]
92
+
93
+ ## Progress
94
+
95
+ **Execution Order:**
96
+ Phases execute in numeric order: 2 → 2.1 → 2.2 → 3 → 3.1 → 4
97
+
98
+ | Phase | Plans Complete | Status | Completed |
99
+ |-------|----------------|--------|-----------|
100
+ | 1. [Name] | 0/3 | Not started | - |
101
+ | 2. [Name] | 0/2 | Not started | - |
102
+ | 3. [Name] | 0/2 | Not started | - |
103
+ | 4. [Name] | 0/1 | Not started | - |
104
+ ```
105
+
106
+ <guidelines>
107
+ **Initial planning (v1.0):**
108
+ - Phase count depends on granularity setting (coarse: 3-5, standard: 5-8, fine: 8-12)
109
+ - Each phase delivers something coherent
110
+ - Phases can have 1+ plans (split if >3 tasks or multiple subsystems)
111
+ - Plans use naming: {phase}-{plan}-PLAN.md (e.g., 01-02-PLAN.md)
112
+ - No time estimates (this isn't enterprise PM)
113
+ - Progress table updated by execute workflow
114
+ - Plan count can be "TBD" initially, refined during planning
115
+
116
+ **Success criteria:**
117
+ - 2-5 observable behaviors per phase (from user's perspective)
118
+ - Cross-checked against requirements during roadmap creation
119
+ - Flow downstream to `must_haves` in plan-phase
120
+ - Verified by verify-phase after execution
121
+ - Format: "User can [action]" or "[Thing] works/exists"
122
+
123
+ **After milestones ship:**
124
+ - Collapse completed milestones in `<details>` tags
125
+ - Add new milestone sections for upcoming work
126
+ - Keep continuous phase numbering (never restart at 01)
127
+ </guidelines>
128
+
129
+ <status_values>
130
+ - `Not started` - Haven't begun
131
+ - `In progress` - Currently working
132
+ - `Complete` - Done (add completion date)
133
+ - `Deferred` - Pushed to later (with reason)
134
+ </status_values>
135
+
136
+ ## Milestone-Grouped Roadmap (After v1.0 Ships)
137
+
138
+ After completing first milestone, reorganize with milestone groupings:
139
+
140
+ ```markdown
141
+ # Roadmap: [Project Name]
142
+
143
+ ## Milestones
144
+
145
+ - ✅ **v1.0 MVP** - Phases 1-4 (shipped YYYY-MM-DD)
146
+ - 🚧 **v1.1 [Name]** - Phases 5-6 (in progress)
147
+ - 📋 **v2.0 [Name]** - Phases 7-10 (planned)
148
+
149
+ ## Phases
150
+
151
+ <details>
152
+ <summary>✅ v1.0 MVP (Phases 1-4) - SHIPPED YYYY-MM-DD</summary>
153
+
154
+ ### Phase 1: [Name]
155
+ **Goal**: [What this phase delivers]
156
+ **Plans**: 3 plans
157
+
158
+ Plans:
159
+ - [x] 01-01: [Brief description]
160
+ - [x] 01-02: [Brief description]
161
+ - [x] 01-03: [Brief description]
162
+
163
+ [... remaining v1.0 phases ...]
164
+
165
+ </details>
166
+
167
+ ### 🚧 v1.1 [Name] (In Progress)
168
+
169
+ **Milestone Goal:** [What v1.1 delivers]
170
+
171
+ #### Phase 5: [Name]
172
+ **Goal**: [What this phase delivers]
173
+ **Depends on**: Phase 4
174
+ **Plans**: 2 plans
175
+
176
+ Plans:
177
+ - [ ] 05-01: [Brief description]
178
+ - [ ] 05-02: [Brief description]
179
+
180
+ [... remaining v1.1 phases ...]
181
+
182
+ ### 📋 v2.0 [Name] (Planned)
183
+
184
+ **Milestone Goal:** [What v2.0 delivers]
185
+
186
+ [... v2.0 phases ...]
187
+
188
+ ## Progress
189
+
190
+ | Phase | Milestone | Plans Complete | Status | Completed |
191
+ |-------|-----------|----------------|--------|-----------|
192
+ | 1. Foundation | v1.0 | 3/3 | Complete | YYYY-MM-DD |
193
+ | 2. Features | v1.0 | 2/2 | Complete | YYYY-MM-DD |
194
+ | 5. Security | v1.1 | 0/2 | Not started | - |
195
+ ```
196
+
197
+ **Notes:**
198
+ - Milestone emoji: ✅ shipped, 🚧 in progress, 📋 planned
199
+ - Completed milestones collapsed in `<details>` for readability
200
+ - Current/future milestones expanded
201
+ - Continuous phase numbering (01-99)
202
+ - Progress table includes milestone column
@@ -1,41 +1,41 @@
1
- ---
2
- phase: XX-name
3
- plan: YY
4
- subsystem: [primary category]
5
- tags: [searchable tech]
6
- provides:
7
- - [bullet list of what was built/delivered]
8
- affects: [list of phase names or keywords]
9
- tech-stack:
10
- added: [libraries/tools]
11
- patterns: [architectural/code patterns]
12
- key-files:
13
- created: [important files created]
14
- modified: [important files modified]
15
- key-decisions: []
16
- duration: Xmin
17
- completed: YYYY-MM-DD
18
- ---
19
-
20
- # Phase [X]: [Name] Summary (Minimal)
21
-
22
- **[Substantive one-liner describing outcome]**
23
-
24
- ## Performance
25
- - **Duration:** [time]
26
- - **Tasks:** [count]
27
- - **Files modified:** [count]
28
-
29
- ## Accomplishments
30
- - [Most important outcome]
31
- - [Second key accomplishment]
32
-
33
- ## Task Commits
34
- 1. **Task 1: [task name]** - `hash`
35
- 2. **Task 2: [task name]** - `hash`
36
-
37
- ## Files Created/Modified
38
- - `path/to/file.ts` - What it does
39
-
40
- ## Next Phase Readiness
41
- [Ready for next phase]
1
+ ---
2
+ phase: XX-name
3
+ plan: YY
4
+ subsystem: [primary category]
5
+ tags: [searchable tech]
6
+ provides:
7
+ - [bullet list of what was built/delivered]
8
+ affects: [list of phase names or keywords]
9
+ tech-stack:
10
+ added: [libraries/tools]
11
+ patterns: [architectural/code patterns]
12
+ key-files:
13
+ created: [important files created]
14
+ modified: [important files modified]
15
+ key-decisions: []
16
+ duration: Xmin
17
+ completed: YYYY-MM-DD
18
+ ---
19
+
20
+ # Phase [X]: [Name] Summary (Minimal)
21
+
22
+ **[Substantive one-liner describing outcome]**
23
+
24
+ ## Performance
25
+ - **Duration:** [time]
26
+ - **Tasks:** [count]
27
+ - **Files modified:** [count]
28
+
29
+ ## Accomplishments
30
+ - [Most important outcome]
31
+ - [Second key accomplishment]
32
+
33
+ ## Task Commits
34
+ 1. **Task 1: [task name]** - `hash`
35
+ 2. **Task 2: [task name]** - `hash`
36
+
37
+ ## Files Created/Modified
38
+ - `path/to/file.ts` - What it does
39
+
40
+ ## Next Phase Readiness
41
+ [Ready for next phase]
@@ -1,48 +1,48 @@
1
- ---
2
- phase: XX-name
3
- plan: YY
4
- subsystem: [primary category]
5
- tags: [searchable tech]
6
- provides:
7
- - [bullet list of what was built/delivered]
8
- affects: [list of phase names or keywords]
9
- tech-stack:
10
- added: [libraries/tools]
11
- patterns: [architectural/code patterns]
12
- key-files:
13
- created: [important files created]
14
- modified: [important files modified]
15
- key-decisions:
16
- - "Decision 1"
17
- duration: Xmin
18
- completed: YYYY-MM-DD
19
- ---
20
-
21
- # Phase [X]: [Name] Summary
22
-
23
- **[Substantive one-liner describing outcome]**
24
-
25
- ## Performance
26
- - **Duration:** [time]
27
- - **Tasks:** [count completed]
28
- - **Files modified:** [count]
29
-
30
- ## Accomplishments
31
- - [Key outcome 1]
32
- - [Key outcome 2]
33
-
34
- ## Task Commits
35
- 1. **Task 1: [task name]** - `hash`
36
- 2. **Task 2: [task name]** - `hash`
37
- 3. **Task 3: [task name]** - `hash`
38
-
39
- ## Files Created/Modified
40
- - `path/to/file.ts` - What it does
41
- - `path/to/another.ts` - What it does
42
-
43
- ## Decisions & Deviations
44
- [Key decisions or "None - followed plan as specified"]
45
- [Minor deviations if any, or "None"]
46
-
47
- ## Next Phase Readiness
48
- [What's ready for next phase]
1
+ ---
2
+ phase: XX-name
3
+ plan: YY
4
+ subsystem: [primary category]
5
+ tags: [searchable tech]
6
+ provides:
7
+ - [bullet list of what was built/delivered]
8
+ affects: [list of phase names or keywords]
9
+ tech-stack:
10
+ added: [libraries/tools]
11
+ patterns: [architectural/code patterns]
12
+ key-files:
13
+ created: [important files created]
14
+ modified: [important files modified]
15
+ key-decisions:
16
+ - "Decision 1"
17
+ duration: Xmin
18
+ completed: YYYY-MM-DD
19
+ ---
20
+
21
+ # Phase [X]: [Name] Summary
22
+
23
+ **[Substantive one-liner describing outcome]**
24
+
25
+ ## Performance
26
+ - **Duration:** [time]
27
+ - **Tasks:** [count completed]
28
+ - **Files modified:** [count]
29
+
30
+ ## Accomplishments
31
+ - [Key outcome 1]
32
+ - [Key outcome 2]
33
+
34
+ ## Task Commits
35
+ 1. **Task 1: [task name]** - `hash`
36
+ 2. **Task 2: [task name]** - `hash`
37
+ 3. **Task 3: [task name]** - `hash`
38
+
39
+ ## Files Created/Modified
40
+ - `path/to/file.ts` - What it does
41
+ - `path/to/another.ts` - What it does
42
+
43
+ ## Decisions & Deviations
44
+ [Key decisions or "None - followed plan as specified"]
45
+ [Minor deviations if any, or "None"]
46
+
47
+ ## Next Phase Readiness
48
+ [What's ready for next phase]