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