@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

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 (149) hide show
  1. package/CLAUDE.md +3 -0
  2. package/LICENSE +71 -71
  3. package/README.md +379 -379
  4. package/bin/morph-spec.js +89 -0
  5. package/bin/task-manager.js +59 -6
  6. package/claude-plugin.json +14 -14
  7. package/docs/CHEATSHEET.md +1 -1
  8. package/docs/QUICKSTART.md +206 -206
  9. package/framework/agents/README.md +14 -14
  10. package/framework/agents/architecture/standards-architect.md +159 -159
  11. package/framework/agents/frontend/blazor-builder.md +13 -0
  12. package/framework/agents/frontend/css-specialist.md +87 -0
  13. package/framework/agents/frontend/nextjs-expert.md +13 -0
  14. package/framework/agents/frontend/nextjs-ui-specialist.md +218 -0
  15. package/framework/agents/frontend/ui-ux-designer.md +80 -10
  16. package/framework/agents/infrastructure/azure-architect.md +149 -149
  17. package/framework/agents/infrastructure/infra-architect.md +48 -48
  18. package/framework/agents.json +2268 -2567
  19. package/framework/hooks/README.md +204 -204
  20. package/framework/hooks/claude-code/post-tool-use/dispatch.js +10 -5
  21. package/framework/hooks/claude-code/session-start/inject-morph-context.js +10 -24
  22. package/framework/hooks/shared/phase-utils.js +139 -139
  23. package/framework/hooks/shared/worktree-helpers.js +30 -8
  24. package/framework/rules/csharp-standards.md +13 -13
  25. package/framework/rules/frontend-standards.md +13 -13
  26. package/framework/rules/infrastructure-standards.md +16 -16
  27. package/framework/rules/testing-standards.md +14 -14
  28. package/framework/skills/README.md +0 -1
  29. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +12 -0
  30. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  31. package/framework/skills/level-0-meta/morph-init/SKILL.md +88 -3
  32. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +247 -247
  33. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +270 -270
  34. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +515 -499
  35. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +508 -471
  36. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +12 -1
  37. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +272 -258
  38. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +317 -311
  39. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +424 -323
  40. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  41. package/framework/standards/STANDARDS.json +2040 -2040
  42. package/framework/standards/frontend/nextjs/motion-patterns.md +321 -0
  43. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  44. package/framework/templates/README.md +814 -814
  45. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  46. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  47. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  48. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  49. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  50. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  51. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  52. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  53. package/framework/templates/code/dotnet/test.cs +239 -239
  54. package/framework/templates/code/sql/rls-policy.sql +57 -57
  55. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  56. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  57. package/framework/templates/code/typescript/contracts.ts +168 -168
  58. package/framework/templates/context/CONTEXT.md +181 -181
  59. package/framework/templates/context/design-system.md +211 -0
  60. package/framework/templates/docs/proposal.md +182 -182
  61. package/framework/templates/docs/user-stories.md +34 -34
  62. package/framework/templates/examples/design-system-examples.md +357 -357
  63. package/framework/templates/examples/spec-examples.md +90 -90
  64. package/framework/templates/feature/decisions.md +187 -187
  65. package/framework/templates/feature/recap.md +146 -146
  66. package/framework/templates/feature/tasks.md +199 -199
  67. package/framework/templates/infrastructure/azure/README.md +286 -286
  68. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  69. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  70. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  71. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  72. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  73. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  74. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  75. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  76. package/package.json +82 -82
  77. package/src/commands/agents/agent-metrics.js +174 -0
  78. package/src/commands/agents/audit-dispatch.js +82 -0
  79. package/src/commands/agents/detect-agents.js +275 -0
  80. package/src/commands/agents/dispatch-agents.js +41 -135
  81. package/src/commands/agents/index.js +13 -4
  82. package/src/commands/agents/manage-agents.js +352 -0
  83. package/src/commands/project/doctor.js +59 -0
  84. package/src/commands/project/install-plugin-cmd.js +28 -28
  85. package/src/commands/project/setup-infra-cmd.js +12 -12
  86. package/src/commands/project/update.js +1 -17
  87. package/src/commands/project/worktree.js +58 -2
  88. package/src/commands/state/advance-phase.js +11 -3
  89. package/src/commands/tasks/index.js +4 -4
  90. package/src/commands/templates/index.js +5 -5
  91. package/src/commands/utils/index.js +3 -3
  92. package/src/commands/validation/index.js +4 -4
  93. package/src/core/state/phase-state-machine.js +217 -217
  94. package/src/core/state/state-manager.js +81 -0
  95. package/src/lib/agents/agents-manager.js +349 -0
  96. package/src/lib/agents/metrics-calculator.js +125 -0
  97. package/src/lib/agents/output-collector.js +75 -0
  98. package/src/lib/generators/context-generator.js +8 -7
  99. package/src/lib/generators/design-system-generator.js +298 -298
  100. package/src/lib/generators/index.js +10 -10
  101. package/src/lib/generators/metadata-extractor.js +387 -387
  102. package/src/lib/stack-filter.js +65 -65
  103. package/src/lib/standards/index.js +7 -7
  104. package/src/lib/standards/standards-context-injector.js +302 -302
  105. package/src/lib/tasks/task-parser.js +94 -3
  106. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  107. package/src/lib/validators/architecture/index.js +7 -7
  108. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  109. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  110. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  111. package/src/lib/validators/blazor/index.js +9 -9
  112. package/src/lib/validators/checkpoint-persistence.js +39 -0
  113. package/src/lib/validators/content/content-validator.js +287 -279
  114. package/src/lib/validators/content/index.js +7 -7
  115. package/src/lib/validators/contracts/index.js +7 -7
  116. package/src/lib/validators/css/css-validator.js +352 -352
  117. package/src/lib/validators/css/index.js +7 -7
  118. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  119. package/src/lib/validators/design-system/index.js +7 -7
  120. package/src/lib/validators/nextjs/index.js +6 -6
  121. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  122. package/src/lib/validators/packages/index.js +7 -7
  123. package/src/lib/validators/packages/package-validator.js +360 -360
  124. package/src/lib/validators/shared/index.js +12 -12
  125. package/src/lib/validators/shared/issue-counter.js +18 -18
  126. package/src/lib/validators/shared/result-formatter.js +124 -124
  127. package/src/lib/validators/spec-validator.js +2 -2
  128. package/src/lib/validators/ui/index.js +7 -7
  129. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  130. package/src/lib/validators/validation-runner.js +20 -0
  131. package/src/scripts/global-install.js +58 -58
  132. package/src/scripts/install-plugin.js +126 -126
  133. package/src/scripts/setup-infra.js +1 -17
  134. package/src/utils/agent-id-mapper.js +11 -0
  135. package/src/utils/agents-installer.js +40 -8
  136. package/src/utils/claude-md-injector.js +90 -90
  137. package/src/utils/claude-settings-manager.js +1 -1
  138. package/src/utils/file-copier.js +200 -196
  139. package/src/utils/hooks-installer.js +556 -739
  140. package/src/utils/logger.js +32 -32
  141. package/src/utils/skills-installer.js +178 -178
  142. package/src/utils/tier-helpers.js +24 -0
  143. package/src/utils/version-checker.js +175 -175
  144. package/framework/agents/architecture/po-pm-advisor.md +0 -203
  145. package/framework/hooks/claude-code/user-prompt/set-terminal-title.js +0 -68
  146. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +0 -38
  147. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +0 -14
  148. package/framework/templates/.idea/morph-templates.xml +0 -92
  149. package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
