@polymorphism-tech/morph-spec 4.10.7 → 4.10.9

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 (123) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +379 -379
  4. package/bin/morph-spec.js +1 -1
  5. package/claude-plugin.json +14 -14
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +206 -206
  8. package/framework/agents/README.md +14 -14
  9. package/framework/agents/architecture/standards-architect.md +159 -159
  10. package/framework/agents/frontend/blazor-builder.md +13 -0
  11. package/framework/agents/frontend/css-specialist.md +87 -0
  12. package/framework/agents/frontend/nextjs-expert.md +13 -0
  13. package/framework/agents/frontend/nextjs-ui-specialist.md +218 -0
  14. package/framework/agents/frontend/ui-ux-designer.md +80 -10
  15. package/framework/agents/infrastructure/azure-architect.md +149 -149
  16. package/framework/agents/infrastructure/infra-architect.md +48 -48
  17. package/framework/agents.json +2268 -2204
  18. package/framework/hooks/README.md +204 -204
  19. package/framework/hooks/claude-code/session-start/inject-morph-context.js +10 -24
  20. package/framework/hooks/shared/phase-utils.js +139 -139
  21. package/framework/hooks/shared/worktree-helpers.js +30 -8
  22. package/framework/rules/csharp-standards.md +13 -13
  23. package/framework/rules/frontend-standards.md +13 -13
  24. package/framework/rules/infrastructure-standards.md +16 -16
  25. package/framework/rules/testing-standards.md +14 -14
  26. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +12 -0
  27. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  28. package/framework/skills/level-0-meta/morph-init/SKILL.md +136 -3
  29. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +247 -247
  30. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +270 -270
  31. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +515 -499
  32. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +508 -500
  33. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +12 -1
  34. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +272 -262
  35. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +317 -311
  36. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +457 -323
  37. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  38. package/framework/standards/STANDARDS.json +2040 -2040
  39. package/framework/standards/frontend/nextjs/motion-patterns.md +321 -0
  40. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  41. package/framework/templates/README.md +814 -814
  42. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  43. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  44. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  45. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  46. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  47. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  48. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  49. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  50. package/framework/templates/code/dotnet/test.cs +239 -239
  51. package/framework/templates/code/sql/rls-policy.sql +57 -57
  52. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  53. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  54. package/framework/templates/code/typescript/contracts.ts +168 -168
  55. package/framework/templates/context/CONTEXT.md +181 -181
  56. package/framework/templates/context/design-system.md +211 -0
  57. package/framework/templates/docs/proposal.md +182 -182
  58. package/framework/templates/docs/user-stories.md +34 -34
  59. package/framework/templates/examples/design-system-examples.md +357 -357
  60. package/framework/templates/examples/spec-examples.md +90 -90
  61. package/framework/templates/feature/decisions.md +187 -187
  62. package/framework/templates/feature/recap.md +146 -146
  63. package/framework/templates/feature/tasks.md +199 -199
  64. package/framework/templates/infrastructure/azure/README.md +286 -286
  65. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  66. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  67. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  68. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  69. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  70. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  71. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  72. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  73. package/package.json +82 -82
  74. package/src/commands/agents/index.js +13 -13
  75. package/src/commands/project/install-plugin-cmd.js +28 -28
  76. package/src/commands/project/setup-infra-cmd.js +12 -12
  77. package/src/commands/project/worktree.js +58 -2
  78. package/src/commands/tasks/index.js +4 -4
  79. package/src/commands/templates/index.js +5 -5
  80. package/src/commands/utils/index.js +3 -3
  81. package/src/commands/validation/index.js +4 -4
  82. package/src/core/state/phase-state-machine.js +217 -217
  83. package/src/lib/detectors/design-system-detector.js +73 -31
  84. package/src/lib/generators/design-system-generator.js +298 -298
  85. package/src/lib/generators/index.js +10 -10
  86. package/src/lib/generators/metadata-extractor.js +387 -387
  87. package/src/lib/stack-filter.js +65 -65
  88. package/src/lib/standards/index.js +7 -7
  89. package/src/lib/standards/standards-context-injector.js +302 -302
  90. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  91. package/src/lib/validators/architecture/index.js +7 -7
  92. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  93. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  94. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  95. package/src/lib/validators/blazor/index.js +9 -9
  96. package/src/lib/validators/content/content-validator.js +287 -287
  97. package/src/lib/validators/content/index.js +7 -7
  98. package/src/lib/validators/contracts/index.js +7 -7
  99. package/src/lib/validators/css/css-validator.js +352 -352
  100. package/src/lib/validators/css/index.js +7 -7
  101. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  102. package/src/lib/validators/design-system/index.js +7 -7
  103. package/src/lib/validators/nextjs/index.js +6 -6
  104. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  105. package/src/lib/validators/packages/index.js +7 -7
  106. package/src/lib/validators/packages/package-validator.js +360 -360
  107. package/src/lib/validators/shared/index.js +12 -12
  108. package/src/lib/validators/shared/issue-counter.js +18 -18
  109. package/src/lib/validators/shared/result-formatter.js +124 -124
  110. package/src/lib/validators/ui/index.js +7 -7
  111. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  112. package/src/scripts/global-install.js +58 -58
  113. package/src/scripts/install-plugin.js +126 -126
  114. package/src/utils/claude-md-injector.js +90 -90
  115. package/src/utils/file-copier.js +200 -196
  116. package/src/utils/hooks-installer.js +556 -494
  117. package/src/utils/logger.js +32 -32
  118. package/src/utils/skills-installer.js +178 -178
  119. package/src/utils/version-checker.js +175 -175
  120. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +0 -38
  121. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +0 -14
  122. package/framework/templates/.idea/morph-templates.xml +0 -92
  123. 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*