@polymorphism-tech/morph-spec 4.3.3 → 4.3.5

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 (488) hide show
  1. package/.morph/.morphversion +5 -0
  2. package/.morph/analytics/threads-log.jsonl +9 -0
  3. package/{stacks/blazor-azure/.morph → .morph}/config/agents.json +948 -948
  4. package/.morph/config/config.json +9 -0
  5. package/{stacks/blazor-azure/.morph → .morph}/project/context/README.md +1 -1
  6. package/.morph/project/context/detection-log.md +16 -0
  7. package/.morph/project/standards/inferred.md +59 -0
  8. package/.morph/state.json +48 -0
  9. package/.morph/templates/.idea/morph-templates.xml +92 -0
  10. package/.morph/templates/.vscode/morph-templates.code-snippets +186 -0
  11. package/.morph/templates/IDE-SNIPPETS.md +266 -0
  12. package/.morph/templates/README.md +814 -0
  13. package/.morph/templates/REGISTRY.json +1677 -0
  14. package/.morph/templates/code/dotnet/backend/repository.cs +141 -0
  15. package/.morph/templates/code/dotnet/backend/service.cs +139 -0
  16. package/.morph/templates/code/dotnet/contracts/Commands.cs +74 -0
  17. package/.morph/templates/code/dotnet/contracts/Entities.cs +25 -0
  18. package/.morph/templates/code/dotnet/contracts/Queries.cs +74 -0
  19. package/.morph/templates/code/dotnet/contracts/README.md +74 -0
  20. package/.morph/templates/code/dotnet/contracts/api-contracts.cs +173 -0
  21. package/.morph/templates/code/dotnet/contracts/contracts.cs +217 -0
  22. package/.morph/templates/code/dotnet/database/migration.cs +83 -0
  23. package/.morph/templates/code/dotnet/frontend/component.razor +239 -0
  24. package/.morph/templates/code/dotnet/jobs/agent.cs +163 -0
  25. package/.morph/templates/code/dotnet/jobs/job.cs +171 -0
  26. package/.morph/templates/code/dotnet/test.cs +239 -0
  27. package/.morph/templates/code/sql/rls-policy.sql +57 -0
  28. package/.morph/templates/code/sql/supabase-migration.sql +100 -0
  29. package/.morph/templates/code/sql/supabase-migration.template.sql +113 -0
  30. package/.morph/templates/code/typescript/contracts.ts +168 -0
  31. package/.morph/templates/context/CONTEXT-FEATURE.md +276 -0
  32. package/.morph/templates/context/CONTEXT.md +181 -0
  33. package/.morph/templates/docs/proposal.md +182 -0
  34. package/.morph/templates/docs/spec.md +149 -0
  35. package/.morph/templates/examples/design-system-examples.md +357 -0
  36. package/.morph/templates/examples/spec-examples.md +90 -0
  37. package/.morph/templates/feature/decisions.md +187 -0
  38. package/.morph/templates/feature/recap.md +146 -0
  39. package/.morph/templates/feature/tasks.md +199 -0
  40. package/.morph/templates/infrastructure/azure/Dockerfile.example +82 -0
  41. package/.morph/templates/infrastructure/azure/README.md +286 -0
  42. package/.morph/templates/infrastructure/azure/app-insights.bicep +63 -0
  43. package/.morph/templates/infrastructure/azure/app-service.bicep +164 -0
  44. package/.morph/templates/infrastructure/azure/container-app-env.bicep +49 -0
  45. package/.morph/templates/infrastructure/azure/container-app.bicep +156 -0
  46. package/.morph/templates/infrastructure/azure/deploy-checklist.md +426 -0
  47. package/.morph/templates/infrastructure/azure/deploy.ps1 +229 -0
  48. package/.morph/templates/infrastructure/azure/deploy.sh +208 -0
  49. package/.morph/templates/infrastructure/azure/key-vault.bicep +91 -0
  50. package/.morph/templates/infrastructure/azure/main.bicep +189 -0
  51. package/.morph/templates/infrastructure/azure/parameters.dev.json +29 -0
  52. package/.morph/templates/infrastructure/azure/parameters.prod.json +29 -0
  53. package/.morph/templates/infrastructure/azure/parameters.staging.json +29 -0
  54. package/.morph/templates/infrastructure/azure/sql-database.bicep +103 -0
  55. package/.morph/templates/infrastructure/azure/storage.bicep +106 -0
  56. package/.morph/templates/infrastructure/docker/Dockerfile.template +58 -0
  57. package/.morph/templates/infrastructure/docker/docker-compose.template.yml +67 -0
  58. package/.morph/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -0
  59. package/.morph/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -0
  60. package/.morph/templates/infrastructure/docker/easypanel.template.json +54 -0
  61. package/.morph/templates/infrastructure/github/README.md +593 -0
  62. package/.morph/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +22 -0
  63. package/.morph/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -0
  64. package/.morph/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -0
  65. package/.morph/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +61 -0
  66. package/.morph/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +31 -0
  67. package/.morph/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -0
  68. package/.morph/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -0
  69. package/.morph/templates/integrations/asaas-client.cs +387 -0
  70. package/.morph/templates/integrations/asaas-webhook.cs +351 -0
  71. package/.morph/templates/integrations/azure-identity-config.cs +288 -0
  72. package/.morph/templates/integrations/clerk-config.cs +258 -0
  73. package/.morph/templates/meta-prompts/fusion/fusion-agent.md +76 -0
  74. package/.morph/templates/meta-prompts/fusion/fusion-aggregator.md +100 -0
  75. package/.morph/templates/meta-prompts/hops/hop-retry.md +78 -0
  76. package/.morph/templates/meta-prompts/hops/hop-validation.md +97 -0
  77. package/.morph/templates/meta-prompts/hops/hop-wrapper.md +36 -0
  78. package/.morph/templates/meta-prompts/parallel-workers/parallel-coordinator.md +113 -0
  79. package/.morph/templates/meta-prompts/parallel-workers/parallel-worker.md +80 -0
  80. package/.morph/templates/meta-prompts/squad-leaders/backend-squad.md +90 -0
  81. package/.morph/templates/meta-prompts/squad-leaders/frontend-squad.md +126 -0
  82. package/.morph/templates/meta-prompts/squad-leaders/squad-leader.md +43 -0
  83. package/.morph/templates/meta-prompts/validators/checkpoint-validator.md +107 -0
  84. package/.morph/templates/meta-prompts/validators/pre-commit-validator.md +95 -0
  85. package/.morph/templates/saas/subscription.cs +347 -0
  86. package/.morph/templates/saas/tenant.cs +338 -0
  87. package/.morph/templates/state.template.json +17 -0
  88. package/.morph/templates/ui/FluentDesignTheme.cs +149 -0
  89. package/.morph/templates/ui/MudTheme.cs +281 -0
  90. package/.morph/templates/ui/design-system.css +226 -0
  91. package/bin/detect-agents.js +1 -2
  92. package/bin/morph-spec.js +1 -14
  93. package/framework/agents.json +948 -0
  94. package/{stacks/nextjs-supabase/.claude → framework}/commands/morph-infra.md +1 -1
  95. package/framework/hooks/README.md +282 -0
  96. package/framework/hooks/agent-stop/validate-and-continue.js +96 -0
  97. package/framework/hooks/agent-stop/validate-checkpoints.js +101 -0
  98. package/framework/hooks/agent-stop/validate-tests.js +109 -0
  99. package/framework/hooks/agent-teams/dispatch.js +67 -0
  100. package/framework/hooks/agent-teams/phase-advanced.js +80 -0
  101. package/framework/hooks/agent-teams/task-completed.js +76 -0
  102. package/framework/hooks/agent-teams/teammate-idle.js +70 -0
  103. package/framework/hooks/commit-msg/conventional-commits.sh +33 -0
  104. package/framework/hooks/pre-commit/agents.sh +25 -0
  105. package/framework/hooks/pre-commit/orchestrator.sh +64 -0
  106. package/framework/hooks/pre-commit/specs.sh +50 -0
  107. package/framework/hooks/pre-push/run-tests.sh +44 -0
  108. package/framework/index/troubleshooting-index.json +184 -0
  109. package/framework/memory/patterns-learned.md +766 -0
  110. package/framework/skills/level-0-meta/README.md +7 -0
  111. package/framework/skills/level-0-meta/code-review.md +226 -0
  112. package/framework/skills/level-0-meta/morph-checklist.md +117 -0
  113. package/framework/skills/level-0-meta/simulation-checklist.md +77 -0
  114. package/framework/skills/level-1-workflows/README.md +7 -0
  115. package/framework/skills/level-1-workflows/morph-replicate.md +213 -0
  116. package/framework/skills/level-1-workflows/phase-clarify.md +131 -0
  117. package/framework/skills/level-1-workflows/phase-design.md +213 -0
  118. package/framework/skills/level-1-workflows/phase-setup.md +106 -0
  119. package/framework/skills/level-1-workflows/phase-tasks.md +164 -0
  120. package/framework/skills/level-1-workflows/phase-uiux.md +169 -0
  121. package/framework/skills/level-2-domains/README.md +14 -0
  122. package/framework/skills/level-2-domains/ai-agents/ai-system-architect.md +192 -0
  123. package/framework/skills/level-2-domains/architecture/po-pm-advisor.md +197 -0
  124. package/framework/skills/level-2-domains/architecture/prompt-engineer.md +189 -0
  125. package/framework/skills/level-2-domains/architecture/seo-growth-hacker.md +320 -0
  126. package/framework/skills/level-2-domains/architecture/standards-architect.md +156 -0
  127. package/framework/skills/level-2-domains/backend/api-designer.md +59 -0
  128. package/framework/skills/level-2-domains/backend/dotnet-senior.md +77 -0
  129. package/framework/skills/level-2-domains/backend/ef-modeler.md +58 -0
  130. package/framework/skills/level-2-domains/backend/hangfire-orchestrator.md +126 -0
  131. package/framework/skills/level-2-domains/backend/ms-agent-expert.md +45 -0
  132. package/framework/skills/level-2-domains/frontend/blazor-builder.md +210 -0
  133. package/framework/skills/level-2-domains/frontend/nextjs-expert.md +154 -0
  134. package/framework/skills/level-2-domains/frontend/ui-ux-designer.md +191 -0
  135. package/framework/skills/level-2-domains/infrastructure/azure-architect.md +142 -0
  136. package/framework/skills/level-2-domains/infrastructure/azure-deploy-specialist.md +699 -0
  137. package/framework/skills/level-2-domains/infrastructure/bicep-architect.md +126 -0
  138. package/framework/skills/level-2-domains/infrastructure/container-specialist.md +131 -0
  139. package/framework/skills/level-2-domains/infrastructure/devops-engineer.md +119 -0
  140. package/framework/skills/level-2-domains/integrations/asaas-financial.md +130 -0
  141. package/framework/skills/level-2-domains/integrations/azure-identity.md +142 -0
  142. package/framework/skills/level-2-domains/integrations/clerk-auth.md +108 -0
  143. package/framework/skills/level-2-domains/integrations/hangfire-orchestrator.md +64 -0
  144. package/framework/skills/level-2-domains/integrations/resend-email.md +119 -0
  145. package/framework/skills/level-2-domains/quality/code-analyzer.md +235 -0
  146. package/framework/skills/level-2-domains/quality/testing-specialist.md +126 -0
  147. package/framework/skills/level-3-technologies/README.md +7 -0
  148. package/framework/skills/level-4-patterns/README.md +7 -0
  149. package/framework/squad-templates/backend-only.json +34 -0
  150. package/framework/squad-templates/frontend-only.json +34 -0
  151. package/framework/squad-templates/full-stack.json +52 -0
  152. package/framework/templates/.idea/morph-templates.xml +92 -0
  153. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  154. package/framework/templates/IDE-SNIPPETS.md +266 -0
  155. package/framework/templates/README.md +814 -0
  156. package/framework/templates/REGISTRY.json +1677 -0
  157. package/framework/templates/code/dotnet/backend/repository.cs +141 -0
  158. package/framework/templates/code/dotnet/backend/service.cs +139 -0
  159. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -0
  160. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -0
  161. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -0
  162. package/framework/templates/code/dotnet/contracts/README.md +74 -0
  163. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -0
  164. package/framework/templates/code/dotnet/contracts/contracts.cs +217 -0
  165. package/framework/templates/code/dotnet/database/migration.cs +83 -0
  166. package/framework/templates/code/dotnet/frontend/component.razor +239 -0
  167. package/framework/templates/code/dotnet/jobs/agent.cs +163 -0
  168. package/framework/templates/code/dotnet/jobs/job.cs +171 -0
  169. package/framework/templates/code/dotnet/test.cs +239 -0
  170. package/framework/templates/code/sql/rls-policy.sql +57 -0
  171. package/framework/templates/code/sql/supabase-migration.sql +100 -0
  172. package/framework/templates/code/sql/supabase-migration.template.sql +113 -0
  173. package/framework/templates/code/typescript/contracts.ts +168 -0
  174. package/framework/templates/context/CONTEXT-FEATURE.md +276 -0
  175. package/framework/templates/context/CONTEXT.md +181 -0
  176. package/framework/templates/docs/proposal.md +182 -0
  177. package/framework/templates/docs/spec.md +149 -0
  178. package/framework/templates/examples/design-system-examples.md +357 -0
  179. package/framework/templates/examples/spec-examples.md +90 -0
  180. package/framework/templates/feature/decisions.md +187 -0
  181. package/framework/templates/feature/recap.md +146 -0
  182. package/framework/templates/feature/tasks.md +199 -0
  183. package/framework/templates/infrastructure/azure/Dockerfile.example +82 -0
  184. package/framework/templates/infrastructure/azure/README.md +286 -0
  185. package/framework/templates/infrastructure/azure/app-insights.bicep +63 -0
  186. package/framework/templates/infrastructure/azure/app-service.bicep +164 -0
  187. package/framework/templates/infrastructure/azure/container-app-env.bicep +49 -0
  188. package/framework/templates/infrastructure/azure/container-app.bicep +156 -0
  189. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -0
  190. package/framework/templates/infrastructure/azure/deploy.ps1 +229 -0
  191. package/framework/templates/infrastructure/azure/deploy.sh +208 -0
  192. package/framework/templates/infrastructure/azure/key-vault.bicep +91 -0
  193. package/framework/templates/infrastructure/azure/main.bicep +189 -0
  194. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -0
  195. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -0
  196. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -0
  197. package/framework/templates/infrastructure/azure/sql-database.bicep +103 -0
  198. package/framework/templates/infrastructure/azure/storage.bicep +106 -0
  199. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -0
  200. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -0
  201. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -0
  202. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -0
  203. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -0
  204. package/framework/templates/infrastructure/github/README.md +593 -0
  205. package/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +22 -0
  206. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -0
  207. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -0
  208. package/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +61 -0
  209. package/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +31 -0
  210. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -0
  211. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -0
  212. package/framework/templates/integrations/asaas-client.cs +387 -0
  213. package/framework/templates/integrations/asaas-webhook.cs +351 -0
  214. package/framework/templates/integrations/azure-identity-config.cs +288 -0
  215. package/framework/templates/integrations/clerk-config.cs +258 -0
  216. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -0
  217. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -0
  218. package/framework/templates/meta-prompts/hops/hop-retry.md +78 -0
  219. package/framework/templates/meta-prompts/hops/hop-validation.md +97 -0
  220. package/framework/templates/meta-prompts/hops/hop-wrapper.md +36 -0
  221. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +113 -0
  222. package/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +80 -0
  223. package/framework/templates/meta-prompts/squad-leaders/backend-squad.md +90 -0
  224. package/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +126 -0
  225. package/framework/templates/meta-prompts/squad-leaders/squad-leader.md +43 -0
  226. package/framework/templates/meta-prompts/validators/checkpoint-validator.md +107 -0
  227. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -0
  228. package/framework/templates/saas/subscription.cs +347 -0
  229. package/framework/templates/saas/tenant.cs +338 -0
  230. package/framework/templates/state.template.json +17 -0
  231. package/framework/templates/ui/FluentDesignTheme.cs +149 -0
  232. package/framework/templates/ui/MudTheme.cs +281 -0
  233. package/framework/templates/ui/design-system.css +226 -0
  234. package/framework/workflows/README.md +1041 -0
  235. package/framework/workflows/configs/design-impl.json +49 -0
  236. package/framework/workflows/configs/fast-track.json +42 -0
  237. package/framework/workflows/configs/full-morph.json +79 -0
  238. package/framework/workflows/configs/fusion.json +39 -0
  239. package/framework/workflows/configs/long-running.json +33 -0
  240. package/framework/workflows/configs/standard.json +60 -0
  241. package/framework/workflows/configs/ui-refresh.json +49 -0
  242. package/framework/workflows/configs/zero-touch.json +75 -0
  243. package/framework/workflows/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -0
  244. package/framework/workflows/docs/design-impl.md +37 -0
  245. package/framework/workflows/docs/enforcement-pipeline.md +668 -0
  246. package/framework/workflows/docs/fast-track.md +29 -0
  247. package/framework/workflows/docs/full-morph.md +76 -0
  248. package/framework/workflows/docs/standard.md +44 -0
  249. package/framework/workflows/docs/ui-refresh.md +39 -0
  250. package/package.json +3 -3
  251. package/src/commands/feature/create-story.js +11 -7
  252. package/src/commands/project/detect-agents.js +1 -2
  253. package/src/commands/project/init.js +69 -32
  254. package/src/commands/project/update.js +102 -15
  255. package/src/commands/templates/template-customize.js +3 -17
  256. package/src/commands/templates/template-list.js +1 -15
  257. package/src/commands/templates/template-render.js +2 -3
  258. package/src/commands/templates/template-show.js +3 -5
  259. package/src/core/templates/template-registry.js +9 -23
  260. package/src/lib/detectors/structure-detector.js +3 -3
  261. package/src/lib/generators/context-generator.js +18 -6
  262. package/src/lib/hooks/hook-executor.js +0 -2
  263. package/src/lib/orchestration/team-orchestrator.js +1 -2
  264. package/src/lib/standards/standards-context-injector.js +3 -4
  265. package/src/lib/troubleshooting/troubleshoot-grep.js +3 -9
  266. package/src/lib/validators/validation-runner.js +1 -2
  267. package/src/utils/file-copier.js +1 -2
  268. package/docs/README.md +0 -144
  269. package/docs/api/fonts/Montserrat/Montserrat-Bold.eot +0 -0
  270. package/docs/api/fonts/Montserrat/Montserrat-Bold.ttf +0 -0
  271. package/docs/api/fonts/Montserrat/Montserrat-Bold.woff +0 -0
  272. package/docs/api/fonts/Montserrat/Montserrat-Bold.woff2 +0 -0
  273. package/docs/api/fonts/Montserrat/Montserrat-Regular.eot +0 -0
  274. package/docs/api/fonts/Montserrat/Montserrat-Regular.ttf +0 -0
  275. package/docs/api/fonts/Montserrat/Montserrat-Regular.woff +0 -0
  276. package/docs/api/fonts/Montserrat/Montserrat-Regular.woff2 +0 -0
  277. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.eot +0 -0
  278. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +0 -978
  279. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.ttf +0 -0
  280. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff +0 -0
  281. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.woff2 +0 -0
  282. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.eot +0 -0
  283. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +0 -1049
  284. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.ttf +0 -0
  285. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff +0 -0
  286. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.woff2 +0 -0
  287. package/docs/api/scripts/collapse.js +0 -39
  288. package/docs/api/scripts/commonNav.js +0 -28
  289. package/docs/api/scripts/linenumber.js +0 -25
  290. package/docs/api/scripts/nav.js +0 -12
  291. package/docs/api/scripts/polyfill.js +0 -4
  292. package/docs/api/scripts/prettify/Apache-License-2.0.txt +0 -202
  293. package/docs/api/scripts/prettify/lang-css.js +0 -2
  294. package/docs/api/scripts/prettify/prettify.js +0 -28
  295. package/docs/api/scripts/search.js +0 -99
  296. package/docs/api/styles/jsdoc.css +0 -776
  297. package/docs/api/styles/prettify.css +0 -80
  298. package/docs/cli-auto-detection.md +0 -219
  299. package/docs/getting-started.md +0 -296
  300. package/docs/installation.md +0 -361
  301. package/docs/next-generation/AGENTS.md +0 -521
  302. package/docs/next-generation/ANALYSIS.md +0 -555
  303. package/docs/next-generation/ARCHITECTURE.md +0 -436
  304. package/docs/next-generation/CONTEXT-OPTIMIZATION.md +0 -267
  305. package/docs/next-generation/EXECUTION-FLOW.md +0 -274
  306. package/docs/next-generation/FEATURES.md +0 -688
  307. package/docs/next-generation/META-PROMPTS.md +0 -235
  308. package/docs/next-generation/MIGRATION-GUIDE.md +0 -253
  309. package/docs/next-generation/README.md +0 -231
  310. package/docs/next-generation/ROADMAP.md +0 -801
  311. package/docs/next-generation/THREAD-MANAGEMENT.md +0 -240
  312. package/docs/templates.md +0 -418
  313. package/docs/troubleshooting.md +0 -269
  314. package/docs/validation-checklist.md +0 -264
  315. package/scripts/postinstall.js +0 -132
  316. package/src/lib/stacks/index.js +0 -7
  317. package/src/lib/stacks/stack-resolver.js +0 -180
  318. package/stacks/blazor-azure/.claude/commands/morph-deploy.md +0 -529
  319. package/stacks/blazor-azure/.claude/commands/morph-infra.md +0 -209
  320. package/stacks/blazor-azure/.morph/.morphversion +0 -5
  321. package/stacks/blazor-azure/.morph/config/config.json +0 -9
  322. package/stacks/blazor-azure/CLAUDE.md +0 -155
  323. package/stacks/blazor-azure/README.md +0 -79
  324. package/stacks/nextjs-supabase/.claude/commands/morph-apply.md +0 -221
  325. package/stacks/nextjs-supabase/.claude/commands/morph-archive.md +0 -79
  326. package/stacks/nextjs-supabase/.claude/commands/morph-deploy.md +0 -529
  327. package/stacks/nextjs-supabase/.claude/commands/morph-preflight.md +0 -227
  328. package/stacks/nextjs-supabase/.claude/commands/morph-proposal.md +0 -122
  329. package/stacks/nextjs-supabase/.claude/commands/morph-status.md +0 -86
  330. package/stacks/nextjs-supabase/.claude/commands/morph-troubleshoot.md +0 -122
  331. package/stacks/nextjs-supabase/.morph/.morphversion +0 -5
  332. package/stacks/nextjs-supabase/.morph/config/agents.json +0 -345
  333. package/stacks/nextjs-supabase/.morph/config/config.json +0 -9
  334. package/stacks/nextjs-supabase/.morph/project/context/README.md +0 -17
  335. package/stacks/nextjs-supabase/CLAUDE.md +0 -155
  336. package/stacks/nextjs-supabase/README.md +0 -103
  337. /package/{stacks/blazor-azure/.morph → .morph}/standards/ai-agents/blazor-ui.md +0 -0
  338. /package/{stacks/blazor-azure/.morph → .morph}/standards/ai-agents/production.md +0 -0
  339. /package/{stacks/blazor-azure/.morph → .morph}/standards/ai-agents/setup.md +0 -0
  340. /package/{stacks/blazor-azure/.morph → .morph}/standards/ai-agents/team-orchestration.md +0 -0
  341. /package/{stacks/blazor-azure/.morph → .morph}/standards/ai-agents/workflows.md +0 -0
  342. /package/{stacks/blazor-azure/.morph → .morph}/standards/architecture/ddd/aggregates.md +0 -0
  343. /package/{stacks/blazor-azure/.morph → .morph}/standards/architecture/ddd/entities.md +0 -0
  344. /package/{stacks/blazor-azure/.morph → .morph}/standards/architecture/ddd/value-objects.md +0 -0
  345. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/api/minimal-api.md +0 -0
  346. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/api/rest.md +0 -0
  347. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/api/validation.md +0 -0
  348. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/authentication/passkeys.md +0 -0
  349. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/database/ef-core.md +0 -0
  350. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/database/migrations.md +0 -0
  351. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/database/postgresql/database.md +0 -0
  352. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/database/repository-patterns.md +0 -0
  353. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/database/vector-search-rag.md +0 -0
  354. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/dotnet/async.md +0 -0
  355. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/dotnet/core.md +0 -0
  356. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/dotnet/di.md +0 -0
  357. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/dotnet/program-cs-checklist.md +0 -0
  358. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/integrations/asaas/asaas-api.md +0 -0
  359. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/integrations/clerk/clerk-auth.md +0 -0
  360. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -0
  361. /package/{stacks/blazor-azure/.morph → .morph}/standards/backend/integrations/resend/resend-email.md +0 -0
  362. /package/{stacks/blazor-azure/.morph → .morph}/standards/context/analytics.md +0 -0
  363. /package/{stacks/blazor-azure/.morph → .morph}/standards/context/bundles.md +0 -0
  364. /package/{stacks/blazor-azure/.morph → .morph}/standards/context/priming.md +0 -0
  365. /package/{stacks/blazor-azure/.morph → .morph}/standards/core/architecture.md +0 -0
  366. /package/{stacks/blazor-azure/.morph → .morph}/standards/core/coding.md +0 -0
  367. /package/{stacks/blazor-azure/.morph → .morph}/standards/core/git-branching-strategy.md +0 -0
  368. /package/{stacks/blazor-azure/.morph → .morph}/standards/core/git.md +0 -0
  369. /package/{stacks/blazor-azure/.morph → .morph}/standards/core/testing.md +0 -0
  370. /package/{stacks/blazor-azure/.morph → .morph}/standards/data/nosql/blob-storage.md +0 -0
  371. /package/{stacks/blazor-azure/.morph → .morph}/standards/data/nosql/cache/redis.md +0 -0
  372. /package/{stacks/blazor-azure/.morph → .morph}/standards/data/nosql/cosmos-db.md +0 -0
  373. /package/{stacks/blazor-azure/.morph → .morph}/standards/data/vector-search/azure-ai-search.md +0 -0
  374. /package/{stacks/blazor-azure/.morph → .morph}/standards/data/vector-search/rag-chunking.md +0 -0
  375. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/design-checklist.md +0 -0
  376. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/fluent-ui-setup.md +0 -0
  377. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/fluent-ui.md +0 -0
  378. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/html-conversion.md +0 -0
  379. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/lifecycle.md +0 -0
  380. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/pitfalls.md +0 -0
  381. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/blazor/state.md +0 -0
  382. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/design-system/animations.md +0 -0
  383. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/design-system/naming.md +0 -0
  384. /package/{stacks/blazor-azure/.morph → .morph}/standards/frontend/nextjs/nextjs-patterns.md +0 -0
  385. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/azure.md +0 -0
  386. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -0
  387. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -0
  388. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/devops/local-development.md +0 -0
  389. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/services/functions.md +0 -0
  390. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/services/service-bus.md +0 -0
  391. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/azure/services/storage.md +0 -0
  392. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/docker/easypanel-deploy.md +0 -0
  393. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/supabase/mcp-setup.md +0 -0
  394. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/supabase/supabase-auth.md +0 -0
  395. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/supabase/supabase-pgvector.md +0 -0
  396. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/supabase/supabase-rls.md +0 -0
  397. /package/{stacks/blazor-azure/.morph → .morph}/standards/infrastructure/supabase/supabase-storage.md +0 -0
  398. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/api/graphql.md +0 -0
  399. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/api/grpc.md +0 -0
  400. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/api/rest-design.md +0 -0
  401. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/event-driven/cqrs.md +0 -0
  402. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/event-driven/event-sourcing.md +0 -0
  403. /package/{stacks/blazor-azure/.morph → .morph}/standards/integration/event-driven/service-bus.md +0 -0
  404. /package/{stacks/blazor-azure/.morph → .morph}/standards/observability/logging.md +0 -0
  405. /package/{stacks/blazor-azure/.morph → .morph}/standards/observability/metrics.md +0 -0
  406. /package/{stacks/blazor-azure/.morph → .morph}/standards/observability/monitoring.md +0 -0
  407. /package/{stacks/blazor-azure/.morph → .morph}/standards/observability/tracing.md +0 -0
  408. /package/{stacks/blazor-azure/.morph → .morph}/standards/workflows/parallel-execution.md +0 -0
  409. /package/{stacks/blazor-azure/.morph → .morph}/standards/workflows/thread-management.md +0 -0
  410. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-apply.md +0 -0
  411. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-archive.md +0 -0
  412. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-preflight.md +0 -0
  413. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-proposal.md +0 -0
  414. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-status.md +0 -0
  415. /package/{stacks/blazor-azure/.claude → framework}/commands/morph-troubleshoot.md +0 -0
  416. /package/{stacks/nextjs-supabase/.morph → framework}/standards/ai-agents/blazor-ui.md +0 -0
  417. /package/{stacks/nextjs-supabase/.morph → framework}/standards/ai-agents/production.md +0 -0
  418. /package/{stacks/nextjs-supabase/.morph → framework}/standards/ai-agents/setup.md +0 -0
  419. /package/{stacks/nextjs-supabase/.morph → framework}/standards/ai-agents/team-orchestration.md +0 -0
  420. /package/{stacks/nextjs-supabase/.morph → framework}/standards/ai-agents/workflows.md +0 -0
  421. /package/{stacks/nextjs-supabase/.morph → framework}/standards/architecture/ddd/aggregates.md +0 -0
  422. /package/{stacks/nextjs-supabase/.morph → framework}/standards/architecture/ddd/entities.md +0 -0
  423. /package/{stacks/nextjs-supabase/.morph → framework}/standards/architecture/ddd/value-objects.md +0 -0
  424. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/api/minimal-api.md +0 -0
  425. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/api/rest.md +0 -0
  426. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/api/validation.md +0 -0
  427. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/authentication/passkeys.md +0 -0
  428. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/database/ef-core.md +0 -0
  429. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/database/migrations.md +0 -0
  430. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/database/postgresql/database.md +0 -0
  431. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/database/repository-patterns.md +0 -0
  432. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/database/vector-search-rag.md +0 -0
  433. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/dotnet/async.md +0 -0
  434. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/dotnet/core.md +0 -0
  435. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/dotnet/di.md +0 -0
  436. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/dotnet/program-cs-checklist.md +0 -0
  437. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/integrations/asaas/asaas-api.md +0 -0
  438. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/integrations/clerk/clerk-auth.md +0 -0
  439. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -0
  440. /package/{stacks/nextjs-supabase/.morph → framework}/standards/backend/integrations/resend/resend-email.md +0 -0
  441. /package/{stacks/nextjs-supabase/.morph → framework}/standards/context/analytics.md +0 -0
  442. /package/{stacks/nextjs-supabase/.morph → framework}/standards/context/bundles.md +0 -0
  443. /package/{stacks/nextjs-supabase/.morph → framework}/standards/context/priming.md +0 -0
  444. /package/{stacks/nextjs-supabase/.morph → framework}/standards/core/architecture.md +0 -0
  445. /package/{stacks/nextjs-supabase/.morph → framework}/standards/core/coding.md +0 -0
  446. /package/{stacks/nextjs-supabase/.morph → framework}/standards/core/git-branching-strategy.md +0 -0
  447. /package/{stacks/nextjs-supabase/.morph → framework}/standards/core/git.md +0 -0
  448. /package/{stacks/nextjs-supabase/.morph → framework}/standards/core/testing.md +0 -0
  449. /package/{stacks/nextjs-supabase/.morph → framework}/standards/data/nosql/blob-storage.md +0 -0
  450. /package/{stacks/nextjs-supabase/.morph → framework}/standards/data/nosql/cache/redis.md +0 -0
  451. /package/{stacks/nextjs-supabase/.morph → framework}/standards/data/nosql/cosmos-db.md +0 -0
  452. /package/{stacks/nextjs-supabase/.morph → framework}/standards/data/vector-search/azure-ai-search.md +0 -0
  453. /package/{stacks/nextjs-supabase/.morph → framework}/standards/data/vector-search/rag-chunking.md +0 -0
  454. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/design-checklist.md +0 -0
  455. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/fluent-ui-setup.md +0 -0
  456. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/fluent-ui.md +0 -0
  457. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/html-conversion.md +0 -0
  458. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/lifecycle.md +0 -0
  459. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/pitfalls.md +0 -0
  460. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/blazor/state.md +0 -0
  461. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/design-system/animations.md +0 -0
  462. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/design-system/naming.md +0 -0
  463. /package/{stacks/nextjs-supabase/.morph → framework}/standards/frontend/nextjs/nextjs-patterns.md +0 -0
  464. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/azure.md +0 -0
  465. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -0
  466. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -0
  467. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/devops/local-development.md +0 -0
  468. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/services/functions.md +0 -0
  469. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/services/service-bus.md +0 -0
  470. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/azure/services/storage.md +0 -0
  471. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/docker/easypanel-deploy.md +0 -0
  472. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/supabase/mcp-setup.md +0 -0
  473. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/supabase/supabase-auth.md +0 -0
  474. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/supabase/supabase-pgvector.md +0 -0
  475. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/supabase/supabase-rls.md +0 -0
  476. /package/{stacks/nextjs-supabase/.morph → framework}/standards/infrastructure/supabase/supabase-storage.md +0 -0
  477. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/api/graphql.md +0 -0
  478. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/api/grpc.md +0 -0
  479. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/api/rest-design.md +0 -0
  480. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/event-driven/cqrs.md +0 -0
  481. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/event-driven/event-sourcing.md +0 -0
  482. /package/{stacks/nextjs-supabase/.morph → framework}/standards/integration/event-driven/service-bus.md +0 -0
  483. /package/{stacks/nextjs-supabase/.morph → framework}/standards/observability/logging.md +0 -0
  484. /package/{stacks/nextjs-supabase/.morph → framework}/standards/observability/metrics.md +0 -0
  485. /package/{stacks/nextjs-supabase/.morph → framework}/standards/observability/monitoring.md +0 -0
  486. /package/{stacks/nextjs-supabase/.morph → framework}/standards/observability/tracing.md +0 -0
  487. /package/{stacks/nextjs-supabase/.morph → framework}/standards/workflows/parallel-execution.md +0 -0
  488. /package/{stacks/nextjs-supabase/.morph → framework}/standards/workflows/thread-management.md +0 -0
@@ -1,436 +0,0 @@
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*
@@ -1,267 +0,0 @@
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