@@ -1,146 +1,146 @@
1
- # Feature Recap: {{titleCase FEATURE_NAME}}
2
-
3
- ## Summary
4
-
5
- | Field | Value |
6
- |-------|-------|
7
- | **Feature ID** | {{FEATURE_NAME}} |
8
- | **Completed** | {{DATE}} |
9
- | **Total Tasks** | {X} |
10
- | **Time Spent** | {X}h |
11
- | **Agents Used** | {list} |
12
- {{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
13
-
14
- ---
15
-
16
- ## Tasks Completed
17
-
18
- | ID | Title | Category | Duration |
19
- |----|-------|----------|----------|
20
- | T001 | {title} | {{#if (eq STACK "nextjs-supabase")}}Database{{else}}{category}{{/if}} | {X}min |
21
- | T002 | {title} | {{#if (eq STACK "nextjs-supabase")}}Backend{{else}}{category}{{/if}} | {X}min |
22
- | T003 | {title} | {{#if (eq STACK "nextjs-supabase")}}Frontend{{else}}{category}{{/if}} | {X}min |
23
-
24
- ---
25
-
26
- {{#if (eq STACK "nextjs-supabase")}}
27
- ## Validation Results
28
-
29
- | Validator | Status | Details |
30
- |-----------|--------|---------|
31
- | contract-compliance | Pass/Fail | {details} |
32
- | architecture | Pass/Fail | {details} |
33
- | design-system | Pass/Fail | {details} |
34
- | coding-standards | Pass/Fail | {details} |
35
-
36
- ---
37
-
38
- {{/if}}
39
- ## What Was Delivered
40
-
41
- ### Functionality
42
- - {Functionality 1 delivered}
43
- - {Functionality 2 delivered}
44
- - {Functionality 3 delivered}
45
-
46
- {{#if (eq STACK "nextjs-supabase")}}
47
- ### Database (Supabase)
48
- - Tables: {list}
49
- - RLS Policies: {count} policies
50
- - Migrations: {count} files
51
-
52
- ### Backend API (.NET)
53
- - Endpoints: {count} endpoints
54
- - Services: {list}
55
-
56
- ### Frontend (Next.js)
57
- - Pages: {list}
58
- - Components: {list}
59
- {{/if}}
60
-
61
- ---
62
-
63
- ## Files Created
64
-
65
- ```
66
- {{#if (eq STACK "nextjs-supabase")}}
67
- supabase/migrations/{files}
68
- backend/src/{files}
69
- frontend/src/{files}
70
- {{else}}
71
- {list of created files}
72
- {{/if}}
73
- ```
74
-
75
- ## Files Modified
76
-
77
- ```
78
- {list of modified files}
79
- ```
80
-
81
- ---
82
-
83
- ## Architecture Decisions
84
-
85
- | Decision | Rationale |
86
- |----------|-----------|
87
- | {Decision 1} | {Reason} |
88
- | {Decision 2} | {Reason} |
89
-
90
- See full ADRs in `decisions.md`
91
-
92
- ---
93
-
94
- ## Test Coverage
95
-
96
- | Type | Files | Coverage |
97
- |------|-------|----------|
98
- | {{#if (eq STACK "nextjs-supabase")}}Backend Unit{{else}}Unit Tests{{/if}} | {X} | {X}% |
99
- | {{#if (eq STACK "nextjs-supabase")}}Frontend Component{{else}}Integration Tests{{/if}} | {X} | {X}% |
100
-
101
- ---
102
-
103
- ## Lessons Learned
104
-
105
- ### What Went Well
106
- - {Positive point 1}
107
- - {Positive point 2}
108
-
109
- ### What Could Be Improved
110
- - {Improvement point 1}
111
- - {Improvement point 2}
112
-
113
- ### Recommendations for Future
114
- - {Recommendation 1}
115
- - {Recommendation 2}
116
-
117
- ---
118
-
119
- ## Metrics
120
-
121
- | Metric | Value |
122
- |--------|-------|
123
- | Tasks Completed | {X}/{X} |
124
- | Checkpoints Passed | {X} |
125
- {{#if (eq STACK "nextjs-supabase")}}| Validation Passes | {X}/{X} |
126
- {{else}}| Code Reviews | {X} |
127
- {{/if}}| Bugs Found | {X} |
128
- | Bugs Fixed | {X} |
129
-
130
- ---
131
-
132
- ## Related Resources
133
-
134
- - **Proposal:** `proposal.md`
135
- - **Spec:** `spec.md`
136
- {{#if (eq STACK "nextjs-supabase")}}- **Contracts (.NET):** `contracts.cs`
137
- - **Contracts (TS):** `contracts.ts`
138
- {{else}}- **Contracts:** `contracts.cs`
139
- {{/if}}- **Tasks:** `tasks.md`
140
- - **Decisions:** `decisions.md`
141
- {{#if (eq STACK "blazor-azure")}}- **Azure DevOps Epic:** {link}
142
- {{/if}}- **PR:** {link}
143
-
144
- ---
145
-
146
- *Generated by MORPH Framework on {{DATE}}*
1
+ # Feature Recap: {{titleCase FEATURE_NAME}}
2
+
3
+ ## Summary
4
+
5
+ | Field | Value |
6
+ |-------|-------|
7
+ | **Feature ID** | {{FEATURE_NAME}} |
8
+ | **Completed** | {{DATE}} |
9
+ | **Total Tasks** | {X} |
10
+ | **Time Spent** | {X}h |
11
+ | **Agents Used** | {list} |
12
+ {{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
13
+
14
+ ---
15
+
16
+ ## Tasks Completed
17
+
18
+ | ID | Title | Category | Duration |
19
+ |----|-------|----------|----------|
20
+ | T001 | {title} | {{#if (eq STACK "nextjs-supabase")}}Database{{else}}{category}{{/if}} | {X}min |
21
+ | T002 | {title} | {{#if (eq STACK "nextjs-supabase")}}Backend{{else}}{category}{{/if}} | {X}min |
22
+ | T003 | {title} | {{#if (eq STACK "nextjs-supabase")}}Frontend{{else}}{category}{{/if}} | {X}min |
23
+
24
+ ---
25
+
26
+ {{#if (eq STACK "nextjs-supabase")}}
27
+ ## Validation Results
28
+
29
+ | Validator | Status | Details |
30
+ |-----------|--------|---------|
31
+ | contract-compliance | Pass/Fail | {details} |
32
+ | architecture | Pass/Fail | {details} |
33
+ | design-system | Pass/Fail | {details} |
34
+ | coding-standards | Pass/Fail | {details} |
35
+
36
+ ---
37
+
38
+ {{/if}}
39
+ ## What Was Delivered
40
+
41
+ ### Functionality
42
+ - {Functionality 1 delivered}
43
+ - {Functionality 2 delivered}
44
+ - {Functionality 3 delivered}
45
+
46
+ {{#if (eq STACK "nextjs-supabase")}}
47
+ ### Database (Supabase)
48
+ - Tables: {list}
49
+ - RLS Policies: {count} policies
50
+ - Migrations: {count} files
51
+
52
+ ### Backend API (.NET)
53
+ - Endpoints: {count} endpoints
54
+ - Services: {list}
55
+
56
+ ### Frontend (Next.js)
57
+ - Pages: {list}
58
+ - Components: {list}
59
+ {{/if}}
60
+
61
+ ---
62
+
63
+ ## Files Created
64
+
65
+ ```
66
+ {{#if (eq STACK "nextjs-supabase")}}
67
+ supabase/migrations/{files}
68
+ backend/src/{files}
69
+ frontend/src/{files}
70
+ {{else}}
71
+ {list of created files}
72
+ {{/if}}
73
+ ```
74
+
75
+ ## Files Modified
76
+
77
+ ```
78
+ {list of modified files}
79
+ ```
80
+
81
+ ---
82
+
83
+ ## Architecture Decisions
84
+
85
+ | Decision | Rationale |
86
+ |----------|-----------|
87
+ | {Decision 1} | {Reason} |
88
+ | {Decision 2} | {Reason} |
89
+
90
+ See full ADRs in `decisions.md`
91
+
92
+ ---
93
+
94
+ ## Test Coverage
95
+
96
+ | Type | Files | Coverage |
97
+ |------|-------|----------|
98
+ | {{#if (eq STACK "nextjs-supabase")}}Backend Unit{{else}}Unit Tests{{/if}} | {X} | {X}% |
99
+ | {{#if (eq STACK "nextjs-supabase")}}Frontend Component{{else}}Integration Tests{{/if}} | {X} | {X}% |
100
+
101
+ ---
102
+
103
+ ## Lessons Learned
104
+
105
+ ### What Went Well
106
+ - {Positive point 1}
107
+ - {Positive point 2}
108
+
109
+ ### What Could Be Improved
110
+ - {Improvement point 1}
111
+ - {Improvement point 2}
112
+
113
+ ### Recommendations for Future
114
+ - {Recommendation 1}
115
+ - {Recommendation 2}
116
+
117
+ ---
118
+
119
+ ## Metrics
120
+
121
+ | Metric | Value |
122
+ |--------|-------|
123
+ | Tasks Completed | {X}/{X} |
124
+ | Checkpoints Passed | {X} |
125
+ {{#if (eq STACK "nextjs-supabase")}}| Validation Passes | {X}/{X} |
126
+ {{else}}| Code Reviews | {X} |
127
+ {{/if}}| Bugs Found | {X} |
128
+ | Bugs Fixed | {X} |
129
+
130
+ ---
131
+
132
+ ## Related Resources
133
+
134
+ - **Proposal:** `proposal.md`
135
+ - **Spec:** `spec.md`
136
+ {{#if (eq STACK "nextjs-supabase")}}- **Contracts (.NET):** `contracts.cs`
137
+ - **Contracts (TS):** `contracts.ts`
138
+ {{else}}- **Contracts:** `contracts.cs`
139
+ {{/if}}- **Tasks:** `tasks.md`
140
+ - **Decisions:** `decisions.md`
141
+ {{#if (eq STACK "blazor-azure")}}- **Azure DevOps Epic:** {link}
142
+ {{/if}}- **PR:** {link}
143
+
144
+ ---
145
+
146
+ *Generated by MORPH Framework on {{DATE}}*
@@ -1,199 +1,199 @@
1
- # Tasks - {{titleCase FEATURE_NAME}}
2
-
3
- > Implementation checklist for the feature.
4
- > Update status as you progress.
5
-
6
- | Task ID | Type | Title | Status |
7
- |---------|------|-------|--------|
8
- | T001 | {type} | {title} | Pending |
9
- | T002 | {type} | {title} | Pending |
10
- | T003 | {type} | {title} | In Progress |
11
- | T004 | {type} | {title} | Blocked |
12
- | T005 | {type} | {title} | Done |
13
-
14
- **Status Values:** `Pending | In Progress | Blocked | Done`
15
-
16
- ---
17
-
18
- ## Task Granularity
19
-
20
- ### Ideal Task
21
- - 15-60 minutes of implementation
22
- - 1-5 files modified
23
- - Testable in isolation
24
- - Independent commit possible
25
-
26
- ### Signs of Too Broad (Split)
27
- **Bad example:** "Implement feature"
28
- **Split into:**
29
- - T001: Define contracts and interfaces
30
- - T002: Implement data layer
31
- - T003: Implement business logic
32
- - T004: Create UI components
33
- - T005: Write tests
34
-
35
- ### Signs of Too Granular (Merge)
36
- **Bad example:** "Create field A", "Create field B", "Create field C"
37
- **Merge into:** "Create data model with all fields"
38
-
39
- ---
40
-
41
- ## Gates & Reviews
42
-
43
- | Task ID | Type | Description | Status |
44
- |---------|------|-------------|--------|
45
- | T003 | Review | Review contracts and data model | Pending |
46
- | T006 | Review | Review implementation | Pending |
47
- | T009 | Approval | Approve UI before testing | Pending |
48
-
49
- ---
50
-
51
- ## Phase 1: Contracts & Data Model
52
-
53
- ### T001: Define contracts and interfaces
54
- - **Type:** Contract
55
- - **Priority:** 1
56
- - **Estimate:** 30min
57
- - **Assigned:** {agent}
58
- - **Dependencies:** None
59
-
60
- **Description:**
61
-
62
- Define service interfaces and contracts.
63
-
64
- **Deliverables:**
65
- - [ ] Create: `{path-to-interface-file}`
66
-
67
- ---
68
-
69
- ### T002: Create data model
70
- - **Type:** {{#if (eq STACK "nextjs-supabase")}}Database{{else}}Domain{{/if}}
71
- - **Priority:** 1
72
- - **Estimate:** 45min
73
- - **Assigned:** {agent}
74
- - **Dependencies:** None
75
-
76
- **Description:**
77
-
78
- Create data model {{#if (eq STACK "nextjs-supabase")}}with migrations{{else}}with entities{{/if}}.
79
-
80
- **Deliverables:**
81
- - [ ] Create: `{path-to-model-file}`
82
-
83
- ---
84
-
85
- ## Phase 2: Implementation
86
-
87
- ### T003: Implement data layer
88
- - **Type:** {{#if (eq STACK "nextjs-supabase")}}Repository{{else}}Infrastructure{{/if}}
89
- - **Priority:** 2
90
- - **Estimate:** 1h
91
- - **Assigned:** {agent}
92
- - **Dependencies:** T001, T002
93
-
94
- **Description:**
95
-
96
- Implement data access layer.
97
-
98
- **Deliverables:**
99
- - [ ] Create: `{path-to-repository-file}`
100
-
101
- ---
102
-
103
- ### T004: Implement business logic
104
- - **Type:** Service
105
- - **Priority:** 2
106
- - **Estimate:** 1h
107
- - **Assigned:** {agent}
108
- - **Dependencies:** T001, T003
109
-
110
- **Description:**
111
-
112
- Implement service layer with business logic.
113
-
114
- **Deliverables:**
115
- - [ ] Create: `{path-to-service-file}`
116
-
117
- ---
118
-
119
- ## Phase 3: UI Components
120
-
121
- ### T005: Create list component
122
- - **Type:** UI
123
- - **Priority:** 2
124
- - **Estimate:** 45min
125
- - **Assigned:** {agent}
126
- - **Dependencies:** T004
127
-
128
- **Description:**
129
-
130
- Create component to list items.
131
-
132
- **Deliverables:**
133
- - [ ] Create: `{path-to-component-file}`
134
-
135
- ---
136
-
137
- ### T006: Create form component
138
- - **Type:** UI
139
- - **Priority:** 2
140
- - **Estimate:** 1h
141
- - **Assigned:** {agent}
142
- - **Dependencies:** T005
143
-
144
- **Description:**
145
-
146
- Create component for create/edit.
147
-
148
- **Deliverables:**
149
- - [ ] Create: `{path-to-form-file}`
150
-
151
- ---
152
-
153
- ## Phase 4: Testing
154
-
155
- ### T007: Write unit tests
156
- - **Type:** Test
157
- - **Priority:** 2
158
- - **Estimate:** 1h
159
- - **Assigned:** {agent}
160
- - **Dependencies:** T004
161
-
162
- **Description:**
163
-
164
- Unit tests for service layer.
165
-
166
- **Deliverables:**
167
- - [ ] Create: `{path-to-test-file}`
168
-
169
- ---
170
-
171
- ### T008: Write integration tests
172
- - **Type:** Test
173
- - **Priority:** 3
174
- - **Estimate:** 1h
175
- - **Assigned:** {agent}
176
- - **Dependencies:** T007
177
-
178
- **Description:**
179
-
180
- Integration tests for {{#if (eq STACK "nextjs-supabase")}}API and database{{else}}repository and API{{/if}}.
181
-
182
- **Deliverables:**
183
- - [ ] Create: `{path-to-integration-test-file}`
184
-
185
- ---
186
-
187
- ## Summary
188
-
189
- | Phase | Tasks | Estimate |
190
- |-------|-------|----------|
191
- | Phase 1 | T001-T002 | {X}h |
192
- | Phase 2 | T003-T004 | {X}h |
193
- | Phase 3 | T005-T006 | {X}h |
194
- | Phase 4 | T007-T008 | {X}h |
195
- | **Total** | **8 tasks** | **{X}h** |
196
-
197
- ---
198
-
199
- *Generated by MORPH Framework*
1
+ # Tasks - {{titleCase FEATURE_NAME}}
2
+
3
+ > Implementation checklist for the feature.
4
+ > Update status as you progress.
5
+
6
+ | Task ID | Type | Title | Status |
7
+ |---------|------|-------|--------|
8
+ | T001 | {type} | {title} | Pending |
9
+ | T002 | {type} | {title} | Pending |
10
+ | T003 | {type} | {title} | In Progress |
11
+ | T004 | {type} | {title} | Blocked |
12
+ | T005 | {type} | {title} | Done |
13
+
14
+ **Status Values:** `Pending | In Progress | Blocked | Done`
15
+
16
+ ---
17
+
18
+ ## Task Granularity
19
+
20
+ ### Ideal Task
21
+ - 15-60 minutes of implementation
22
+ - 1-5 files modified
23
+ - Testable in isolation
24
+ - Independent commit possible
25
+
26
+ ### Signs of Too Broad (Split)
27
+ **Bad example:** "Implement feature"
28
+ **Split into:**
29
+ - T001: Define contracts and interfaces
30
+ - T002: Implement data layer
31
+ - T003: Implement business logic
32
+ - T004: Create UI components
33
+ - T005: Write tests
34
+
35
+ ### Signs of Too Granular (Merge)
36
+ **Bad example:** "Create field A", "Create field B", "Create field C"
37
+ **Merge into:** "Create data model with all fields"
38
+
39
+ ---
40
+
41
+ ## Gates & Reviews
42
+
43
+ | Task ID | Type | Description | Status |
44
+ |---------|------|-------------|--------|
45
+ | T003 | Review | Review contracts and data model | Pending |
46
+ | T006 | Review | Review implementation | Pending |
47
+ | T009 | Approval | Approve UI before testing | Pending |
48
+
49
+ ---
50
+
51
+ ## Phase 1: Contracts & Data Model
52
+
53
+ ### T001: Define contracts and interfaces
54
+ - **Type:** Contract
55
+ - **Priority:** 1
56
+ - **Estimate:** 30min
57
+ - **Assigned:** {agent}
58
+ - **Dependencies:** None
59
+
60
+ **Description:**
61
+
62
+ Define service interfaces and contracts.
63
+
64
+ **Deliverables:**
65
+ - [ ] Create: `{path-to-interface-file}`
66
+
67
+ ---
68
+
69
+ ### T002: Create data model
70
+ - **Type:** {{#if (eq STACK "nextjs-supabase")}}Database{{else}}Domain{{/if}}
71
+ - **Priority:** 1
72
+ - **Estimate:** 45min
73
+ - **Assigned:** {agent}
74
+ - **Dependencies:** None
75
+
76
+ **Description:**
77
+
78
+ Create data model {{#if (eq STACK "nextjs-supabase")}}with migrations{{else}}with entities{{/if}}.
79
+
80
+ **Deliverables:**
81
+ - [ ] Create: `{path-to-model-file}`
82
+
83
+ ---
84
+
85
+ ## Phase 2: Implementation
86
+
87
+ ### T003: Implement data layer
88
+ - **Type:** {{#if (eq STACK "nextjs-supabase")}}Repository{{else}}Infrastructure{{/if}}
89
+ - **Priority:** 2
90
+ - **Estimate:** 1h
91
+ - **Assigned:** {agent}
92
+ - **Dependencies:** T001, T002
93
+
94
+ **Description:**
95
+
96
+ Implement data access layer.
97
+
98
+ **Deliverables:**
99
+ - [ ] Create: `{path-to-repository-file}`
100
+
101
+ ---
102
+
103
+ ### T004: Implement business logic
104
+ - **Type:** Service
105
+ - **Priority:** 2
106
+ - **Estimate:** 1h
107
+ - **Assigned:** {agent}
108
+ - **Dependencies:** T001, T003
109
+
110
+ **Description:**
111
+
112
+ Implement service layer with business logic.
113
+
114
+ **Deliverables:**
115
+ - [ ] Create: `{path-to-service-file}`
116
+
117
+ ---
118
+
119
+ ## Phase 3: UI Components
120
+
121
+ ### T005: Create list component
122
+ - **Type:** UI
123
+ - **Priority:** 2
124
+ - **Estimate:** 45min
125
+ - **Assigned:** {agent}
126
+ - **Dependencies:** T004
127
+
128
+ **Description:**
129
+
130
+ Create component to list items.
131
+
132
+ **Deliverables:**
133
+ - [ ] Create: `{path-to-component-file}`
134
+
135
+ ---
136
+
137
+ ### T006: Create form component
138
+ - **Type:** UI
139
+ - **Priority:** 2
140
+ - **Estimate:** 1h
141
+ - **Assigned:** {agent}
142
+ - **Dependencies:** T005
143
+
144
+ **Description:**
145
+
146
+ Create component for create/edit.
147
+
148
+ **Deliverables:**
149
+ - [ ] Create: `{path-to-form-file}`
150
+
151
+ ---
152
+
153
+ ## Phase 4: Testing
154
+
155
+ ### T007: Write unit tests
156
+ - **Type:** Test
157
+ - **Priority:** 2
158
+ - **Estimate:** 1h
159
+ - **Assigned:** {agent}
160
+ - **Dependencies:** T004
161
+
162
+ **Description:**
163
+
164
+ Unit tests for service layer.
165
+
166
+ **Deliverables:**
167
+ - [ ] Create: `{path-to-test-file}`
168
+
169
+ ---
170
+
171
+ ### T008: Write integration tests
172
+ - **Type:** Test
173
+ - **Priority:** 3
174
+ - **Estimate:** 1h
175
+ - **Assigned:** {agent}
176
+ - **Dependencies:** T007
177
+
178
+ **Description:**
179
+
180
+ Integration tests for {{#if (eq STACK "nextjs-supabase")}}API and database{{else}}repository and API{{/if}}.
181
+
182
+ **Deliverables:**
183
+ - [ ] Create: `{path-to-integration-test-file}`
184
+
185
+ ---
186
+
187
+ ## Summary
188
+
189
+ | Phase | Tasks | Estimate |
190
+ |-------|-------|----------|
191
+ | Phase 1 | T001-T002 | {X}h |
192
+ | Phase 2 | T003-T004 | {X}h |
193
+ | Phase 3 | T005-T006 | {X}h |
194
+ | Phase 4 | T007-T008 | {X}h |
195
+ | **Total** | **8 tasks** | **{X}h** |
196
+
197
+ ---
198
+
199
+ *Generated by MORPH Framework*