trinity-method-sdk 2.0.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 (191) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/LICENSE +21 -0
  3. package/README.md +555 -0
  4. package/dist/cli/commands/deploy/agents.d.ts +14 -0
  5. package/dist/cli/commands/deploy/agents.js +59 -0
  6. package/dist/cli/commands/deploy/ci-cd.d.ts +13 -0
  7. package/dist/cli/commands/deploy/ci-cd.js +50 -0
  8. package/dist/cli/commands/deploy/claude-setup.d.ts +17 -0
  9. package/dist/cli/commands/deploy/claude-setup.js +91 -0
  10. package/dist/cli/commands/deploy/configuration.d.ts +13 -0
  11. package/dist/cli/commands/deploy/configuration.js +215 -0
  12. package/dist/cli/commands/deploy/directories.d.ts +12 -0
  13. package/dist/cli/commands/deploy/directories.js +38 -0
  14. package/dist/cli/commands/deploy/gitignore.d.ts +12 -0
  15. package/dist/cli/commands/deploy/gitignore.js +53 -0
  16. package/dist/cli/commands/deploy/index.d.ts +38 -0
  17. package/dist/cli/commands/deploy/index.js +156 -0
  18. package/dist/cli/commands/deploy/knowledge-base.d.ts +16 -0
  19. package/dist/cli/commands/deploy/knowledge-base.js +75 -0
  20. package/dist/cli/commands/deploy/linting.d.ts +18 -0
  21. package/dist/cli/commands/deploy/linting.js +51 -0
  22. package/dist/cli/commands/deploy/metrics.d.ts +13 -0
  23. package/dist/cli/commands/deploy/metrics.js +34 -0
  24. package/dist/cli/commands/deploy/pre-flight.d.ts +13 -0
  25. package/dist/cli/commands/deploy/pre-flight.js +29 -0
  26. package/dist/cli/commands/deploy/root-files.d.ts +16 -0
  27. package/dist/cli/commands/deploy/root-files.js +178 -0
  28. package/dist/cli/commands/deploy/sdk-install.d.ts +12 -0
  29. package/dist/cli/commands/deploy/sdk-install.js +57 -0
  30. package/dist/cli/commands/deploy/summary.d.ts +14 -0
  31. package/dist/cli/commands/deploy/summary.js +130 -0
  32. package/dist/cli/commands/deploy/templates.d.ts +14 -0
  33. package/dist/cli/commands/deploy/templates.js +84 -0
  34. package/dist/cli/commands/deploy/types.d.ts +39 -0
  35. package/dist/cli/commands/deploy/types.js +5 -0
  36. package/dist/cli/commands/update/agents.d.ts +14 -0
  37. package/dist/cli/commands/update/agents.js +31 -0
  38. package/dist/cli/commands/update/backup.d.ts +31 -0
  39. package/dist/cli/commands/update/backup.js +97 -0
  40. package/dist/cli/commands/update/commands.d.ts +14 -0
  41. package/dist/cli/commands/update/commands.js +75 -0
  42. package/dist/cli/commands/update/index.d.ts +15 -0
  43. package/dist/cli/commands/update/index.js +118 -0
  44. package/dist/cli/commands/update/knowledge-base.d.ts +14 -0
  45. package/dist/cli/commands/update/knowledge-base.js +38 -0
  46. package/dist/cli/commands/update/pre-flight.d.ts +13 -0
  47. package/dist/cli/commands/update/pre-flight.js +37 -0
  48. package/dist/cli/commands/update/summary.d.ts +20 -0
  49. package/dist/cli/commands/update/summary.js +47 -0
  50. package/dist/cli/commands/update/templates.d.ts +14 -0
  51. package/dist/cli/commands/update/templates.js +25 -0
  52. package/dist/cli/commands/update/types.d.ts +13 -0
  53. package/dist/cli/commands/update/types.js +7 -0
  54. package/dist/cli/commands/update/utils.d.ts +11 -0
  55. package/dist/cli/commands/update/utils.js +19 -0
  56. package/dist/cli/commands/update/verification.d.ts +20 -0
  57. package/dist/cli/commands/update/verification.js +54 -0
  58. package/dist/cli/commands/update/version.d.ts +18 -0
  59. package/dist/cli/commands/update/version.js +36 -0
  60. package/dist/cli/commands/update.d.ts +7 -0
  61. package/dist/cli/commands/update.js +7 -0
  62. package/dist/cli/index.d.ts +3 -0
  63. package/dist/cli/index.js +36 -0
  64. package/dist/cli/types.d.ts +77 -0
  65. package/dist/cli/types.js +5 -0
  66. package/dist/cli/utils/deploy-ci.d.ts +22 -0
  67. package/dist/cli/utils/deploy-ci.js +138 -0
  68. package/dist/cli/utils/deploy-linting.d.ts +3 -0
  69. package/dist/cli/utils/deploy-linting.js +136 -0
  70. package/dist/cli/utils/detect-stack.d.ts +3 -0
  71. package/dist/cli/utils/detect-stack.js +270 -0
  72. package/dist/cli/utils/error-classes.d.ts +63 -0
  73. package/dist/cli/utils/error-classes.js +84 -0
  74. package/dist/cli/utils/error-handler.d.ts +59 -0
  75. package/dist/cli/utils/error-handler.js +127 -0
  76. package/dist/cli/utils/errors.d.ts +52 -0
  77. package/dist/cli/utils/errors.js +102 -0
  78. package/dist/cli/utils/get-sdk-path.d.ts +18 -0
  79. package/dist/cli/utils/get-sdk-path.js +31 -0
  80. package/dist/cli/utils/inject-dependencies.d.ts +2 -0
  81. package/dist/cli/utils/inject-dependencies.js +55 -0
  82. package/dist/cli/utils/linting-tools.d.ts +8 -0
  83. package/dist/cli/utils/linting-tools.js +206 -0
  84. package/dist/cli/utils/metrics/code-quality.d.ts +32 -0
  85. package/dist/cli/utils/metrics/code-quality.js +122 -0
  86. package/dist/cli/utils/metrics/dependency-parser.d.ts +21 -0
  87. package/dist/cli/utils/metrics/dependency-parser.js +153 -0
  88. package/dist/cli/utils/metrics/file-complexity.d.ts +26 -0
  89. package/dist/cli/utils/metrics/file-complexity.js +77 -0
  90. package/dist/cli/utils/metrics/framework-detector.d.ts +17 -0
  91. package/dist/cli/utils/metrics/framework-detector.js +120 -0
  92. package/dist/cli/utils/metrics/git-metrics.d.ts +30 -0
  93. package/dist/cli/utils/metrics/git-metrics.js +83 -0
  94. package/dist/cli/utils/metrics/index.d.ts +28 -0
  95. package/dist/cli/utils/metrics/index.js +100 -0
  96. package/dist/cli/utils/template-processor.d.ts +10 -0
  97. package/dist/cli/utils/template-processor.js +188 -0
  98. package/dist/cli/utils/validate-path.d.ts +80 -0
  99. package/dist/cli/utils/validate-path.js +180 -0
  100. package/dist/index.d.ts +6 -0
  101. package/dist/index.js +8 -0
  102. package/dist/templates/agents/aj-team/apo-documentation-specialist.md.template +572 -0
  103. package/dist/templates/agents/aj-team/bas-quality-gate.md.template +906 -0
  104. package/dist/templates/agents/aj-team/bon-dependency-manager.md.template +636 -0
  105. package/dist/templates/agents/aj-team/cap-configuration-specialist.md.template +670 -0
  106. package/dist/templates/agents/aj-team/dra-code-reviewer.md.template +768 -0
  107. package/dist/templates/agents/aj-team/kil-task-executor.md.template +764 -0
  108. package/dist/templates/agents/aj-team/uro-refactoring-specialist.md.template +759 -0
  109. package/dist/templates/agents/audit/juno-auditor.md.template +447 -0
  110. package/dist/templates/agents/deployment/ein-cicd.md.template +694 -0
  111. package/dist/templates/agents/deployment/ino-context.md.template +733 -0
  112. package/dist/templates/agents/deployment/tan-structure.md.template +661 -0
  113. package/dist/templates/agents/deployment/zen-knowledge.md.template +451 -0
  114. package/dist/templates/agents/leadership/aj-cc.md.template +462 -0
  115. package/dist/templates/agents/leadership/aj-maestro.md.template +943 -0
  116. package/dist/templates/agents/leadership/aly-cto.md.template +407 -0
  117. package/dist/templates/agents/planning/eus-decomposer.md.template +496 -0
  118. package/dist/templates/agents/planning/mon-requirements.md.template +323 -0
  119. package/dist/templates/agents/planning/ror-design.md.template +465 -0
  120. package/dist/templates/agents/planning/tra-planner.md.template +432 -0
  121. package/dist/templates/ci/cd.yml.template +175 -0
  122. package/dist/templates/ci/ci.yml.template +196 -0
  123. package/dist/templates/ci/generic-ci.yml +115 -0
  124. package/dist/templates/ci/github-actions.yml +86 -0
  125. package/dist/templates/ci/gitlab-ci.yml +103 -0
  126. package/dist/templates/claude/EMPLOYEE-DIRECTORY.md.template +545 -0
  127. package/dist/templates/documentation/ROOT-README.md.template +307 -0
  128. package/dist/templates/documentation/SUBDIRECTORY-README.md.template +261 -0
  129. package/dist/templates/investigations/bug.md.template +484 -0
  130. package/dist/templates/investigations/feature.md.template +564 -0
  131. package/dist/templates/investigations/performance.md.template +625 -0
  132. package/dist/templates/investigations/security.md.template +714 -0
  133. package/dist/templates/investigations/technical.md.template +433 -0
  134. package/dist/templates/knowledge-base/AI-DEVELOPMENT-GUIDE.md.template +957 -0
  135. package/dist/templates/knowledge-base/ARCHITECTURE.md.template +452 -0
  136. package/dist/templates/knowledge-base/CODING-PRINCIPLES.md.template +750 -0
  137. package/dist/templates/knowledge-base/DOCUMENTATION-CRITERIA.md.template +1118 -0
  138. package/dist/templates/knowledge-base/ISSUES.md.template +539 -0
  139. package/dist/templates/knowledge-base/TESTING-PRINCIPLES.md.template +894 -0
  140. package/dist/templates/knowledge-base/Technical-Debt.md.template +640 -0
  141. package/dist/templates/knowledge-base/To-do.md.template +407 -0
  142. package/dist/templates/knowledge-base/Trinity.md.template +464 -0
  143. package/dist/templates/linting/flutter/.pre-commit-config.yaml.template +27 -0
  144. package/dist/templates/linting/flutter/analysis_options.yaml.template +26 -0
  145. package/dist/templates/linting/nodejs/.eslintrc-commonjs.json.template +19 -0
  146. package/dist/templates/linting/nodejs/.eslintrc-esm.json.template +19 -0
  147. package/dist/templates/linting/nodejs/.eslintrc-typescript.json.template +22 -0
  148. package/dist/templates/linting/nodejs/.pre-commit-config.yaml.template +51 -0
  149. package/dist/templates/linting/nodejs/.prettierrc.json.template +10 -0
  150. package/dist/templates/linting/python/.flake8.template +16 -0
  151. package/dist/templates/linting/python/.pre-commit-config.yaml.template +30 -0
  152. package/dist/templates/linting/python/pyproject.toml.template +38 -0
  153. package/dist/templates/linting/rust/.pre-commit-config.yaml.template +28 -0
  154. package/dist/templates/linting/rust/clippy.toml.template +14 -0
  155. package/dist/templates/linting/rust/rustfmt.toml.template +12 -0
  156. package/dist/templates/root/CLAUDE.md.template +65 -0
  157. package/dist/templates/root/TRINITY.md.template +52 -0
  158. package/dist/templates/shared/claude-commands/trinity-agents.md.template +168 -0
  159. package/dist/templates/shared/claude-commands/trinity-audit.md.template +646 -0
  160. package/dist/templates/shared/claude-commands/trinity-changelog.md.template +624 -0
  161. package/dist/templates/shared/claude-commands/trinity-continue.md.template +549 -0
  162. package/dist/templates/shared/claude-commands/trinity-create-investigation.md.template +232 -0
  163. package/dist/templates/shared/claude-commands/trinity-decompose.md.template +181 -0
  164. package/dist/templates/shared/claude-commands/trinity-design.md.template +347 -0
  165. package/dist/templates/shared/claude-commands/trinity-docs.md.template +2093 -0
  166. package/dist/templates/shared/claude-commands/trinity-end.md.template +397 -0
  167. package/dist/templates/shared/claude-commands/trinity-init.md.template +606 -0
  168. package/dist/templates/shared/claude-commands/trinity-investigate-templates.md.template +725 -0
  169. package/dist/templates/shared/claude-commands/trinity-orchestrate.md.template +1061 -0
  170. package/dist/templates/shared/claude-commands/trinity-plan-investigation.md.template +135 -0
  171. package/dist/templates/shared/claude-commands/trinity-plan.md.template +201 -0
  172. package/dist/templates/shared/claude-commands/trinity-readme.md.template +1971 -0
  173. package/dist/templates/shared/claude-commands/trinity-requirements.md.template +148 -0
  174. package/dist/templates/shared/claude-commands/trinity-start.md.template +268 -0
  175. package/dist/templates/shared/claude-commands/trinity-verify.md.template +453 -0
  176. package/dist/templates/shared/claude-commands/trinity-workorder.md.template +249 -0
  177. package/dist/templates/source/base-CLAUDE.md.template +310 -0
  178. package/dist/templates/source/flutter-CLAUDE.md.template +593 -0
  179. package/dist/templates/source/nodejs-CLAUDE.md.template +531 -0
  180. package/dist/templates/source/python-CLAUDE.md.template +510 -0
  181. package/dist/templates/source/react-CLAUDE.md.template +513 -0
  182. package/dist/templates/source/rust-CLAUDE.md.template +653 -0
  183. package/dist/templates/source/tests-CLAUDE.md.template +432 -0
  184. package/dist/templates/trinity/CLAUDE.md.template +372 -0
  185. package/dist/templates/work-orders/ANALYSIS-TEMPLATE.md.template +276 -0
  186. package/dist/templates/work-orders/AUDIT-TEMPLATE.md.template +262 -0
  187. package/dist/templates/work-orders/IMPLEMENTATION-TEMPLATE.md.template +260 -0
  188. package/dist/templates/work-orders/INVESTIGATION-TEMPLATE.md.template +206 -0
  189. package/dist/templates/work-orders/PATTERN-TEMPLATE.md.template +320 -0
  190. package/dist/templates/work-orders/VERIFICATION-TEMPLATE.md.template +273 -0
  191. package/package.json +94 -0
