@polymorphism-tech/morph-spec 3.2.0 → 4.3.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 (386) hide show
  1. package/README.md +1 -14
  2. package/bin/detect-agents.js +1 -1
  3. package/bin/morph-spec.js +403 -40
  4. package/bin/validate.js +5 -5
  5. package/docs/getting-started.md +0 -5
  6. package/docs/next-generation/AGENTS.md +521 -0
  7. package/docs/next-generation/ANALYSIS.md +555 -0
  8. package/docs/next-generation/ARCHITECTURE.md +436 -0
  9. package/docs/next-generation/CONTEXT-OPTIMIZATION.md +267 -0
  10. package/docs/next-generation/EXECUTION-FLOW.md +274 -0
  11. package/docs/next-generation/FEATURES.md +688 -0
  12. package/docs/next-generation/META-PROMPTS.md +235 -0
  13. package/docs/next-generation/MIGRATION-GUIDE.md +253 -0
  14. package/docs/next-generation/README.md +231 -0
  15. package/docs/next-generation/ROADMAP.md +801 -0
  16. package/docs/next-generation/THREAD-MANAGEMENT.md +240 -0
  17. package/docs/validation-checklist.md +0 -1
  18. package/package.json +5 -5
  19. package/src/commands/agents/agents-fuse.js +96 -0
  20. package/src/commands/agents/index.js +4 -0
  21. package/src/commands/agents/micro-agent.js +112 -0
  22. package/src/commands/{spawn-team.js → agents/spawn-team.js} +237 -172
  23. package/src/commands/agents/squad-template.js +146 -0
  24. package/src/commands/analytics/analytics.js +176 -0
  25. package/src/commands/context/context-prime.js +63 -0
  26. package/src/commands/context/core-four.js +54 -0
  27. package/src/commands/{create-story.js → feature/create-story.js} +357 -354
  28. package/src/commands/feature/index.js +6 -0
  29. package/src/commands/{shard-spec.js → feature/shard-spec.js} +2 -2
  30. package/src/commands/{sprint-status.js → feature/sprint-status.js} +1 -1
  31. package/src/commands/{generate-context.js → generation/generate-context.js} +40 -40
  32. package/src/commands/{generate.js → generation/generate.js} +4 -4
  33. package/src/commands/generation/index.js +5 -0
  34. package/src/commands/index.js +16 -0
  35. package/src/commands/{capture-pattern.js → learning/capture-pattern.js} +121 -121
  36. package/src/commands/learning/index.js +5 -0
  37. package/src/commands/mcp/mcp.js +102 -0
  38. package/src/commands/{detect-agents.js → project/detect-agents.js} +178 -178
  39. package/src/commands/project/detect-workflow.js +174 -0
  40. package/src/commands/{detect.js → project/detect.js} +104 -104
  41. package/src/commands/{doctor.js → project/doctor.js} +221 -4
  42. package/src/commands/project/index.js +10 -0
  43. package/src/commands/{init.js → project/init.js} +305 -295
  44. package/src/commands/{sync.js → project/sync.js} +167 -167
  45. package/src/commands/{update.js → project/update.js} +240 -240
  46. package/src/commands/{advance-phase.js → state/advance-phase.js} +101 -25
  47. package/src/commands/{approve.js → state/approve.js} +221 -221
  48. package/src/commands/state/index.js +8 -0
  49. package/src/commands/{rollback-phase.js → state/rollback-phase.js} +185 -185
  50. package/src/commands/{state.js → state/state.js} +334 -334
  51. package/src/commands/{validate-phase.js → state/validate-phase.js} +221 -221
  52. package/src/commands/tasks/index.js +4 -0
  53. package/src/commands/{task.js → tasks/task.js} +78 -78
  54. package/src/commands/templates/index.js +8 -0
  55. package/src/commands/templates/template-customize.js +101 -0
  56. package/src/commands/templates/template-list.js +128 -0
  57. package/src/commands/templates/template-render.js +174 -0
  58. package/src/commands/templates/template-show.js +131 -0
  59. package/src/commands/templates/template-validate.js +91 -0
  60. package/src/commands/threads/thread-template.js +103 -0
  61. package/src/commands/threads/threads.js +261 -0
  62. package/src/commands/trust/trust.js +205 -0
  63. package/src/commands/utils/index.js +7 -0
  64. package/src/commands/{session-summary.js → utils/session-summary.js} +291 -291
  65. package/src/commands/{troubleshoot.js → utils/troubleshoot.js} +222 -222
  66. package/src/commands/{analyze-blazor-concurrency.js → validation/analyze-blazor-concurrency.js} +193 -193
  67. package/src/commands/validation/index.js +8 -0
  68. package/src/commands/{lint-fluent.js → validation/lint-fluent.js} +352 -352
  69. package/src/commands/{validate-blazor-state.js → validation/validate-blazor-state.js} +210 -210
  70. package/src/commands/{validate-blazor.js → validation/validate-blazor.js} +156 -156
  71. package/src/commands/{validate-css.js → validation/validate-css.js} +84 -84
  72. package/src/core/index.js +10 -0
  73. package/src/{orchestrator.js → core/orchestrator.js} +8 -8
  74. package/src/core/registry/command-registry.js +302 -0
  75. package/src/core/registry/index.js +8 -0
  76. package/src/core/registry/validator-registry.js +204 -0
  77. package/src/core/state/index.js +8 -0
  78. package/src/{lib → core/state}/phase-state-machine.js +214 -214
  79. package/src/{lib → core/state}/state-manager.js +588 -534
  80. package/src/core/templates/index.js +9 -0
  81. package/src/core/templates/template-registry.js +335 -0
  82. package/src/core/templates/template-renderer.js +477 -0
  83. package/src/core/templates/template-validator.js +296 -0
  84. package/src/core/workflows/index.js +7 -0
  85. package/src/core/workflows/workflow-detector.js +452 -0
  86. package/src/lib/agents/micro-agent-factory.js +161 -0
  87. package/src/lib/{complexity-analyzer.js → analysis/complexity-analyzer.js} +441 -441
  88. package/src/lib/analysis/index.js +7 -0
  89. package/src/lib/analytics/analytics-engine.js +345 -0
  90. package/src/lib/{checkpoint-hooks.js → checkpoints/checkpoint-hooks.js} +35 -0
  91. package/src/lib/checkpoints/index.js +7 -0
  92. package/src/lib/context/context-bundler.js +240 -0
  93. package/src/lib/context/context-optimizer.js +212 -0
  94. package/src/lib/context/context-tracker.js +273 -0
  95. package/src/lib/context/core-four-tracker.js +201 -0
  96. package/src/lib/context/mcp-optimizer.js +200 -0
  97. package/src/lib/detectors/config-detector.js +223 -223
  98. package/src/lib/detectors/conversation-analyzer.js +163 -163
  99. package/src/lib/{design-system-detector.js → detectors/design-system-detector.js} +187 -187
  100. package/src/lib/detectors/index.js +87 -84
  101. package/src/lib/detectors/standards-generator.js +275 -275
  102. package/src/lib/detectors/structure-detector.js +245 -245
  103. package/src/lib/execution/fusion-executor.js +304 -0
  104. package/src/lib/execution/parallel-executor.js +270 -0
  105. package/src/lib/{context-generator.js → generators/context-generator.js} +526 -516
  106. package/src/lib/generators/index.js +10 -0
  107. package/src/lib/{metadata-extractor.js → generators/metadata-extractor.js} +387 -380
  108. package/src/lib/{recap-generator.js → generators/recap-generator.js} +205 -205
  109. package/src/lib/hooks/hook-executor.js +169 -0
  110. package/src/lib/hooks/stop-hook-executor.js +286 -0
  111. package/src/lib/hops/hop-composer.js +221 -0
  112. package/src/lib/learning/index.js +7 -0
  113. package/src/lib/orchestration/index.js +7 -0
  114. package/src/lib/{team-orchestrator.js → orchestration/team-orchestrator.js} +323 -323
  115. package/src/lib/stacks/index.js +7 -0
  116. package/src/lib/{stack-resolver.js → stacks/stack-resolver.js} +180 -148
  117. package/src/lib/standards/index.js +7 -0
  118. package/src/lib/{standards-context-injector.js → standards/standards-context-injector.js} +298 -288
  119. package/src/lib/threads/thread-coordinator.js +238 -0
  120. package/src/lib/threads/thread-manager.js +317 -0
  121. package/src/lib/tracking/artifact-trail.js +202 -0
  122. package/src/lib/troubleshooting/index.js +8 -0
  123. package/src/lib/{troubleshoot-grep.js → troubleshooting/troubleshoot-grep.js} +204 -204
  124. package/src/lib/{troubleshoot-index.js → troubleshooting/troubleshoot-index.js} +144 -144
  125. package/src/lib/trust/trust-manager.js +269 -0
  126. package/src/lib/validators/{architecture-validator.js → architecture/architecture-validator.js} +8 -8
  127. package/src/lib/validators/architecture/index.js +7 -0
  128. package/src/lib/{blazor-concurrency-analyzer.js → validators/blazor/blazor-concurrency-analyzer.js} +277 -288
  129. package/src/lib/{blazor-state-validator.js → validators/blazor/blazor-state-validator.js} +279 -291
  130. package/src/lib/{blazor-validator.js → validators/blazor/blazor-validator.js} +369 -374
  131. package/src/lib/validators/blazor/index.js +9 -0
  132. package/src/lib/validators/{content-validator.js → content/content-validator.js} +351 -351
  133. package/src/lib/validators/content/index.js +7 -0
  134. package/src/lib/validators/{contract-compliance-validator.js → contracts/contract-compliance-validator.js} +273 -273
  135. package/src/lib/validators/contracts/index.js +7 -0
  136. package/src/lib/{css-validator.js → validators/css/css-validator.js} +352 -352
  137. package/src/lib/validators/css/index.js +7 -0
  138. package/src/lib/validators/{design-system-validator.js → design-system/design-system-validator.js} +231 -231
  139. package/src/lib/validators/design-system/index.js +7 -0
  140. package/src/lib/validators/packages/index.js +7 -0
  141. package/src/lib/validators/shared/index.js +12 -0
  142. package/src/lib/validators/shared/issue-counter.js +18 -0
  143. package/src/lib/validators/shared/result-formatter.js +124 -0
  144. package/src/lib/{spec-validator.js → validators/spec-validator.js} +258 -258
  145. package/src/lib/validators/ui/index.js +7 -0
  146. package/src/lib/{validation-runner.js → validators/validation-runner.js} +286 -284
  147. package/src/ui/wizard-questions.js +0 -2
  148. package/src/utils/color-utils.js +70 -0
  149. package/src/utils/file-copier.js +188 -189
  150. package/src/utils/process-handler.js +97 -0
  151. package/stacks/blazor-azure/.morph/config/agents.json +948 -764
  152. package/stacks/blazor-azure/.morph/hooks/{pre-commit-tests.sh → pre-commit/tests-csharp.sh} +3 -2
  153. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +41 -0
  154. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +24 -0
  155. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +23 -0
  156. package/stacks/nextjs-supabase/.morph/config/agents.json +345 -345
  157. package/stacks/nextjs-supabase/.morph/hooks/pre-commit/tests-typescript.sh +61 -0
  158. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +22 -0
  159. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +22 -0
  160. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +35 -0
  161. package/stacks/nextjs-supabase/README.md +6 -15
  162. package/CLAUDE.md +0 -648
  163. package/bin/render-template.js +0 -349
  164. package/bin/semantic-detect-agents.js +0 -247
  165. package/bin/validate-agents-skills.js +0 -257
  166. package/bin/validate-agents.js +0 -70
  167. package/bin/validate-phase.js +0 -263
  168. package/docs/examples.md +0 -328
  169. package/docs/llm-interaction-config.md +0 -735
  170. package/scripts/reorganize-skills.cjs +0 -175
  171. package/scripts/validate-agents-structure.cjs +0 -52
  172. package/scripts/validate-skills.cjs +0 -180
  173. package/src/commands/deploy.js +0 -780
  174. package/src/commands/migrate-state.js +0 -158
  175. package/src/commands/upgrade.js +0 -346
  176. package/src/lib/continuous-validator.js +0 -421
  177. package/src/lib/decision-constraint-loader.js +0 -109
  178. package/src/lib/design-system-scaffolder.js +0 -299
  179. package/src/lib/hook-executor.js +0 -257
  180. package/src/lib/mockup-generator.js +0 -366
  181. package/src/lib/ui-detector.js +0 -350
  182. package/src/llm/schema-validator.js +0 -121
  183. package/src/sanitizer/.gitkeep +0 -0
  184. package/src/scanner/.gitkeep +0 -0
  185. package/src/types/index.js +0 -477
  186. package/src/ui/.gitkeep +0 -0
  187. package/src/writer/.gitkeep +0 -0
  188. package/stacks/blazor-azure/.azure/README.md +0 -293
  189. package/stacks/blazor-azure/.azure/docs/azure-devops-setup.md +0 -454
  190. package/stacks/blazor-azure/.azure/docs/branch-strategy.md +0 -398
  191. package/stacks/blazor-azure/.azure/docs/local-development.md +0 -515
  192. package/stacks/blazor-azure/.azure/pipelines/pipeline-variables.yml +0 -34
  193. package/stacks/blazor-azure/.azure/pipelines/prod-pipeline.yml +0 -319
  194. package/stacks/blazor-azure/.azure/pipelines/staging-pipeline.yml +0 -234
  195. package/stacks/blazor-azure/.azure/pipelines/templates/build-dotnet.yml +0 -75
  196. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-app-service.yml +0 -94
  197. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-container-app.yml +0 -120
  198. package/stacks/blazor-azure/.azure/pipelines/templates/infra-deploy.yml +0 -90
  199. package/stacks/blazor-azure/.claude/commands/morph-apply.md +0 -221
  200. package/stacks/blazor-azure/.claude/commands/morph-archive.md +0 -79
  201. package/stacks/blazor-azure/.claude/commands/morph-deploy.md +0 -529
  202. package/stacks/blazor-azure/.claude/commands/morph-infra.md +0 -209
  203. package/stacks/blazor-azure/.claude/commands/morph-preflight.md +0 -227
  204. package/stacks/blazor-azure/.claude/commands/morph-proposal.md +0 -122
  205. package/stacks/blazor-azure/.claude/commands/morph-status.md +0 -86
  206. package/stacks/blazor-azure/.claude/commands/morph-troubleshoot.md +0 -122
  207. package/stacks/blazor-azure/.claude/settings.local.json +0 -15
  208. package/stacks/blazor-azure/.claude/skills/level-0-meta/README.md +0 -7
  209. package/stacks/blazor-azure/.claude/skills/level-0-meta/code-review.md +0 -226
  210. package/stacks/blazor-azure/.claude/skills/level-0-meta/morph-checklist.md +0 -117
  211. package/stacks/blazor-azure/.claude/skills/level-0-meta/simulation-checklist.md +0 -77
  212. package/stacks/blazor-azure/.claude/skills/level-1-workflows/README.md +0 -7
  213. package/stacks/blazor-azure/.claude/skills/level-1-workflows/morph-replicate.md +0 -213
  214. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-clarify.md +0 -131
  215. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-design.md +0 -213
  216. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-setup.md +0 -106
  217. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-tasks.md +0 -164
  218. package/stacks/blazor-azure/.claude/skills/level-1-workflows/phase-uiux.md +0 -169
  219. package/stacks/blazor-azure/.claude/skills/level-2-domains/README.md +0 -14
  220. package/stacks/blazor-azure/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +0 -192
  221. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/po-pm-advisor.md +0 -197
  222. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/prompt-engineer.md +0 -189
  223. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/seo-growth-hacker.md +0 -320
  224. package/stacks/blazor-azure/.claude/skills/level-2-domains/architecture/standards-architect.md +0 -156
  225. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/dotnet-senior.md +0 -287
  226. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ef-modeler.md +0 -113
  227. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +0 -126
  228. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ms-agent-expert.md +0 -109
  229. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/blazor-builder.md +0 -210
  230. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/nextjs-expert.md +0 -154
  231. package/stacks/blazor-azure/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +0 -191
  232. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/azure-architect.md +0 -142
  233. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/azure-deploy-specialist.md +0 -699
  234. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +0 -126
  235. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/container-specialist.md +0 -131
  236. package/stacks/blazor-azure/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +0 -119
  237. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/asaas-financial.md +0 -130
  238. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/azure-identity.md +0 -142
  239. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/clerk-auth.md +0 -108
  240. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/resend-email.md +0 -119
  241. package/stacks/blazor-azure/.claude/skills/level-2-domains/quality/code-analyzer.md +0 -235
  242. package/stacks/blazor-azure/.claude/skills/level-2-domains/quality/testing-specialist.md +0 -126
  243. package/stacks/blazor-azure/.claude/skills/level-3-technologies/README.md +0 -7
  244. package/stacks/blazor-azure/.claude/skills/level-4-patterns/README.md +0 -7
  245. package/stacks/blazor-azure/.morph/archive/.gitkeep +0 -25
  246. package/stacks/blazor-azure/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -392
  247. package/stacks/blazor-azure/.morph/docs/workflows/design-impl.md +0 -37
  248. package/stacks/blazor-azure/.morph/docs/workflows/enforcement-pipeline.md +0 -668
  249. package/stacks/blazor-azure/.morph/docs/workflows/fast-track.md +0 -29
  250. package/stacks/blazor-azure/.morph/docs/workflows/full-morph.md +0 -76
  251. package/stacks/blazor-azure/.morph/docs/workflows/standard.md +0 -44
  252. package/stacks/blazor-azure/.morph/docs/workflows/ui-refresh.md +0 -39
  253. package/stacks/blazor-azure/.morph/examples/api-nextjs/README.md +0 -241
  254. package/stacks/blazor-azure/.morph/examples/api-nextjs/contracts.ts +0 -307
  255. package/stacks/blazor-azure/.morph/examples/api-nextjs/spec.md +0 -399
  256. package/stacks/blazor-azure/.morph/examples/api-nextjs/tasks.md +0 -168
  257. package/stacks/blazor-azure/.morph/examples/micro-saas/README.md +0 -125
  258. package/stacks/blazor-azure/.morph/examples/micro-saas/contracts.cs +0 -358
  259. package/stacks/blazor-azure/.morph/examples/micro-saas/decisions.md +0 -246
  260. package/stacks/blazor-azure/.morph/examples/micro-saas/spec.md +0 -236
  261. package/stacks/blazor-azure/.morph/examples/micro-saas/tasks.md +0 -150
  262. package/stacks/blazor-azure/.morph/examples/multi-agent/README.md +0 -309
  263. package/stacks/blazor-azure/.morph/examples/multi-agent/contracts.cs +0 -433
  264. package/stacks/blazor-azure/.morph/examples/multi-agent/spec.md +0 -479
  265. package/stacks/blazor-azure/.morph/examples/multi-agent/tasks.md +0 -185
  266. package/stacks/blazor-azure/.morph/examples/scheduled-reports/decisions.md +0 -158
  267. package/stacks/blazor-azure/.morph/examples/scheduled-reports/proposal.md +0 -95
  268. package/stacks/blazor-azure/.morph/examples/scheduled-reports/spec.md +0 -267
  269. package/stacks/blazor-azure/.morph/examples/state-v3.json +0 -188
  270. package/stacks/blazor-azure/.morph/features/.gitkeep +0 -25
  271. package/stacks/blazor-azure/.morph/hooks/README.md +0 -348
  272. package/stacks/blazor-azure/.morph/hooks/pre-commit-agents.sh +0 -24
  273. package/stacks/blazor-azure/.morph/hooks/pre-commit-all.sh +0 -48
  274. package/stacks/blazor-azure/.morph/hooks/pre-commit-specs.sh +0 -49
  275. package/stacks/blazor-azure/.morph/hooks/task-completed.js +0 -73
  276. package/stacks/blazor-azure/.morph/hooks/teammate-idle.js +0 -68
  277. package/stacks/blazor-azure/.morph/schemas/agent.schema.json +0 -296
  278. package/stacks/blazor-azure/.morph/schemas/tasks.schema.json +0 -220
  279. package/stacks/blazor-azure/.morph/specs/.gitkeep +0 -20
  280. package/stacks/blazor-azure/.morph/standards/agent-framework-blazor-ui.md +0 -359
  281. package/stacks/blazor-azure/.morph/standards/agent-framework-production.md +0 -410
  282. package/stacks/blazor-azure/.morph/standards/agent-framework-setup.md +0 -413
  283. package/stacks/blazor-azure/.morph/standards/agent-framework-workflows.md +0 -349
  284. package/stacks/blazor-azure/.morph/standards/agent-teams-workflow.md +0 -474
  285. package/stacks/blazor-azure/.morph/standards/architecture.md +0 -325
  286. package/stacks/blazor-azure/.morph/standards/azure.md +0 -605
  287. package/stacks/blazor-azure/.morph/standards/coding.md +0 -377
  288. package/stacks/blazor-azure/.morph/standards/dotnet10-migration.md +0 -520
  289. package/stacks/blazor-azure/.morph/standards/fluent-ui-setup.md +0 -590
  290. package/stacks/blazor-azure/.morph/standards/migration-guide.md +0 -514
  291. package/stacks/blazor-azure/.morph/standards/passkeys-auth.md +0 -423
  292. package/stacks/blazor-azure/.morph/standards/vector-search-rag.md +0 -536
  293. package/stacks/blazor-azure/.morph/templates/CONTEXT-FEATURE.md +0 -276
  294. package/stacks/blazor-azure/.morph/templates/CONTEXT.md +0 -170
  295. package/stacks/blazor-azure/.morph/templates/FluentDesignTheme.cs +0 -149
  296. package/stacks/blazor-azure/.morph/templates/MudTheme.cs +0 -281
  297. package/stacks/blazor-azure/.morph/templates/agent.cs +0 -163
  298. package/stacks/blazor-azure/.morph/templates/clarify-questions.md +0 -159
  299. package/stacks/blazor-azure/.morph/templates/component.razor +0 -239
  300. package/stacks/blazor-azure/.morph/templates/contracts/Commands.cs +0 -74
  301. package/stacks/blazor-azure/.morph/templates/contracts/Entities.cs +0 -25
  302. package/stacks/blazor-azure/.morph/templates/contracts/Queries.cs +0 -74
  303. package/stacks/blazor-azure/.morph/templates/contracts/README.md +0 -74
  304. package/stacks/blazor-azure/.morph/templates/contracts.cs +0 -217
  305. package/stacks/blazor-azure/.morph/templates/decisions.md +0 -123
  306. package/stacks/blazor-azure/.morph/templates/design-system.css +0 -226
  307. package/stacks/blazor-azure/.morph/templates/infra/.dockerignore.example +0 -89
  308. package/stacks/blazor-azure/.morph/templates/infra/Dockerfile.example +0 -82
  309. package/stacks/blazor-azure/.morph/templates/infra/README.md +0 -286
  310. package/stacks/blazor-azure/.morph/templates/infra/app-insights.bicep +0 -63
  311. package/stacks/blazor-azure/.morph/templates/infra/app-service.bicep +0 -164
  312. package/stacks/blazor-azure/.morph/templates/infra/azure-pipelines-deploy.yml +0 -480
  313. package/stacks/blazor-azure/.morph/templates/infra/container-app-env.bicep +0 -49
  314. package/stacks/blazor-azure/.morph/templates/infra/container-app.bicep +0 -156
  315. package/stacks/blazor-azure/.morph/templates/infra/deploy-checklist.md +0 -426
  316. package/stacks/blazor-azure/.morph/templates/infra/deploy.ps1 +0 -229
  317. package/stacks/blazor-azure/.morph/templates/infra/deploy.sh +0 -208
  318. package/stacks/blazor-azure/.morph/templates/infra/key-vault.bicep +0 -91
  319. package/stacks/blazor-azure/.morph/templates/infra/main.bicep +0 -189
  320. package/stacks/blazor-azure/.morph/templates/infra/parameters.dev.json +0 -29
  321. package/stacks/blazor-azure/.morph/templates/infra/parameters.prod.json +0 -29
  322. package/stacks/blazor-azure/.morph/templates/infra/parameters.staging.json +0 -29
  323. package/stacks/blazor-azure/.morph/templates/infra/sql-database.bicep +0 -103
  324. package/stacks/blazor-azure/.morph/templates/infra/storage.bicep +0 -106
  325. package/stacks/blazor-azure/.morph/templates/integrations/asaas-client.cs +0 -387
  326. package/stacks/blazor-azure/.morph/templates/integrations/asaas-webhook.cs +0 -351
  327. package/stacks/blazor-azure/.morph/templates/integrations/azure-identity-config.cs +0 -288
  328. package/stacks/blazor-azure/.morph/templates/integrations/clerk-config.cs +0 -258
  329. package/stacks/blazor-azure/.morph/templates/job.cs +0 -171
  330. package/stacks/blazor-azure/.morph/templates/migration.cs +0 -83
  331. package/stacks/blazor-azure/.morph/templates/proposal.md +0 -141
  332. package/stacks/blazor-azure/.morph/templates/recap.md +0 -94
  333. package/stacks/blazor-azure/.morph/templates/repository.cs +0 -141
  334. package/stacks/blazor-azure/.morph/templates/saas/subscription.cs +0 -347
  335. package/stacks/blazor-azure/.morph/templates/saas/tenant.cs +0 -338
  336. package/stacks/blazor-azure/.morph/templates/service.cs +0 -139
  337. package/stacks/blazor-azure/.morph/templates/simulation.md +0 -353
  338. package/stacks/blazor-azure/.morph/templates/spec.md +0 -149
  339. package/stacks/blazor-azure/.morph/templates/sprint-status.yaml +0 -68
  340. package/stacks/blazor-azure/.morph/templates/state.template.json +0 -222
  341. package/stacks/blazor-azure/.morph/templates/story.md +0 -143
  342. package/stacks/blazor-azure/.morph/templates/tasks.md +0 -257
  343. package/stacks/blazor-azure/.morph/templates/test.cs +0 -239
  344. package/stacks/blazor-azure/.morph/templates/ui-components.md +0 -362
  345. package/stacks/blazor-azure/.morph/templates/ui-design-system.md +0 -286
  346. package/stacks/blazor-azure/.morph/templates/ui-flows.md +0 -336
  347. package/stacks/blazor-azure/.morph/templates/ui-mockups.md +0 -133
  348. package/stacks/blazor-azure/.morph/test-infra/example.bicep +0 -59
  349. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/backend/dotnet-supabase.md +0 -244
  350. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/frontend/nextjs-supabase.md +0 -335
  351. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/infrastructure/easypanel-deployer.md +0 -189
  352. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +0 -170
  353. package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +0 -169
  354. package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +0 -247
  355. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +0 -697
  356. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +0 -85
  357. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +0 -86
  358. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +0 -498
  359. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +0 -121
  360. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +0 -138
  361. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +0 -162
  362. package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +0 -191
  363. package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +0 -193
  364. package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +0 -171
  365. package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +0 -164
  366. package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +0 -179
  367. package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +0 -148
  368. package/stacks/nextjs-supabase/.morph/templates/contracts.cs +0 -173
  369. package/stacks/nextjs-supabase/.morph/templates/contracts.ts +0 -168
  370. package/stacks/nextjs-supabase/.morph/templates/decisions.md +0 -115
  371. package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +0 -38
  372. package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +0 -48
  373. package/stacks/nextjs-supabase/.morph/templates/proposal.md +0 -145
  374. package/stacks/nextjs-supabase/.morph/templates/recap.md +0 -134
  375. package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +0 -57
  376. package/stacks/nextjs-supabase/.morph/templates/spec.md +0 -231
  377. package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +0 -100
  378. package/stacks/nextjs-supabase/.morph/templates/tasks.md +0 -257
  379. /package/src/commands/{search-patterns.js → learning/search-patterns.js} +0 -0
  380. /package/src/{lib → core/templates}/template-data-sources.js +0 -0
  381. /package/src/lib/{design-system-generator.js → generators/design-system-generator.js} +0 -0
  382. /package/src/lib/{learning-system.js → learning/learning-system.js} +0 -0
  383. /package/src/lib/validators/{package-validator.js → packages/package-validator.js} +0 -0
  384. /package/src/lib/validators/{ui-contrast-validator.js → ui/ui-contrast-validator.js} +0 -0
  385. /package/{src/generator → stacks/blazor-azure/.morph/templates}/.gitkeep +0 -0
  386. /package/{src/llm → stacks/nextjs-supabase/.morph/templates}/.gitkeep +0 -0
