@polymorphism-tech/morph-spec 4.10.8 → 4.10.10

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