@@ -0,0 +1,407 @@
1
+ # To-do List - {{PROJECT_NAME}}
2
+ **Trinity Method v2.0**
3
+ **Technology Stack**: {{TECHNOLOGY_STACK}}
4
+ **Framework**: {{PRIMARY_FRAMEWORK}}
5
+ **Last Updated**: {{CURRENT_DATE}}
6
+
7
+ ---
8
+
9
+ ## 🔴 CRITICAL (P0) - Immediate Action Required
10
+ *Security vulnerabilities, breaking bugs, data integrity issues*
11
+
12
+ - [ ] **{{CRITICAL_TASK_1}}**
13
+ - Component: {{COMPONENT}}
14
+ - Impact: {{IMPACT}}
15
+ - Estimated: {{TIME_ESTIMATE}}
16
+ - Assigned: {{ASSIGNEE}}
17
+
18
+ - [ ] **{{CRITICAL_TASK_2}}**
19
+ - Component: {{COMPONENT}}
20
+ - Impact: {{IMPACT}}
21
+ - Dependencies: {{DEPENDENCIES}}
22
+ - Estimated: {{TIME_ESTIMATE}}
23
+
24
+ ---
25
+
26
+ ## 🟡 HIGH PRIORITY (P1) - Core Functionality
27
+ *Features affecting primary user workflows*
28
+
29
+ ### Feature Development
30
+ - [ ] **{{FEATURE_1}}**
31
+ - Investigation Required: YES
32
+ - Pattern Check: trinity/patterns/
33
+ - Tests Required: Unit + Integration
34
+ - Documentation: Update ARCHITECTURE.md
35
+ - Estimated: {{TIME_ESTIMATE}}
36
+
37
+ ### Bug Fixes
38
+ - [ ] **{{BUG_1}}**
39
+ - Issue Reference: ISSUES.md#{{ISSUE_ID}}
40
+ - Root Cause: {{ROOT_CAUSE}}
41
+ - Solution Approach: {{APPROACH}}
42
+ - Estimated: {{TIME_ESTIMATE}}
43
+
44
+ ### Performance Improvements
45
+ - [ ] **{{PERFORMANCE_1}}**
46
+ - Current Metric: {{CURRENT}}ms
47
+ - Target Metric: {{TARGET}}ms
48
+ - Approach: {{OPTIMIZATION_APPROACH}}
49
+ - Estimated: {{TIME_ESTIMATE}}
50
+
51
+ ---
52
+
53
+ ## 🟢 MEDIUM PRIORITY (P2) - User Experience
54
+ *Enhancements and non-critical improvements*
55
+
56
+ ### UI/UX Improvements
57
+ - [ ] {{UX_IMPROVEMENT_1}}
58
+ - [ ] {{UX_IMPROVEMENT_2}}
59
+ - [ ] {{UX_IMPROVEMENT_3}}
60
+
61
+ ### Code Quality
62
+ - [ ] Refactor {{COMPONENT}} - See Technical-Debt.md#{{DEBT_ID}}
63
+ - [ ] Add tests for {{COMPONENT}} - Current coverage: {{COVERAGE}}%
64
+ - [ ] Update documentation for {{FEATURE}}
65
+
66
+ ### Technical Debt Reduction
67
+ - [ ] Address {{TODO_COUNT}} TODOs in {{COMPONENT}}
68
+ - [ ] Refactor large file: {{FILE_PATH}} ({{LINE_COUNT}} lines)
69
+ - [ ] Remove deprecated {{FRAMEWORK}} APIs
70
+
71
+ ---
72
+
73
+ ## 🔵 LOW PRIORITY (P3) - Nice to Have
74
+ *Future enhancements and optimizations*
75
+
76
+ ### Future Features
77
+ - [ ] {{FUTURE_FEATURE_1}}
78
+ - [ ] {{FUTURE_FEATURE_2}}
79
+
80
+ ### Documentation
81
+ - [ ] Create developer guide for {{TOPIC}}
82
+ - [ ] Update API documentation
83
+ - [ ] Add code examples for {{PATTERN}}
84
+
85
+ ### Tooling & Automation
86
+ - [ ] Automate {{PROCESS}}
87
+ - [ ] Improve build time
88
+ - [ ] Add monitoring for {{METRIC}}
89
+
90
+ ---
91
+
92
+ ## 📋 INVESTIGATION QUEUE
93
+ *Items requiring investigation before implementation*
94
+
95
+ ### Pending Investigations
96
+ - [ ] **Investigate {{TOPIC_1}}**
97
+ - Question: {{QUESTION}}
98
+ - Success Criteria: {{CRITERIA}}
99
+ - Time Box: 30 minutes
100
+
101
+ - [ ] **Research {{TECHNOLOGY}}**
102
+ - Purpose: {{PURPOSE}}
103
+ - Alternatives: {{ALTERNATIVES}}
104
+ - Decision Criteria: {{CRITERIA}}
105
+
106
+ ---
107
+
108
+ ## 🔄 RECURRING TASKS
109
+ *Regular maintenance and monitoring*
110
+
111
+ ### Daily
112
+ - [ ] Check performance metrics against baselines
113
+ - [ ] Review error logs for new issues
114
+ - [ ] Update To-do.md with discovered tasks
115
+
116
+ ### Weekly
117
+ - [ ] Run security scan
118
+ - [ ] Update Technical-Debt.md metrics
119
+ - [ ] Review and prioritize backlog
120
+ - [ ] Archive completed session work
121
+
122
+ ### Monthly
123
+ - [ ] Full codebase audit
124
+ - [ ] Dependency updates
125
+ - [ ] Pattern library review
126
+ - [ ] Trinity Method effectiveness review
127
+
128
+ ---
129
+
130
+ ## 🎯 SPRINT PLANNING
131
+ *Current sprint goals and commitments*
132
+
133
+ ### Sprint {{SPRINT_NUMBER}} ({{SPRINT_DATES}})
134
+
135
+ #### Sprint Goals
136
+ 1. {{GOAL_1}}
137
+ 2. {{GOAL_2}}
138
+ 3. {{GOAL_3}}
139
+
140
+ #### Committed Items
141
+ - [ ] P0: {{COMMITTED_P0_COUNT}} items
142
+ - [ ] P1: {{COMMITTED_P1_COUNT}} items
143
+ - [ ] P2: {{COMMITTED_P2_COUNT}} items
144
+
145
+ #### Success Metrics
146
+ - Test Coverage: Increase to {{TARGET}}%
147
+ - Performance: All operations <{{TARGET}}ms
148
+ - Bugs Fixed: {{COUNT}}
149
+ - Features Delivered: {{COUNT}}
150
+
151
+ ---
152
+
153
+ ## 📊 BACKLOG METRICS
154
+
155
+ ### Task Distribution
156
+ ```yaml
157
+ By_Scope:
158
+ Critical_P0: {{COUNT}}
159
+ High_P1: {{COUNT}}
160
+ Medium_P2: {{COUNT}}
161
+ Low_P3: {{COUNT}}
162
+ Total: {{TOTAL}}
163
+
164
+ By_Type:
165
+ Features: {{COUNT}}
166
+ Bugs: {{COUNT}}
167
+ Tech_Debt: {{COUNT}}
168
+ Documentation: {{COUNT}}
169
+ Investigation: {{COUNT}}
170
+
171
+ By_Component:
172
+ {{COMPONENT_1}}: {{COUNT}}
173
+ {{COMPONENT_2}}: {{COUNT}}
174
+ {{COMPONENT_3}}: {{COUNT}}
175
+ ```
176
+
177
+ ### Velocity Tracking
178
+ ```yaml
179
+ Last_3_Sessions:
180
+ Session_1: {{COMPLETED}} items
181
+ Session_2: {{COMPLETED}} items
182
+ Session_3: {{COMPLETED}} items
183
+ Average: {{AVG}} items/session
184
+
185
+ Estimates:
186
+ Backlog_Size: {{TOTAL}} items
187
+ Current_Velocity: {{VELOCITY}} items/session
188
+ Sessions_To_Clear: {{SESSIONS}}
189
+ ```
190
+
191
+ ---
192
+
193
+ ## 🏷️ LABELS & CATEGORIES
194
+
195
+ ### Task Labels
196
+ - `investigation-required` - Needs investigation first
197
+ - `pattern-exists` - Check pattern library
198
+ - `breaking-change` - Requires migration plan
199
+ - `performance-impact` - Affects performance metrics
200
+ - `security-related` - Security implications
201
+ - `{{FRAMEWORK}}-specific` - Framework-specific task
202
+
203
+ ### Component Tags
204
+ - `#{{COMPONENT_1}}`
205
+ - `#{{COMPONENT_2}}`
206
+ - `#{{COMPONENT_3}}`
207
+ - `#infrastructure`
208
+ - `#testing`
209
+ - `#documentation`
210
+
211
+ ---
212
+
213
+ ## 📝 TASK TEMPLATE
214
+
215
+ ```markdown
216
+ - [ ] **Task Title**
217
+ - Type: Feature/Bug/Debt/Documentation
218
+ - Component: {{COMPONENT}}
219
+ - Scope: P0/P1/P2/P3
220
+ - Investigation: Required/Completed/Not Needed
221
+ - Pattern: Check/Exists/Create
222
+ - Tests: Unit/Integration/E2E/None
223
+ - Documentation: ARCHITECTURE/Trinity/ISSUES/README
224
+ - Dependencies: {{LIST}}
225
+ - Estimated: {{TIME}}
226
+ - Assigned: {{PERSON}}
227
+ - Session: {{SESSION_ID}}
228
+ ```
229
+
230
+ ---
231
+
232
+ ## 🔗 QUICK LINKS
233
+
234
+ ### Technical Debt
235
+ - Full Report: Technical-Debt.md
236
+ - Quick Wins: Technical-Debt.md#quick-wins
237
+
238
+ ### Issues Database
239
+ - Active Issues: ISSUES.md#active-issues
240
+
241
+ ---
242
+
243
+ ## ✅ COMPLETION CRITERIA
244
+
245
+ ### Task Completion Checklist
246
+ - [ ] Investigation completed (if required)
247
+ - [ ] Pattern checked/created
248
+ - [ ] Implementation complete
249
+ - [ ] Tests written and passing
250
+ - [ ] Performance validated
251
+ - [ ] Documentation updated
252
+ - [ ] Code reviewed
253
+ - [ ] Issue closed (if applicable)
254
+
255
+ ### Session Completion
256
+ - [ ] To-do.md updated
257
+ - [ ] Technical-Debt.md updated
258
+ - [ ] ISSUES.md updated
259
+ - [ ] Investigations archived
260
+ - [ ] Patterns documented
261
+ - [ ] Session summary created
262
+
263
+ ---
264
+
265
+ ## 📝 WHEN TO UPDATE THIS DOCUMENT
266
+
267
+ This is a **living task management system** updated continuously as work progresses.
268
+
269
+ ### Immediate Updates Required ⚠️
270
+
271
+ Update **as tasks change** (real-time):
272
+
273
+ - ✅ **Task Completed**: Mark complete or remove from list immediately
274
+ - ✅ **New Task Identified**: Add to appropriate priority section (P0/P1/P2/P3)
275
+ - ✅ **Priority Change**: Move tasks between priority levels as urgency changes
276
+ - ✅ **Task Blocked**: Update status, add blocker details
277
+ - ✅ **Subtasks Discovered**: Add subtask checklist to existing task
278
+
279
+ ### Session Updates (Via `/trinity-end`) 🔄
280
+
281
+ Update at end of each development session:
282
+
283
+ - Remove/mark completed tasks from session
284
+ - Add new tasks discovered during development
285
+ - Re-prioritize based on new information
286
+ - Update sprint planning (velocity, burndown)
287
+ - Calculate session productivity metrics
288
+ - Update backlog with new items
289
+
290
+ ### Weekly Reviews ⏰
291
+
292
+ Sprint planning and prioritization:
293
+
294
+ - Review P0/P1 items (ensure highest priority work identified)
295
+ - Update sprint status (tasks completed vs planned)
296
+ - Calculate velocity (tasks per week)
297
+ - Reprioritize backlog
298
+ - Archive completed tasks if desired
299
+
300
+ ### Cross-Document Update Triggers 🔗
301
+
302
+ **When updating To-do.md, also check:**
303
+
304
+ - **[ISSUES.md](./ISSUES.md)**: Close issues when related tasks complete
305
+ - **[Technical-Debt.md](./Technical-Debt.md)**: Update when debt-related tasks complete
306
+ - **[ARCHITECTURE.md](./ARCHITECTURE.md)**: Verify architecture changes documented when component tasks complete
307
+
308
+ ### Update Scenarios - What to Change
309
+
310
+ **Scenario: Bug Fixed**
311
+ ```yaml
312
+ Updates_Required:
313
+ - Active_Tasks: Remove or mark complete the fix task
314
+ - Sprint_Status: Update completed task count
315
+ - Velocity_Tracking: Add to completed tasks this week
316
+ - Cross_References:
317
+ - ISSUES.md: Close the related issue
318
+ - Technical-Debt.md: Update if fix paid down debt
319
+ ```
320
+
321
+ **Scenario: New Feature Request**
322
+ ```yaml
323
+ Updates_Required:
324
+ - Backlog: Add new task with description
325
+ - Priority_Assignment: Assign P0/P1/P2/P3 based on urgency
326
+ - Estimate: Add time/complexity estimate
327
+ - Dependencies: Link to related tasks if applicable
328
+ ```
329
+
330
+ **Scenario: Task Blocked**
331
+ ```yaml
332
+ Updates_Required:
333
+ - Task_Status: Update with blocker details
334
+ - Priority: May need to reprioritize
335
+ - New_Tasks: May need to create unblocking tasks
336
+ - Cross_References:
337
+ - ISSUES.md: Create issue for blocker if recurring
338
+ ```
339
+
340
+ **Scenario: Sprint Completed**
341
+ ```yaml
342
+ Updates_Required:
343
+ - Archive_Completed: Move completed tasks to archive or remove
344
+ - Sprint_Metrics: Calculate velocity, completion rate
345
+ - Next_Sprint: Move high-priority backlog items to active
346
+ - Velocity_Adjustment: Update estimates based on actual velocity
347
+ ```
348
+
349
+ ### How to Update
350
+
351
+ **Step-by-step process:**
352
+
353
+ 1. **Identify Change**: Task complete, new task, priority change, or blocked?
354
+ 2. **Update Section**: Modify appropriate priority section or backlog
355
+ 3. **Cross-Reference**: Check if ISSUES/Technical-Debt need updates
356
+ 4. **Recalculate Metrics**: Update velocity, sprint status if needed
357
+ 5. **Update Timestamp**: Set `Last Updated: {{CURRENT_DATE}}`
358
+
359
+ **Quality Checklist:**
360
+ - [ ] All tasks have clear descriptions (what needs to be done)
361
+ - [ ] Priorities accurate (P0 = urgent, P3 = low priority)
362
+ - [ ] Estimates reasonable (based on team velocity)
363
+ - [ ] Blocked tasks have blocker details
364
+ - [ ] Completed tasks removed or marked complete
365
+ - [ ] Related issues/debt items cross-referenced
366
+
367
+ ### When NOT to Update ❌
368
+
369
+ **Don't add to To-do.md if:**
370
+ - Already documented in ISSUES.md as a bug (use issue tracking instead)
371
+ - Not actionable (vague idea without clear next steps)
372
+ - Belongs in Technical-Debt.md (debt tracking, not task)
373
+ - Long-term strategic item (add to ARCHITECTURE evolution planning)
374
+
375
+ ### Task vs. Issue vs. Debt 🤔
376
+
377
+ **Add to To-do.md when:**
378
+ - Specific action item to complete
379
+ - Feature to implement
380
+ - Bug to fix (with clear reproduction)
381
+ - Refactoring work planned
382
+ - Investigation to conduct
383
+
384
+ **Add to ISSUES.md when:**
385
+ - Bug that can recur
386
+ - Pattern to track
387
+ - Framework-specific problem
388
+
389
+ **Add to Technical-Debt.md when:**
390
+ - Code quality metric (TODO count, complexity)
391
+ - Accumulated shortcut
392
+ - Technical burden to track
393
+
394
+ **Tasks often resolve issues and debt** (todo → fix → issue closed, debt reduced).
395
+
396
+ ---
397
+
398
+ **Document Status**: Living Task Management System
399
+ **Update Frequency**: Real-time (as tasks change) + session-based
400
+ **Maintained By**: Development team using Trinity Method
401
+ **Referenced By**: `/trinity-end` command for session updates
402
+ **Last Updated**: {{CURRENT_DATE}}
403
+
404
+ ---
405
+
406
+ *Task management powered by Trinity Method v2.0*
407
+ *Investigation-first development approach*