@@ -0,0 +1,436 @@
1
+ # MORPH-SPEC v3.0 - Architecture
2
+
3
+ > Architectural vision, domain reorganization, and complete integration map
4
+
5
+ **Status:** Design Complete ✅
6
+ **Last Updated:** 2026-02-18
7
+
8
+ ---
9
+
10
+ ## Table of Contents
11
+
12
+ - [Architectural Vision](#architectural-vision)
13
+ - [Domain Reorganization](#domain-reorganization)
14
+ - [Design Principles](#design-principles)
15
+ - [Integration Map](#integration-map)
16
+ - [Dependency Matrix](#dependency-matrix)
17
+
18
+ ---
19
+
20
+ ## Architectural Vision
21
+
22
+ ### North Star
23
+
24
+ Transform MORPH-SPEC from a sequential, single-threaded process into a **parallel, context-optimized, self-improving agentic platform** with 10-15x throughput, 30-40% token reduction, and 50% automation.
25
+
26
+ ### Three Pillars
27
+
28
+ ```
29
+ ┌─────────────────────────────────────────────────────────────┐
30
+ │ MORPH-SPEC v3.0 - Three Pillars │
31
+ └─────────────────────────────────────────────────────────────┘
32
+
33
+ 1️⃣ SCALE Through Parallelization
34
+ ├─ P-Thread: 3-5 agents working simultaneously
35
+ ├─ F-Thread: Best-of-N fusion for rapid prototyping
36
+ └─ Thread Manager: Orchestrate 10-15 parallel threads
37
+
38
+ 2️⃣ OPTIMIZE Through Context Engineering
39
+ ├─ Reduce: MCP hygiene, context priming (23K → 500 tokens)
40
+ ├─ Delegate: Sub-agents, background agents, micro-agents
41
+ └─ Analytics: Real-time token tracking, optimization suggestions
42
+
43
+ 3️⃣ IMPROVE Through Meta-Programming
44
+ ├─ Higher-Order Prompts (HOPs): Reusable prompt patterns
45
+ ├─ Thread Analytics: Data-driven agent selection
46
+ └─ Trust Levels: Auto-approve based on track record (Z-Thread)
47
+ ```
48
+
49
+ #### Pillar 1: SCALE Through Parallelization
50
+
51
+ **Goal:** Match Boris Churnney's workflow (10-15 parallel threads)
52
+
53
+ **Key Components:**
54
+ - Thread management system tracking concurrent execution
55
+ - P-Thread executor for parallel agent spawning
56
+ - F-Thread executor for fusion patterns (best-of-3)
57
+ - Thread coordinator managing dependencies
58
+
59
+ **Impact:**
60
+ - Throughput: 1 → 3-5 features/day (+200-400%)
61
+ - Tool calls: ~100 → ~250 per feature (+150%)
62
+
63
+ #### Pillar 2: OPTIMIZE Through Context Engineering
64
+
65
+ **Goal:** Reduce token usage by 30-40% via R&D Framework
66
+
67
+ **Key Components:**
68
+ - Context priming (CLAUDE.md: 23K → 500 tokens)
69
+ - Context bundles (session replay: 180K → 15K tokens)
70
+ - MCP hygiene (remove unused servers: -10K tokens)
71
+ - Micro-agents (ultra-specialized, 500 tokens context)
72
+
73
+ **Impact:**
74
+ - CLAUDE.md: -95% tokens
75
+ - Session replay: -92% tokens
76
+ - Response speed: 2-3x faster
77
+
78
+ #### Pillar 3: IMPROVE Through Meta-Programming
79
+
80
+ **Goal:** Enable data-driven decisions and automation
81
+
82
+ **Key Components:**
83
+ - 12+ Higher-Order Prompts (reusable patterns)
84
+ - Thread analytics dashboard (tool calls, duration, efficiency)
85
+ - Context analytics (real-time optimization suggestions)
86
+ - Trust levels (auto-approve based on track record)
87
+
88
+ **Impact:**
89
+ - Approval overhead: 100% manual → 50% auto
90
+ - Consistency: 100% agent spawns use validated templates
91
+
92
+ ---
93
+
94
+ ## Domain Reorganization
95
+
96
+ ### Current Problem ❌
97
+
98
+ Domains nested under stacks (blazor-azure, nextjs-supabase):
99
+ - DevX (CLI, workflows, templates) buried in details
100
+ - Cross-cutting concerns (security, observability) fragmented
101
+ - AI/agents treated as "backend" child
102
+
103
+ ### Solution: Tier 0 DevX + 9 Logical Domains ✅
104
+
105
+ ```
106
+ 🎯 Tier 0: DEVELOPER EXPERIENCE (Elevated - core of MORPH)
107
+ ├─ CLI Tools (morph-spec commands)
108
+ ├─ Workflows (fast-track, standard, full-morph, design-impl, ui-refresh)
109
+ ├─ Templates (66 Handlebars templates)
110
+ └─ Standards & Validation (48 standards, 5 validators)
111
+
112
+ 📱 Tier 1: APPLICATION LAYER
113
+ ├─ Frontend (Next.js, Blazor)
114
+ └─ Backend (.NET 10)
115
+
116
+ 🤖 Tier 1: AI & AGENT ORCHESTRATION (Elevated domain)
117
+ ├─ Microsoft Agent Framework
118
+ ├─ RAG Pipeline
119
+ └─ Prompt Engineering
120
+
121
+ 🗄️ Tier 1: DATA & PERSISTENCE (Unified)
122
+ ├─ Relational (EF Core, Azure SQL)
123
+ ├─ Vector/Search (Azure AI Search)
124
+ └─ NoSQL/Cache (Cosmos, Redis, Blob)
125
+
126
+ 🔐 Tier 1: SECURITY & IDENTITY (Cross-cutting)
127
+ ├─ Authentication (Passkeys, Clerk, Azure Identity)
128
+ ├─ Authorization (RBAC, Policy-based)
129
+ └─ Secrets Management (Key Vault)
130
+
131
+ 🔄 Tier 1: INTEGRATION & COMMUNICATION
132
+ ├─ APIs (REST, GraphQL, gRPC)
133
+ ├─ Event-Driven (Service Bus, CQRS, Event Sourcing)
134
+ ├─ Background Processing (Hangfire)
135
+ └─ External Services (Asaas, Resend)
136
+
137
+ ☁️ Tier 1: INFRASTRUCTURE & PLATFORM
138
+ ├─ Azure Cloud (Container Apps, SQL, Storage)
139
+ ├─ IaC (Bicep)
140
+ ├─ Containers (Docker)
141
+ └─ CI/CD (GitHub Actions)
142
+
143
+ 📊 Tier 1: OBSERVABILITY (NEW - 0% → 100%)
144
+ ├─ Monitoring (App Insights, Azure Monitor)
145
+ ├─ Logging (Serilog, Log Analytics)
146
+ ├─ Tracing (OpenTelemetry)
147
+ └─ Metrics (Custom metrics, Alerts)
148
+
149
+ 🧪 Tier 1: QUALITY ASSURANCE
150
+ ├─ Testing (xUnit, Moq, TestContainers, bUnit)
151
+ └─ Code Analysis (SOLID, Clean Code)
152
+
153
+ 🏗️ Tier 1: ARCHITECTURE & PATTERNS
154
+ ├─ Clean Architecture, Vertical Slice
155
+ ├─ CQRS, Repository, DDD
156
+ └─ SOLID Principles
157
+ ```
158
+
159
+ ### Changes from v2.x
160
+
161
+ | Change | Before | After | Impact |
162
+ |--------|--------|-------|--------|
163
+ | **DevX Position** | Buried in stack details | Tier 0 (top-level) | CLI/workflows/templates highlighted |
164
+ | **Observability** | Scattered (MAF, Azure) | Own domain (cross-cutting) | 0% → 100% coverage |
165
+ | **AI/Agents** | Child of Backend | Own domain (Tier 1) | Elevated importance |
166
+ | **Data** | Fragmented (EF, SQL, Vector) | Unified domain | Cohesive persistence layer |
167
+ | **Security** | Mixed with Integrations | Cross-cutting domain | Proper separation |
168
+ | **Event-Driven** | Missing | Added to Integration | Event architecture enabled |
169
+
170
+ ### Impact
171
+
172
+ - **16 agents → 26 agents** (+62%)
173
+ - **0% observability → 100%** (new observability-expert)
174
+ - **DevX elevated** to Tier 0
175
+ - **Cross-cutting concerns** properly separated
176
+
177
+ ---
178
+
179
+ ## Design Principles
180
+
181
+ ### 1. Integration Over Isolation
182
+
183
+ **Principle:** Every new component must connect to 3+ existing systems.
184
+
185
+ **Example:**
186
+ - Thread Manager connects to: state.json, agents.json, workflows/*.json, analytics-engine
187
+ - Context Optimizer connects to: standards/*.md, templates/REGISTRY.json, context-tracker, micro-agents
188
+ - Fusion Aggregator connects to: validators, analytics-engine, thread-manager, approval-gates
189
+
190
+ **Validation:** See [Dependency Matrix](#dependency-matrix) - every component lists 3+ connections.
191
+
192
+ ### 2. Common Themes First
193
+
194
+ **Principle:** If 3+ framework-comparison documents mention a feature → HIGH priority.
195
+
196
+ **High Priority (3+ mentions):**
197
+ - ✅ Parallelization (thread-based, 4-layer, context-engineering)
198
+ - ✅ Analytics (thread-based, context-engineering, 4-layer, agents-gaps)
199
+ - ✅ Context Optimization (context-engineering, 4-layer, thread-based)
200
+ - ✅ Meta-Programming (4-layer, thread-based, context-engineering)
201
+ - ✅ Agent Expansion (agents-gaps, framework-hierarchy, thread-based)
202
+
203
+ **Medium Priority (2 mentions):**
204
+ - Trust & Autonomy (thread-based, context-engineering)
205
+
206
+ ### 3. Backward Compatibility
207
+
208
+ **Principle:** Existing v2.x workflows/agents/templates continue to work.
209
+
210
+ **Implementation:**
211
+ - v2.x workflows (fast-track, standard, full-morph, design-impl, ui-refresh) → unchanged
212
+ - v3.0 adds 3 new workflows (fusion, long-running, zero-touch) → optional
213
+ - Migration tool: `morph-spec migrate v2-to-v3` (schema updates only)
214
+ - Rollback available: `morph-spec migrate rollback-to-v2`
215
+
216
+ ### 4. Measurable Impact
217
+
218
+ **Principle:** Every feature has quantifiable success metrics.
219
+
220
+ **Examples:**
221
+ - Thread Management: Tool calls per feature, duration, parallel efficiency
222
+ - Context Optimization: Token reduction %, response speed improvement
223
+ - Trust Levels: Auto-approval rate, checkpoint pass rate
224
+ - Analytics: Throughput (features/day), improvement trends
225
+
226
+ ### 5. No Loose Ends
227
+
228
+ **Principle:** Complete dependency graph, all systems interconnected.
229
+
230
+ **Validation:**
231
+ - 60+ features from 6 documents → All addressed ✅
232
+ - 15-step integration flow → Every step connects to next ✅
233
+ - Dependency matrix → Every component lists connections ✅
234
+
235
+ ---
236
+
237
+ ## Integration Map
238
+
239
+ ### Complete 16-Step Flow
240
+
241
+ ```
242
+ ┌──────────────────────────────────────────────────────────────┐
243
+ │ MORPH-SPEC v3.0 - Complete Integration Map │
244
+ └──────────────────────────────────────────────────────────────┘
245
+
246
+ USER REQUEST
247
+
248
+ [1] WORKFLOW DETECTOR
249
+ ├─ Analyzes: keywords, complexity, trust level
250
+ ├─ Connects to: workflows/*.json configs, state.json (trust history)
251
+ └─ Outputs: workflow type (fast-track/standard/full-morph/fusion/long-running/zero-touch)
252
+
253
+ [2] THREAD MANAGER
254
+ ├─ Creates thread(s) based on workflow
255
+ ├─ Connects to: state.json (thread tracking), agents.json (agent selection)
256
+ └─ Outputs: thread IDs, parallel coordination plan
257
+
258
+ [3] CONTEXT OPTIMIZER
259
+ ├─ Primes context based on feature type
260
+ ├─ Connects to: standards/*.md (selective loading), templates/REGISTRY.json
261
+ └─ Outputs: Primed context (500 tokens vs 23K)
262
+
263
+ [4] AGENT EXECUTOR
264
+ ├─ Spawns agents using HOPs
265
+ ├─ Connects to: meta-prompts/*.md (squad leaders, workers), agents.json (hierarchy)
266
+ └─ Outputs: Agent tasks
267
+
268
+ [5] PARALLEL EXECUTOR (if P-Thread)
269
+ ├─ Runs 3-5 agents simultaneously
270
+ ├─ Connects to: thread-manager (coordination), state.json (status tracking)
271
+ └─ Outputs: Parallel results
272
+
273
+ [6] FUSION AGGREGATOR (if F-Thread)
274
+ ├─ Scores N results, picks best
275
+ ├─ Connects to: validators (checkpoint scoring), analytics (quality metrics)
276
+ └─ Outputs: Winning design
277
+
278
+ [7] VALIDATORS (Tier 4)
279
+ ├─ Runs architecture, security, packages, design-system validators
280
+ ├─ Connects to: hooks/agent-teams/*.js (auto-triggered), state.json (checkpoint history)
281
+ └─ Outputs: Pass/fail + violations
282
+
283
+ [8] CHECKPOINTS
284
+ ├─ Every 3 tasks, runs full validation
285
+ ├─ Connects to: validators, artifact-trail (saves screenshots/logs), stop-hooks (if L-Thread)
286
+ └─ Outputs: Checkpoint pass/fail
287
+
288
+ [9] STOP HOOKS (if L-Thread)
289
+ ├─ Agent attempts to stop → validation runs
290
+ ├─ Connects to: validators, checkpoints, thread-manager (continue/complete)
291
+ └─ Outputs: Continue (with feedback) or Complete
292
+
293
+ [10] TRUST MANAGER
294
+ ├─ Tracks checkpoint pass rates
295
+ ├─ Connects to: state.json (trust history), approval gates (auto-approve if high trust)
296
+ └─ Outputs: Trust level (low/medium/high/maximum)
297
+
298
+ [11] APPROVAL GATES
299
+ ├─ Design gate, tasks gate
300
+ ├─ Connects to: trust-manager (auto-approve?), state.json (gate status)
301
+ └─ Outputs: Approved/rejected/auto-approved
302
+
303
+ [12] ANALYTICS ENGINE
304
+ ├─ Tracks tool calls, duration, parallel efficiency
305
+ ├─ Connects to: thread-manager, context-tracker, validators (pass rates)
306
+ └─ Outputs: Dashboards, recommendations
307
+
308
+ [13] CONTEXT TRACKER
309
+ ├─ Monitors token usage real-time
310
+ ├─ Connects to: context-optimizer (suggestions), analytics-engine (metrics)
311
+ └─ Outputs: Context analytics, optimization opportunities
312
+
313
+ [14] ARTIFACT TRAIL
314
+ ├─ Saves screenshots, intermediate files, agent reasoning
315
+ ├─ Connects to: checkpoints (triggered on fail), state.json (artifact paths)
316
+ └─ Outputs: Debugging trail
317
+
318
+ [15] LEARNING SYSTEM
319
+ ├─ Captures patterns (success/avoid/optimization)
320
+ ├─ Connects to: state.json (feature outcomes), standards/*.md (promoted patterns)
321
+ └─ Outputs: patterns-learned.md entries
322
+
323
+ [16] GIT HOOKS
324
+ ├─ Pre-commit, commit-msg, pre-push
325
+ ├─ Connects to: validators, orchestrator.sh, test suite
326
+ └─ Outputs: Commit allowed/blocked
327
+
328
+ OUTPUT: Feature Deliverables + Analytics + Artifacts
329
+ ```
330
+
331
+ ---
332
+
333
+ ## Dependency Matrix
334
+
335
+ Every new v3.0 component connects to 3+ existing systems:
336
+
337
+ | Component | Connects To (3+) | Purpose |
338
+ |-----------|------------------|---------|
339
+ | **Thread Manager** | state.json, agents.json, workflows/*.json, analytics-engine | Track concurrent execution, select agents |
340
+ | **Context Optimizer** | standards/*.md, templates/REGISTRY.json, context-tracker, micro-agents | Selective context loading, token reduction |
341
+ | **Parallel Executor** | thread-manager, state.json, agents.json, fusion-aggregator | Concurrent agent spawning, coordination |
342
+ | **Fusion Aggregator** | validators, analytics-engine, thread-manager, approval-gates | Score N designs, pick best |
343
+ | **Stop Hooks** | validators, checkpoints, thread-manager, artifact-trail | Autonomous validation loops |
344
+ | **Trust Manager** | state.json, checkpoints, approval-gates, analytics-engine | Track record, auto-approval |
345
+ | **Analytics Engine** | thread-manager, context-tracker, validators, state.json | Metrics collection, dashboards |
346
+ | **Context Tracker** | context-optimizer, analytics-engine, state.json, MCP-servers | Token usage monitoring |
347
+ | **Artifact Trail** | checkpoints, state.json, validators, thread-manager | Debugging screenshots, logs |
348
+ | **HOPs** | agents.json, templates/REGISTRY.json, standards/*.md, parallel-executor | Reusable prompt templates |
349
+
350
+ **Validation:** ✅ All components connect to 3+ systems → No isolation.
351
+
352
+ ---
353
+
354
+ ## State Schema Extensions
355
+
356
+ ### state.json v3.0 Schema
357
+
358
+ ```json
359
+ {
360
+ "$schema": "./templates/state.template.json",
361
+ "version": "3.0.0",
362
+
363
+ "threads": {
364
+ "{thread-id}": {
365
+ "id": "string",
366
+ "feature": "string",
367
+ "agent": "string",
368
+ "type": "base|parallel|fusion|long-running|zero-touch",
369
+ "status": "pending|running|completed|failed",
370
+ "startedAt": "ISO8601",
371
+ "completedAt": "ISO8601?",
372
+ "metrics": {
373
+ "toolCalls": "number",
374
+ "duration": "string",
375
+ "estimatedCompletion": "ISO8601?"
376
+ }
377
+ }
378
+ },
379
+
380
+ "features": {
381
+ "{feature-name}": {
382
+ "...existing fields...",
383
+
384
+ "threadMetrics": {
385
+ "totalToolCalls": "number",
386
+ "threadDuration": "string",
387
+ "maxParallelThreads": "number",
388
+ "avgParallelThreads": "number",
389
+ "checkpointPassRate": "number (0-1)"
390
+ },
391
+
392
+ "trustConfig": {
393
+ "level": "low|medium|high|maximum",
394
+ "autoApprove": {
395
+ "design": "boolean",
396
+ "tasks": "boolean"
397
+ },
398
+ "reason": "string",
399
+ "history": [
400
+ {
401
+ "feature": "string",
402
+ "checkpointPassRate": "number",
403
+ "timestamp": "ISO8601"
404
+ }
405
+ ]
406
+ },
407
+
408
+ "contextBundles": [
409
+ {
410
+ "bundleId": "string",
411
+ "checkpoint": "number",
412
+ "timestamp": "ISO8601",
413
+ "path": "string"
414
+ }
415
+ ]
416
+ }
417
+ }
418
+ }
419
+ ```
420
+
421
+ ---
422
+
423
+ ## Summary
424
+
425
+ MORPH-SPEC v3.0 architecture is designed around three core pillars (Scale, Optimize, Improve) with:
426
+
427
+ - **9 logical domains** (DevX to Tier 0, 100% coverage)
428
+ - **Complete integration** (16-step flow, every component connects to 3+)
429
+ - **5 design principles** (Integration, Common Themes, Backward Compat, Measurable, No Loose Ends)
430
+ - **Zero loose ends** (all 60+ features from 6 docs addressed)
431
+
432
+ Next: See [FEATURES.md](./FEATURES.md) for detailed feature descriptions.
433
+
434
+ ---
435
+
436
+ *MORPH-SPEC v3.0 Architecture - by Polymorphism Tech*
@@ -0,0 +1,267 @@
1
+ # Context Optimization — MORPH-SPEC v3.0
2
+
3
+ Context optimization is the practice of maximizing what useful work fits in the AI model's context window. v3.0 introduces structured techniques to reduce token waste and increase implementation quality per session.
4
+
5
+ ---
6
+
7
+ ## The Context Budget Problem
8
+
9
+ Claude's context window has a hard limit. A typical morph-next-gen feature session consumes:
10
+
11
+ | Component | Tokens (approx) |
12
+ |-----------|----------------|
13
+ | CLAUDE.md (full) | ~23,000 |
14
+ | spec.md (large) | ~8,000 |
15
+ | tasks.json | ~3,000 |
16
+ | Standards (3 files) | ~6,000 |
17
+ | Conversation history | Grows per turn |
18
+ | **Total overhead** | **~40,000+** |
19
+
20
+ Without optimization, implementation tokens are crowded out by reference material.
21
+
22
+ ---
23
+
24
+ ## 12 Optimization Techniques
25
+
26
+ ### 1. Context Priming (Biggest Win: ~80% reduction)
27
+
28
+ Instead of loading full CLAUDE.md, use a priming file (500 tokens vs 23,000):
29
+
30
+ ```bash
31
+ # Output a focused priming file for your current task type
32
+ morph-spec prime feature
33
+ morph-spec prime bug
34
+ morph-spec prime refactor
35
+ morph-spec prime design
36
+ morph-spec prime infra
37
+ ```
38
+
39
+ Each prime file contains only the essential rules for that task type. Paste the output at the start of your session.
40
+
41
+ **Priming file locations:** `framework/templates/prime/{type}.md`
42
+
43
+ ### 2. Context Bundles
44
+
45
+ Pre-compress feature context from ~180K tokens to ~15K:
46
+
47
+ ```bash
48
+ # Create a bundle (compress all outputs for a feature)
49
+ morph-spec context bundle create user-auth
50
+
51
+ # Load a bundle at session start
52
+ morph-spec context bundle load user-auth
53
+
54
+ # List available bundles
55
+ morph-spec context bundle list
56
+ ```
57
+
58
+ Bundle structure:
59
+
60
+ ```json
61
+ {
62
+ "id": "bundle-user-auth-2026-02",
63
+ "feature": "user-auth",
64
+ "created": "2026-02-19T10:00:00Z",
65
+ "tokenCount": 14800,
66
+ "includes": ["spec-summary", "decisions-summary", "task-list", "key-standards"],
67
+ "compressed": true
68
+ }
69
+ ```
70
+
71
+ ### 3. Selective Standards Loading
72
+
73
+ Don't load all standards — load only what's relevant to the current task:
74
+
75
+ ```bash
76
+ # Bad: loads everything
77
+ # cat framework/standards/*.md
78
+
79
+ # Good: load only relevant standards
80
+ morph-spec prime feature | head -20
81
+ # Then manually load: coding.md, and ONE domain standard
82
+ ```
83
+
84
+ Standards priority for implementation tasks:
85
+ 1. `coding.md` — always load
86
+ 2. Domain standard (e.g., `supabase-rls.md` if working on auth)
87
+ 3. Skip everything else
88
+
89
+ ### 4. Micro-Agents for Narrow Tasks
90
+
91
+ Create ultra-specialized agents with minimal context (1-3 standards, narrow mission):
92
+
93
+ ```bash
94
+ morph-spec micro-agent create rls-writer \
95
+ --base-agent supabase-expert \
96
+ --mission "Write RLS policies only" \
97
+ --standards supabase-rls.md \
98
+ --tools Read,Write
99
+
100
+ morph-spec micro-agent show rls-writer --show-prompt
101
+ ```
102
+
103
+ Micro-agents have 90%+ fewer tokens than full agents.
104
+
105
+ ### 5. MCP Server Hygiene
106
+
107
+ Unnecessary MCP servers consume tokens via tool definitions:
108
+
109
+ ```bash
110
+ # Analyze current MCP overhead
111
+ morph-spec mcp optimize
112
+
113
+ # List configured servers with usage stats
114
+ morph-spec mcp list
115
+ ```
116
+
117
+ Disable MCP servers not used in current task via `.claude/settings.local.json`.
118
+
119
+ ### 6. Checkpoint Summaries Instead of Full History
120
+
121
+ At each checkpoint, generate a compact summary instead of keeping full conversation:
122
+
123
+ ```bash
124
+ morph-spec session-summary user-auth
125
+ ```
126
+
127
+ This produces a ~500-token summary replacing thousands of tokens of history.
128
+
129
+ ### 7. Core Four Dashboard
130
+
131
+ Before starting a session, check the Core Four to identify context wastage:
132
+
133
+ ```bash
134
+ morph-spec core-four user-auth
135
+ ```
136
+
137
+ Output shows: Context efficiency %, active model, prompt quality score, tool count.
138
+
139
+ **Context efficiency** = (useful tokens) / (total tokens). Target: >70%.
140
+
141
+ ### 8. Thread-Based Context Isolation
142
+
143
+ Each parallel thread (P-Thread) gets a clean context window. Instead of one massive session, split into 3 parallel sessions:
144
+
145
+ ```bash
146
+ morph-spec parallel plan user-auth
147
+ # Output: 3 squads × ~20K tokens each = 60K total but 20K per session
148
+ ```
149
+
150
+ vs. single session with 60K+ tokens of context.
151
+
152
+ ### 9. Artifact Trail
153
+
154
+ Track what was produced to avoid re-reading files:
155
+
156
+ ```bash
157
+ # The artifact-trail.js lib tracks: file path, producer agent, timestamp, token cost
158
+ # Access via:
159
+ morph-spec analytics feature user-auth
160
+ ```
161
+
162
+ This shows which files were produced and their approximate token cost.
163
+
164
+ ### 10. Output-First Prompting
165
+
166
+ In your prompts to agents, always list expected outputs first:
167
+
168
+ ```markdown
169
+ ## Your Deliverables (produce these files):
170
+ 1. Services/UserService.cs
171
+ 2. DTOs/LoginRequest.cs
172
+
173
+ ## Then implement following these specs...
174
+ ```
175
+
176
+ This front-loads the goal, keeping the model focused and reducing verbose exploration.
177
+
178
+ ### 11. Incremental Spec Loading
179
+
180
+ Don't load the full spec at once. Load sections on demand:
181
+
182
+ ```markdown
183
+ # Load only the section relevant to current task
184
+ ## API Contracts (relevant to T003)
185
+ POST /api/auth/login
186
+ Request: { email, password }
187
+ Response: { token, refreshToken }
188
+ ```
189
+
190
+ ### 12. Session Handoffs
191
+
192
+ When approaching context limit, generate a handoff document:
193
+
194
+ ```bash
195
+ morph-spec generate recap user-auth
196
+ ```
197
+
198
+ The recap captures: progress %, tasks completed, decisions made, next steps. Start a new session with just the recap (~1,000 tokens).
199
+
200
+ ---
201
+
202
+ ## Context Analytics
203
+
204
+ Monitor context efficiency over time:
205
+
206
+ ```bash
207
+ # Feature-level analytics
208
+ morph-spec analytics context user-auth
209
+
210
+ # Project-level (30-day)
211
+ morph-spec analytics project
212
+ ```
213
+
214
+ Analytics track:
215
+ - Context efficiency score (0-100%)
216
+ - Token usage by phase
217
+ - Optimization opportunities detected
218
+
219
+ **Optimization triggers** (auto-detected):
220
+ - Efficiency < 60% → Recommend priming
221
+ - Session > 50K tokens → Recommend bundle
222
+ - Standards loaded > 5 → Recommend selective loading
223
+ - MCP servers > 3 active → Recommend MCP hygiene
224
+
225
+ ---
226
+
227
+ ## Context Bundle Format
228
+
229
+ ```json
230
+ {
231
+ "id": "bundle-{feature}-{date}",
232
+ "feature": "user-auth",
233
+ "created": "2026-02-19T10:00:00Z",
234
+ "tokenCount": 14800,
235
+ "sections": {
236
+ "specSummary": "...",
237
+ "keyDecisions": ["ADR-001: JWT over sessions", "ADR-002: BCrypt for hashing"],
238
+ "taskProgress": "8/12 completed (67%)",
239
+ "standards": ["coding.md summary", "supabase-auth.md summary"],
240
+ "nextTasks": ["T009", "T010", "T011"]
241
+ }
242
+ }
243
+ ```
244
+
245
+ Store bundles at: `.morph/project/bundles/{feature}/`
246
+
247
+ ---
248
+
249
+ ## Quick Reference
250
+
251
+ | Technique | Token Savings | When to Use |
252
+ |-----------|--------------|-------------|
253
+ | Context Priming | ~80% | Always — start of every session |
254
+ | Context Bundles | ~70% | Features with large outputs |
255
+ | Selective Standards | ~50% | Implementation phases |
256
+ | Micro-Agents | ~90% | Narrow, repetitive tasks |
257
+ | MCP Hygiene | ~10-20% | When >3 MCP servers active |
258
+ | Thread Isolation | Resets per thread | Multi-domain features |
259
+ | Session Handoffs | Resets context | Long-running features |
260
+
261
+ ---
262
+
263
+ ## Related
264
+
265
+ - [Thread Management](THREAD-MANAGEMENT.md) — Thread isolation for context efficiency
266
+ - [Meta-Prompts](META-PROMPTS.md) — HOP templates for structured agent prompting
267
+ - [Migration Guide](MIGRATION-GUIDE.md) — Upgrading to v3.0 context features