@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,181 +1,181 @@
1
- # {{PROJECT_NAME}} - Project Context
2
-
3
- > Auto-generated by MORPH-SPEC Framework
4
- > Last updated: {{TIMESTAMP}}
5
-
6
- ## Project Overview
7
-
8
- **Name:** {{PROJECT_NAME}}
9
- **Type:** {{PROJECT_TYPE}}
10
- **Repository:** {{REPOSITORY_URL}}
11
-
12
- {{PROJECT_DESCRIPTION}}
13
-
14
- ---
15
-
16
- ## Technology Stack
17
-
18
- ### Frontend
19
- {{#if BLAZOR_ENABLED}}- **Blazor Server** {{BLAZOR_VERSION}}{{/if}}
20
- {{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
21
- {{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
22
-
23
- ### Backend
24
- - **.NET** {{DOTNET_VERSION}}
25
- {{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
26
- {{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
27
- {{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
28
- {{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
29
-
30
- ### Database
31
- {{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
32
- {{#if SUPABASE_ENABLED}}- **Supabase** (PostgreSQL + Auth + Storage + RLS)
33
- - Project: {{SUPABASE_PROJECT_ID}}
34
- - Region: {{SUPABASE_REGION}}
35
- {{/if}}
36
-
37
- ### Infrastructure
38
- {{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
39
- {{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
40
- {{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
41
- {{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
42
- {{/if}}
43
-
44
- {{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
45
- - API: {{EASYPANEL_API_URL}}
46
- - Web: {{EASYPANEL_WEB_URL}}
47
- {{/if}}
48
-
49
- ---
50
-
51
- ## Active Features
52
-
53
- {{#each ACTIVE_FEATURES}}
54
- ### {{name}} ({{phase}})
55
- **Status:** {{status}}
56
- **Complexity:** {{complexity}}
57
- **Active Agents:** {{activeAgents}}
58
-
59
- {{#if description}}{{description}}{{/if}}
60
-
61
- **Progress:**
62
- - Tasks: {{tasks.completed}}/{{tasks.total}}
63
- - Outputs: {{outputs}}
64
-
65
- {{/each}}
66
-
67
- ---
68
-
69
- ## Project Standards
70
-
71
- ### Coding Standards
72
- {{#each PROJECT_STANDARDS}}
73
- - [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
74
- {{/each}}
75
-
76
- ### Inferred Patterns
77
- {{#if INFERRED_STANDARDS}}
78
- {{INFERRED_STANDARDS}}
79
- {{/if}}
80
-
81
- ---
82
-
83
- ## Active Agents ({{AGENT_COUNT}})
84
-
85
- ### Tier 1: Orchestrators
86
- {{#each TIER_1_AGENTS}}
87
- - **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
88
- {{/each}}
89
-
90
- ### Tier 2: Domain Leaders
91
- {{#each TIER_2_AGENTS}}
92
- - **{{title}}** (`{{id}}`) - {{domains}}
93
- {{/each}}
94
-
95
- ### Tier 3: Specialists
96
- {{#each TIER_3_AGENTS}}
97
- - **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
98
- {{/each}}
99
-
100
- ---
101
-
102
- ## Agent Teams Status
103
-
104
- {{#if AGENT_TEAMS_ENABLED}}
105
- ✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
106
-
107
- **Spawn Thresholds:**
108
- - Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
109
- - Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
110
- - Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
111
- - Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
112
-
113
- {{else}}
114
- ❌ **Disabled** - Use single session with subagents
115
- {{/if}}
116
-
117
- ---
118
-
119
- ## Recent Checkpoints
120
-
121
- {{#each RECENT_CHECKPOINTS}}
122
- ### {{timestamp}}
123
- **Feature:** {{feature}}
124
- **Phase:** {{phase}}
125
- **Note:** {{note}}
126
-
127
- {{#if validation}}
128
- **Validation:** {{validation.passed}}/{{validation.total}} checks passed
129
- {{/if}}
130
-
131
- {{/each}}
132
-
133
- ---
134
-
135
- {{#if DEVOPS_ENABLED}}
136
- ## DevOps Integration
137
-
138
- **Organization:** {{DEVOPS_ORG}}
139
- **Project:** {{DEVOPS_PROJECT}}
140
-
141
- - **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
142
- - **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
143
- - **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
144
-
145
- ---
146
-
147
- {{/if}}
148
-
149
- ## Quick Reference
150
-
151
- ### Workflow Commands
152
- ```bash
153
- # Detect agents for feature
154
- morph-spec detect-agents "{feature description}"
155
-
156
- # Initialize new feature
157
- morph-spec state init
158
-
159
- # Generate design system
160
- morph-spec generate design-system {feature}
161
-
162
- # Advance to next phase
163
- morph-spec phase advance {feature}
164
-
165
- # Mark task complete (runs validators)
166
- morph-spec task done {feature} {task-id}
167
-
168
- # Generate recap
169
- morph-spec generate recap {feature}
170
- ```
171
-
172
- ### Key Paths
173
- - **Outputs:** `.morph/features/{feature}/`
174
- - **Standards:** `.morph/context/` (project overrides)
175
- - **Config:** `.morph/config/config.json`
176
- - **State:** `.morph/state.json`
177
- - **Templates:** `.morph/framework/templates/`
178
-
179
- ---
180
-
181
- *Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
1
+ # {{PROJECT_NAME}} - Project Context
2
+
3
+ > Auto-generated by MORPH-SPEC Framework
4
+ > Last updated: {{TIMESTAMP}}
5
+
6
+ ## Project Overview
7
+
8
+ **Name:** {{PROJECT_NAME}}
9
+ **Type:** {{PROJECT_TYPE}}
10
+ **Repository:** {{REPOSITORY_URL}}
11
+
12
+ {{PROJECT_DESCRIPTION}}
13
+
14
+ ---
15
+
16
+ ## Technology Stack
17
+
18
+ ### Frontend
19
+ {{#if BLAZOR_ENABLED}}- **Blazor Server** {{BLAZOR_VERSION}}{{/if}}
20
+ {{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
21
+ {{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
22
+
23
+ ### Backend
24
+ - **.NET** {{DOTNET_VERSION}}
25
+ {{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
26
+ {{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
27
+ {{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
28
+ {{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
29
+
30
+ ### Database
31
+ {{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
32
+ {{#if SUPABASE_ENABLED}}- **Supabase** (PostgreSQL + Auth + Storage + RLS)
33
+ - Project: {{SUPABASE_PROJECT_ID}}
34
+ - Region: {{SUPABASE_REGION}}
35
+ {{/if}}
36
+
37
+ ### Infrastructure
38
+ {{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
39
+ {{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
40
+ {{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
41
+ {{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
42
+ {{/if}}
43
+
44
+ {{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
45
+ - API: {{EASYPANEL_API_URL}}
46
+ - Web: {{EASYPANEL_WEB_URL}}
47
+ {{/if}}
48
+
49
+ ---
50
+
51
+ ## Active Features
52
+
53
+ {{#each ACTIVE_FEATURES}}
54
+ ### {{name}} ({{phase}})
55
+ **Status:** {{status}}
56
+ **Complexity:** {{complexity}}
57
+ **Active Agents:** {{activeAgents}}
58
+
59
+ {{#if description}}{{description}}{{/if}}
60
+
61
+ **Progress:**
62
+ - Tasks: {{tasks.completed}}/{{tasks.total}}
63
+ - Outputs: {{outputs}}
64
+
65
+ {{/each}}
66
+
67
+ ---
68
+
69
+ ## Project Standards
70
+
71
+ ### Coding Standards
72
+ {{#each PROJECT_STANDARDS}}
73
+ - [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
74
+ {{/each}}
75
+
76
+ ### Inferred Patterns
77
+ {{#if INFERRED_STANDARDS}}
78
+ {{INFERRED_STANDARDS}}
79
+ {{/if}}
80
+
81
+ ---
82
+
83
+ ## Active Agents ({{AGENT_COUNT}})
84
+
85
+ ### Tier 1: Orchestrators
86
+ {{#each TIER_1_AGENTS}}
87
+ - **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
88
+ {{/each}}
89
+
90
+ ### Tier 2: Domain Leaders
91
+ {{#each TIER_2_AGENTS}}
92
+ - **{{title}}** (`{{id}}`) - {{domains}}
93
+ {{/each}}
94
+
95
+ ### Tier 3: Specialists
96
+ {{#each TIER_3_AGENTS}}
97
+ - **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
98
+ {{/each}}
99
+
100
+ ---
101
+
102
+ ## Agent Teams Status
103
+
104
+ {{#if AGENT_TEAMS_ENABLED}}
105
+ ✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
106
+
107
+ **Spawn Thresholds:**
108
+ - Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
109
+ - Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
110
+ - Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
111
+ - Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
112
+
113
+ {{else}}
114
+ ❌ **Disabled** - Use single session with subagents
115
+ {{/if}}
116
+
117
+ ---
118
+
119
+ ## Recent Checkpoints
120
+
121
+ {{#each RECENT_CHECKPOINTS}}
122
+ ### {{timestamp}}
123
+ **Feature:** {{feature}}
124
+ **Phase:** {{phase}}
125
+ **Note:** {{note}}
126
+
127
+ {{#if validation}}
128
+ **Validation:** {{validation.passed}}/{{validation.total}} checks passed
129
+ {{/if}}
130
+
131
+ {{/each}}
132
+
133
+ ---
134
+
135
+ {{#if DEVOPS_ENABLED}}
136
+ ## DevOps Integration
137
+
138
+ **Organization:** {{DEVOPS_ORG}}
139
+ **Project:** {{DEVOPS_PROJECT}}
140
+
141
+ - **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
142
+ - **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
143
+ - **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
144
+
145
+ ---
146
+
147
+ {{/if}}
148
+
149
+ ## Quick Reference
150
+
151
+ ### Workflow Commands
152
+ ```bash
153
+ # Detect agents for feature
154
+ morph-spec detect-agents "{feature description}"
155
+
156
+ # Initialize new feature
157
+ morph-spec state init
158
+
159
+ # Generate design system
160
+ morph-spec generate design-system {feature}
161
+
162
+ # Advance to next phase
163
+ morph-spec phase advance {feature}
164
+
165
+ # Mark task complete (runs validators)
166
+ morph-spec task done {feature} {task-id}
167
+
168
+ # Generate recap
169
+ morph-spec generate recap {feature}
170
+ ```
171
+
172
+ ### Key Paths
173
+ - **Outputs:** `.morph/features/{feature}/`
174
+ - **Standards:** `.morph/context/` (project overrides)
175
+ - **Config:** `.morph/config/config.json`
176
+ - **State:** `.morph/state.json`
177
+ - **Templates:** `.morph/framework/templates/`
178
+
179
+ ---
180
+
181
+ *Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
@@ -0,0 +1,211 @@
1
+ # Design System — [PROJECT_NAME]
2
+
3
+ > **Template** — copy to `.morph/context/design-system.md` and fill in TODOs.
4
+
5
+ Living document. All agents read this before any UI work. All design decisions land here.
6
+
7
+ ---
8
+
9
+ ## Aesthetic Direction
10
+
11
+ - **Direction**: [Minimal Refined / Editorial / Soft Professional / Industrial / Modern Luxury]
12
+ - **Tone**: [TODO: 1-2 sentences about the feel]
13
+ - **Differentiator**: [TODO: The 1 memorable element of this interface]
14
+ - **Font Pair**: [Display font] + [Body font]
15
+ - **Color Philosophy**: [Dominant color] + [Accent color] — [1-sentence rationale]
16
+ - **Motion Personality**: [subtle / expressive / playful / precise]
17
+ - **Visual Density**: [compact / balanced / spacious]
18
+ - **Composition**: [TODO: Layout approach]
19
+
20
+ ---
21
+
22
+ ## Color Tokens
23
+
24
+ ```css
25
+ :root {
26
+ /* Dominant palette */
27
+ --color-primary: #TODO;
28
+ --color-primary-light: #TODO;
29
+ --color-primary-dark: #TODO;
30
+
31
+ /* Sharp accent */
32
+ --color-accent: #TODO;
33
+ --color-accent-hover: #TODO;
34
+
35
+ /* Neutrals */
36
+ --color-neutral-50: #f9fafb;
37
+ --color-neutral-100: #f3f4f6;
38
+ --color-neutral-200: #e5e7eb;
39
+ --color-neutral-300: #d1d5db;
40
+ --color-neutral-400: #9ca3af;
41
+ --color-neutral-500: #6b7280;
42
+ --color-neutral-600: #4b5563;
43
+ --color-neutral-700: #374151;
44
+ --color-neutral-800: #1f2937;
45
+ --color-neutral-900: #111827;
46
+
47
+ /* Surface */
48
+ --color-surface: #ffffff;
49
+ --color-surface-alt: #f8f9fa;
50
+ --color-border: rgba(0,0,0,0.08);
51
+
52
+ /* Semantic */
53
+ --color-success: #22c55e;
54
+ --color-warning: #f59e0b;
55
+ --color-error: #ef4444;
56
+ --color-info: #3b82f6;
57
+
58
+ /* Text */
59
+ --color-text-primary: #TODO;
60
+ --color-text-secondary: #TODO;
61
+ --color-text-muted: #9ca3af;
62
+ }
63
+ ```
64
+
65
+ ---
66
+
67
+ ## Typography
68
+
69
+ ```css
70
+ :root {
71
+ /* Font families */
72
+ --font-display: '[TODO: Display font]', serif;
73
+ --font-body: '[TODO: Body font]', sans-serif;
74
+ --font-mono: 'JetBrains Mono', monospace;
75
+
76
+ /* Scale */
77
+ --text-xs: 0.75rem; /* 12px */
78
+ --text-sm: 0.875rem; /* 14px */
79
+ --text-base: 1rem; /* 16px */
80
+ --text-lg: 1.125rem; /* 18px */
81
+ --text-xl: 1.25rem; /* 20px */
82
+ --text-2xl: 1.5rem; /* 24px */
83
+ --text-3xl: 1.875rem; /* 30px */
84
+ --text-4xl: 2.25rem; /* 36px */
85
+
86
+ /* Weights */
87
+ --font-weight-regular: 400;
88
+ --font-weight-medium: 500;
89
+ --font-weight-semibold: 600;
90
+ --font-weight-bold: 700;
91
+
92
+ /* Line heights */
93
+ --leading-tight: 1.25;
94
+ --leading-normal: 1.5;
95
+ --leading-relaxed: 1.75;
96
+ }
97
+ ```
98
+
99
+ ---
100
+
101
+ ## Motion Tokens
102
+
103
+ ```css
104
+ :root {
105
+ /* Durations */
106
+ --duration-instant: 0.05s;
107
+ --duration-fast: 0.15s;
108
+ --duration-base: 0.3s;
109
+ --duration-slow: 0.5s;
110
+ --duration-slower: 0.8s;
111
+
112
+ /* Easings */
113
+ --easing-standard: cubic-bezier(0.4, 0, 0.2, 1);
114
+ --easing-decelerate: cubic-bezier(0, 0, 0.2, 1);
115
+ --easing-accelerate: cubic-bezier(0.4, 0, 1, 1);
116
+ --easing-bounce: cubic-bezier(0.34, 1.56, 0.64, 1);
117
+ --easing-spring: cubic-bezier(0.68, -0.55, 0.265, 1.55);
118
+ }
119
+ ```
120
+
121
+ ### Framer Motion mapping (TypeScript)
122
+
123
+ ```typescript
124
+ // Map CSS tokens to Framer Motion values
125
+ export const durations = {
126
+ instant: 0.05,
127
+ fast: 0.15,
128
+ base: 0.3,
129
+ slow: 0.5,
130
+ slower: 0.8,
131
+ } as const;
132
+
133
+ export const easings = {
134
+ standard: [0.4, 0, 0.2, 1] as const,
135
+ decelerate: [0, 0, 0.2, 1] as const,
136
+ accelerate: [0.4, 0, 1, 1] as const,
137
+ bounce: [0.34, 1.56, 0.64, 1] as const,
138
+ spring: [0.68, -0.55, 0.265, 1.55] as const,
139
+ };
140
+ ```
141
+
142
+ ---
143
+
144
+ ## Spacing Tokens
145
+
146
+ ```css
147
+ :root {
148
+ /* 4px base grid */
149
+ --space-1: 0.25rem; /* 4px */
150
+ --space-2: 0.5rem; /* 8px */
151
+ --space-3: 0.75rem; /* 12px */
152
+ --space-4: 1rem; /* 16px */
153
+ --space-5: 1.25rem; /* 20px */
154
+ --space-6: 1.5rem; /* 24px */
155
+ --space-8: 2rem; /* 32px */
156
+ --space-10: 2.5rem; /* 40px */
157
+ --space-12: 3rem; /* 48px */
158
+ --space-16: 4rem; /* 64px */
159
+ --space-20: 5rem; /* 80px */
160
+ --space-24: 6rem; /* 96px */
161
+
162
+ /* Container */
163
+ --container-padding: var(--space-8);
164
+ --grid-gap: var(--space-6);
165
+ }
166
+ ```
167
+
168
+ ---
169
+
170
+ ## Border Radius Tokens
171
+
172
+ ```css
173
+ :root {
174
+ --radius-none: 0;
175
+ --radius-sm: 0.25rem; /* 4px */
176
+ --radius-base: 0.375rem; /* 6px */
177
+ --radius-md: 0.5rem; /* 8px */
178
+ --radius-lg: 0.75rem; /* 12px */
179
+ --radius-xl: 1rem; /* 16px */
180
+ --radius-2xl: 1.5rem; /* 24px */
181
+ --radius-full: 9999px;
182
+ }
183
+ ```
184
+
185
+ ---
186
+
187
+ ## Shadow Tokens
188
+
189
+ ```css
190
+ :root {
191
+ --shadow-sm: 0 1px 2px rgba(0,0,0,0.05);
192
+ --shadow-base: 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px rgba(0,0,0,0.06);
193
+ --shadow-md: 0 4px 6px rgba(0,0,0,0.07), 0 2px 4px rgba(0,0,0,0.06);
194
+ --shadow-lg: 0 10px 15px rgba(0,0,0,0.1), 0 4px 6px rgba(0,0,0,0.05);
195
+ --shadow-xl: 0 20px 25px rgba(0,0,0,0.1), 0 10px 10px rgba(0,0,0,0.04);
196
+ --shadow-lift: 0 8px 30px rgba(0,0,0,0.12); /* Card hover lift */
197
+ }
198
+ ```
199
+
200
+ ---
201
+
202
+ ## Changelog
203
+
204
+ > Living record — every agent that adds tokens or design decisions registers here.
205
+ > Format: `- YYYY-MM-DD [agent-id] Description of addition/change`
206
+
207
+ <!-- Entries below this line, newest first -->
208
+
209
+ ---
210
+
211
+ *MORPH-SPEC by Polymorphism Tech*