@polymorphism-tech/morph-spec 4.3.7 → 4.6.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 (394) hide show
  1. package/.morph/.morphversion +3 -3
  2. package/.morph/analytics/threads-log.jsonl +6 -9
  3. package/.morph/config/config.json +2 -3
  4. package/.morph/framework/standards/STANDARDS.json +812 -0
  5. package/.morph/{standards → framework/standards}/ai-agents/team-orchestration.md +3 -3
  6. package/.morph/{standards → framework/standards}/frontend/nextjs/nextjs-patterns.md +17 -0
  7. package/.morph/framework/standards/integration/mcp/mcp-tools.md +384 -0
  8. package/.morph/{templates → framework/templates}/README.md +17 -17
  9. package/.morph/{templates → framework/templates}/REGISTRY.json +48 -233
  10. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs +172 -0
  11. package/.morph/{templates → framework/templates}/context/CONTEXT-FEATURE.md +1 -1
  12. package/.morph/{templates → framework/templates}/context/CONTEXT.md +3 -3
  13. package/.morph/framework/templates/docs/clarifications.md +253 -0
  14. package/.morph/framework/templates/docs/onboarding.md +123 -0
  15. package/.morph/framework/templates/docs/schema-analysis.md +119 -0
  16. package/.morph/{templates → framework/templates}/docs/spec.md +149 -149
  17. package/.morph/framework/templates/docs/ui-components.md +124 -0
  18. package/.morph/framework/templates/docs/ui-design-system.md +76 -0
  19. package/.morph/framework/templates/docs/ui-flows.md +167 -0
  20. package/.morph/framework/templates/docs/ui-mockups.md +98 -0
  21. package/.morph/framework/templates/docs/user-stories.md +34 -0
  22. package/.morph/{templates → framework/templates}/examples/spec-examples.md +1 -1
  23. package/.morph/{templates → framework/templates}/infrastructure/github/README.md +11 -11
  24. package/.morph/{templates → framework/templates}/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +2 -2
  25. package/.morph/{templates → framework/templates}/meta-prompts/parallel-workers/parallel-worker.md +2 -2
  26. package/.morph/{templates → framework/templates}/meta-prompts/validators/pre-commit-validator.md +1 -1
  27. package/.morph/logs/tool-failures.log +7 -0
  28. package/.morph/memory/pre-compact-2026-02-23T15-43-03-521Z.json +16 -0
  29. package/.morph/state.json +1 -1
  30. package/CLAUDE.md +77 -155
  31. package/README.md +20 -18
  32. package/bin/detect-agents.js +1 -1
  33. package/bin/morph-spec.js +116 -266
  34. package/bin/task-manager.cjs +2 -2
  35. package/bin/validate.js +1 -1
  36. package/claude-plugin.json +14 -0
  37. package/docs/claude-alignment-report.md +137 -0
  38. package/docs/plans/2026-02-22-claude-docs-morph-alignment-analysis.md +512 -0
  39. package/docs/plans/2026-02-22-claude-settings.md +515 -0
  40. package/docs/plans/2026-02-22-morph-cc-alignment-impl.md +728 -0
  41. package/docs/plans/2026-02-22-morph-spec-next.md +478 -0
  42. package/docs/plans/2026-02-22-native-alignment-design.md +199 -0
  43. package/docs/plans/2026-02-22-native-alignment-impl.md +925 -0
  44. package/docs/plans/2026-02-22-native-enrichment-design.md +244 -0
  45. package/docs/plans/2026-02-22-native-enrichment.md +735 -0
  46. package/framework/CLAUDE.md +77 -0
  47. package/framework/{skills/level-2-domains → agents}/ai-agents/ai-system-architect.md +7 -3
  48. package/framework/{skills/level-2-domains → agents}/architecture/po-pm-advisor.md +7 -1
  49. package/framework/{skills/level-2-domains → agents}/architecture/prompt-engineer.md +7 -1
  50. package/framework/{skills/level-2-domains → agents}/architecture/seo-growth-hacker.md +7 -1
  51. package/framework/{skills/level-2-domains → agents}/architecture/standards-architect.md +10 -6
  52. package/framework/agents/backend/api-designer.md +103 -0
  53. package/framework/{skills/level-2-domains → agents}/backend/dotnet-senior.md +7 -1
  54. package/framework/agents/backend/ef-modeler.md +119 -0
  55. package/framework/{skills/level-2-domains → agents}/backend/hangfire-orchestrator.md +8 -4
  56. package/framework/{skills/level-2-domains → agents}/backend/ms-agent-expert.md +7 -3
  57. package/framework/{skills/level-2-domains → agents}/frontend/blazor-builder.md +7 -3
  58. package/framework/{skills/level-2-domains → agents}/frontend/nextjs-expert.md +7 -3
  59. package/framework/{skills/level-2-domains → agents}/frontend/ui-ux-designer.md +8 -2
  60. package/framework/{skills/level-2-domains → agents}/infrastructure/azure-architect.md +7 -1
  61. package/framework/{skills/level-2-domains → agents}/infrastructure/azure-deploy-specialist.md +7 -1
  62. package/framework/{skills/level-2-domains → agents}/infrastructure/bicep-architect.md +7 -3
  63. package/framework/{skills/level-2-domains → agents}/infrastructure/container-specialist.md +7 -3
  64. package/framework/{skills/level-2-domains → agents}/infrastructure/devops-engineer.md +7 -3
  65. package/framework/{skills/level-2-domains → agents}/integrations/asaas-financial.md +7 -3
  66. package/framework/{skills/level-2-domains → agents}/integrations/azure-identity.md +7 -3
  67. package/framework/{skills/level-2-domains → agents}/integrations/clerk-auth.md +7 -3
  68. package/framework/{skills/level-2-domains/integrations/hangfire-orchestrator.md → agents/integrations/hangfire-integration.md} +7 -1
  69. package/framework/{skills/level-2-domains → agents}/integrations/resend-email.md +7 -3
  70. package/framework/{skills/level-2-domains → agents}/quality/code-analyzer.md +9 -5
  71. package/framework/{skills/level-2-domains → agents}/quality/testing-specialist.md +7 -3
  72. package/framework/commands/morph-apply.md +9 -9
  73. package/framework/commands/morph-archive.md +8 -8
  74. package/framework/commands/morph-infra.md +1 -1
  75. package/framework/commands/morph-proposal.md +9 -9
  76. package/framework/commands/morph-status.md +3 -3
  77. package/framework/commands/morph-troubleshoot.md +1 -1
  78. package/framework/hooks/README.md +201 -282
  79. package/framework/hooks/claude-code/notification/approval-reminder.js +52 -0
  80. package/framework/hooks/claude-code/post-tool-use/dispatch.js +83 -0
  81. package/framework/hooks/claude-code/post-tool-use/handle-tool-failure.js +42 -0
  82. package/framework/hooks/claude-code/pre-compact/save-morph-context.js +61 -0
  83. package/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js +71 -0
  84. package/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +58 -0
  85. package/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js +64 -0
  86. package/framework/hooks/claude-code/session-start/inject-morph-context.js +94 -0
  87. package/framework/hooks/claude-code/statusline.py +538 -0
  88. package/framework/hooks/claude-code/statusline.sh +7 -0
  89. package/framework/hooks/claude-code/stop/validate-completion.js +88 -0
  90. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +91 -0
  91. package/framework/hooks/shared/hook-response.js +45 -0
  92. package/framework/hooks/shared/phase-utils.js +129 -0
  93. package/framework/hooks/shared/state-reader.js +138 -0
  94. package/framework/hooks/shared/stdin-reader.js +26 -0
  95. package/framework/phases.json +145 -0
  96. package/framework/rules/csharp-standards.md +10 -0
  97. package/framework/rules/frontend-standards.md +14 -0
  98. package/framework/rules/infrastructure-standards.md +13 -0
  99. package/framework/rules/morph-workflow.md +86 -0
  100. package/framework/rules/testing-standards.md +11 -0
  101. package/framework/skills/README.md +66 -0
  102. package/framework/skills/level-0-meta/brainstorming/SKILL.md +135 -0
  103. package/framework/skills/level-0-meta/brainstorming/references/proposal-example.md +138 -0
  104. package/framework/skills/level-0-meta/{code-review.md → code-review/SKILL.md} +13 -4
  105. package/framework/skills/level-0-meta/code-review/references/review-example.md +164 -0
  106. package/framework/skills/level-0-meta/code-review/scripts/scan-csharp.mjs +121 -0
  107. package/framework/skills/level-0-meta/mcp-registry.json +207 -0
  108. package/framework/skills/level-0-meta/{morph-checklist.md → morph-checklist/SKILL.md} +8 -3
  109. package/framework/skills/{level-1-workflows/morph-replicate.md → level-0-meta/morph-replicate/SKILL.md} +13 -6
  110. package/framework/skills/level-0-meta/{simulation-checklist.md → simulation-checklist/SKILL.md} +9 -4
  111. package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +334 -0
  112. package/framework/skills/level-0-meta/verification-before-completion/SKILL.md +147 -0
  113. package/framework/skills/level-0-meta/verification-before-completion/scripts/check-phase-outputs.mjs +110 -0
  114. package/framework/skills/level-1-workflows/{phase-clarify.md → phase-clarify/SKILL.md} +65 -4
  115. package/framework/skills/level-1-workflows/phase-clarify/references/clarifications-example.md +117 -0
  116. package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md +181 -0
  117. package/framework/skills/level-1-workflows/phase-design/SKILL.md +303 -0
  118. package/framework/skills/level-1-workflows/phase-design/references/spec-example.md +253 -0
  119. package/framework/skills/level-1-workflows/phase-implement/SKILL.md +254 -0
  120. package/framework/skills/level-1-workflows/phase-implement/references/recap-example.md +132 -0
  121. package/framework/skills/level-1-workflows/phase-setup/SKILL.md +171 -0
  122. package/framework/skills/level-1-workflows/{phase-tasks.md → phase-tasks/SKILL.md} +89 -7
  123. package/framework/skills/level-1-workflows/phase-tasks/references/tasks-example.md +231 -0
  124. package/framework/skills/level-1-workflows/phase-tasks/scripts/validate-tasks.mjs +112 -0
  125. package/framework/skills/level-1-workflows/phase-uiux/SKILL.md +246 -0
  126. package/framework/standards/STANDARDS.json +812 -0
  127. package/framework/standards/ai-agents/team-orchestration.md +3 -3
  128. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -0
  129. package/framework/standards/integration/mcp/mcp-tools.md +384 -0
  130. package/framework/templates/README.md +17 -17
  131. package/framework/templates/REGISTRY.json +48 -233
  132. package/framework/templates/code/dotnet/contracts/contracts.cs.hbs +172 -0
  133. package/framework/templates/context/CONTEXT-FEATURE.md +1 -1
  134. package/framework/templates/context/CONTEXT.md +3 -3
  135. package/framework/templates/docs/clarifications.md +253 -0
  136. package/framework/templates/docs/onboarding.md +123 -0
  137. package/framework/templates/docs/schema-analysis.md +119 -0
  138. package/framework/templates/docs/spec.md +149 -149
  139. package/framework/templates/docs/ui-components.md +124 -0
  140. package/framework/templates/docs/ui-design-system.md +76 -0
  141. package/framework/templates/docs/ui-flows.md +167 -0
  142. package/framework/templates/docs/ui-mockups.md +98 -0
  143. package/framework/templates/docs/user-stories.md +34 -0
  144. package/framework/templates/examples/spec-examples.md +1 -1
  145. package/framework/templates/infrastructure/github/README.md +11 -11
  146. package/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +2 -2
  147. package/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +2 -2
  148. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +1 -1
  149. package/framework/workflows/configs/express.json +45 -0
  150. package/framework/workflows/configs/spec-only.json +43 -0
  151. package/framework/workflows/docs/enforcement-pipeline.md +8 -8
  152. package/framework/workflows/docs/full-morph.md +3 -3
  153. package/package.json +3 -1
  154. package/scripts/generate-refs.js +336 -0
  155. package/scripts/generate-standards-registry.js +44 -0
  156. package/scripts/validate-real.mjs +255 -0
  157. package/src/commands/feature/create-story.js +362 -361
  158. package/src/commands/feature/shard-spec.js +225 -224
  159. package/src/commands/feature/sprint-status.js +1 -1
  160. package/src/commands/generation/generate-onboarding.js +169 -0
  161. package/src/commands/generation/generate.js +2 -2
  162. package/src/commands/mcp/mcp-setup.js +315 -0
  163. package/src/commands/project/changes.js +66 -0
  164. package/src/commands/project/checkpoint.js +209 -0
  165. package/src/commands/project/cost.js +179 -0
  166. package/src/commands/project/diff.js +278 -0
  167. package/src/commands/project/doctor.js +55 -7
  168. package/src/commands/project/init.js +318 -136
  169. package/src/commands/project/revert.js +173 -0
  170. package/src/commands/project/standards.js +80 -0
  171. package/src/commands/project/status.js +376 -0
  172. package/src/commands/project/update-agents.js +23 -0
  173. package/src/commands/project/update.js +60 -88
  174. package/src/commands/state/advance-phase.js +4 -3
  175. package/src/commands/state/state.js +10 -3
  176. package/src/commands/state/validate-phase.js +19 -2
  177. package/src/commands/templates/template-customize.js +4 -4
  178. package/src/commands/templates/template-render.js +1 -1
  179. package/src/commands/templates/template-show.js +1 -1
  180. package/src/commands/validation/validate-feature.js +359 -0
  181. package/src/core/orchestrator.js +3 -38
  182. package/src/core/paths/output-schema.js +135 -0
  183. package/src/core/state/state-manager.js +831 -592
  184. package/src/core/templates/template-registry.js +2 -2
  185. package/src/core/workflows/workflow-detector.js +17 -1
  186. package/src/lib/agents/micro-agent-factory.js +1 -1
  187. package/src/lib/context/context-bundler.js +2 -1
  188. package/src/lib/detectors/claude-config-detector.js +390 -0
  189. package/src/lib/detectors/conversation-analyzer.js +4 -4
  190. package/src/lib/detectors/design-system-detector.js +6 -5
  191. package/src/lib/detectors/standards-generator.js +2 -2
  192. package/src/lib/generators/context-generator.js +539 -538
  193. package/src/lib/generators/recap-generator.js +1 -1
  194. package/src/lib/generators/settings-generator.js +210 -0
  195. package/src/lib/hooks/hook-executor.js +1 -1
  196. package/src/lib/installers/mcp-installer.js +299 -0
  197. package/src/lib/learning/learning-system.js +3 -3
  198. package/src/lib/orchestration/team-orchestrator.js +1 -1
  199. package/src/lib/standards/standards-context-injector.js +7 -7
  200. package/src/lib/threads/thread-coordinator.js +1 -1
  201. package/src/lib/troubleshooting/troubleshoot-grep.js +1 -1
  202. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -273
  203. package/src/lib/validators/design-system/design-system-validator.js +1 -1
  204. package/src/lib/validators/spec-validator.js +258 -258
  205. package/src/lib/validators/validation-runner.js +270 -269
  206. package/src/utils/agents-installer.js +206 -0
  207. package/src/utils/claude-settings-manager.js +258 -0
  208. package/src/utils/file-copier.js +1 -1
  209. package/src/utils/hooks-installer.js +354 -28
  210. package/src/utils/skills-installer.js +118 -0
  211. package/.morph/project/context/README.md +0 -17
  212. package/.morph/project/context/detection-log.md +0 -16
  213. package/.morph/project/standards/inferred.md +0 -59
  214. package/framework/hooks/agent-stop/validate-and-continue.js +0 -96
  215. package/framework/hooks/agent-stop/validate-checkpoints.js +0 -101
  216. package/framework/hooks/agent-stop/validate-tests.js +0 -109
  217. package/framework/hooks/agent-teams/dispatch.js +0 -67
  218. package/framework/hooks/agent-teams/phase-advanced.js +0 -80
  219. package/framework/hooks/agent-teams/task-completed.js +0 -76
  220. package/framework/hooks/agent-teams/teammate-idle.js +0 -70
  221. package/framework/skills/level-1-workflows/phase-design.md +0 -213
  222. package/framework/skills/level-1-workflows/phase-setup.md +0 -106
  223. package/framework/skills/level-1-workflows/phase-uiux.md +0 -169
  224. package/framework/skills/level-2-domains/backend/api-designer.md +0 -59
  225. package/framework/skills/level-2-domains/backend/ef-modeler.md +0 -58
  226. package/framework/skills/level-3-technologies/README.md +0 -7
  227. package/framework/skills/level-4-patterns/README.md +0 -7
  228. package/src/commands/agents/agents-fuse.js +0 -97
  229. package/src/commands/agents/micro-agent.js +0 -112
  230. package/src/commands/agents/spawn-team.js +0 -237
  231. package/src/commands/agents/squad-template.js +0 -146
  232. package/src/commands/analytics/analytics.js +0 -176
  233. package/src/commands/context/context-prime.js +0 -63
  234. package/src/commands/context/core-four.js +0 -54
  235. package/src/commands/generation/generate-context.js +0 -40
  236. package/src/commands/project/detect-agents.js +0 -207
  237. package/src/commands/project/detect-workflow.js +0 -174
  238. package/src/commands/threads/thread-template.js +0 -103
  239. package/src/commands/threads/threads.js +0 -261
  240. package/src/commands/utils/session-summary.js +0 -291
  241. package/src/llm/analyzer.js +0 -215
  242. package/src/llm/few-shot-examples.js +0 -216
  243. package/src/llm/project-config-schema.json +0 -188
  244. package/src/llm/prompt-builder.js +0 -96
  245. /package/.morph/{config → framework}/agents.json +0 -0
  246. /package/.morph/{standards → framework/standards}/ai-agents/blazor-ui.md +0 -0
  247. /package/.morph/{standards → framework/standards}/ai-agents/production.md +0 -0
  248. /package/.morph/{standards → framework/standards}/ai-agents/setup.md +0 -0
  249. /package/.morph/{standards → framework/standards}/ai-agents/workflows.md +0 -0
  250. /package/.morph/{standards → framework/standards}/architecture/ddd/aggregates.md +0 -0
  251. /package/.morph/{standards → framework/standards}/architecture/ddd/entities.md +0 -0
  252. /package/.morph/{standards → framework/standards}/architecture/ddd/value-objects.md +0 -0
  253. /package/.morph/{standards → framework/standards}/backend/api/minimal-api.md +0 -0
  254. /package/.morph/{standards → framework/standards}/backend/api/rest.md +0 -0
  255. /package/.morph/{standards → framework/standards}/backend/api/validation.md +0 -0
  256. /package/.morph/{standards → framework/standards}/backend/authentication/passkeys.md +0 -0
  257. /package/.morph/{standards → framework/standards}/backend/database/ef-core.md +0 -0
  258. /package/.morph/{standards → framework/standards}/backend/database/migrations.md +0 -0
  259. /package/.morph/{standards → framework/standards}/backend/database/postgresql/database.md +0 -0
  260. /package/.morph/{standards → framework/standards}/backend/database/repository-patterns.md +0 -0
  261. /package/.morph/{standards → framework/standards}/backend/database/vector-search-rag.md +0 -0
  262. /package/.morph/{standards → framework/standards}/backend/dotnet/async.md +0 -0
  263. /package/.morph/{standards → framework/standards}/backend/dotnet/core.md +0 -0
  264. /package/.morph/{standards → framework/standards}/backend/dotnet/di.md +0 -0
  265. /package/.morph/{standards → framework/standards}/backend/dotnet/program-cs-checklist.md +0 -0
  266. /package/.morph/{standards → framework/standards}/backend/integrations/asaas/asaas-api.md +0 -0
  267. /package/.morph/{standards → framework/standards}/backend/integrations/clerk/clerk-auth.md +0 -0
  268. /package/.morph/{standards → framework/standards}/backend/integrations/hangfire/hangfire-jobs.md +0 -0
  269. /package/.morph/{standards → framework/standards}/backend/integrations/resend/resend-email.md +0 -0
  270. /package/.morph/{standards → framework/standards}/context/analytics.md +0 -0
  271. /package/.morph/{standards → framework/standards}/context/bundles.md +0 -0
  272. /package/.morph/{standards → framework/standards}/context/priming.md +0 -0
  273. /package/.morph/{standards → framework/standards}/core/architecture.md +0 -0
  274. /package/.morph/{standards → framework/standards}/core/coding.md +0 -0
  275. /package/.morph/{standards → framework/standards}/core/git-branching-strategy.md +0 -0
  276. /package/.morph/{standards → framework/standards}/core/git.md +0 -0
  277. /package/.morph/{standards → framework/standards}/core/testing.md +0 -0
  278. /package/.morph/{standards → framework/standards}/data/nosql/blob-storage.md +0 -0
  279. /package/.morph/{standards → framework/standards}/data/nosql/cache/redis.md +0 -0
  280. /package/.morph/{standards → framework/standards}/data/nosql/cosmos-db.md +0 -0
  281. /package/.morph/{standards → framework/standards}/data/vector-search/azure-ai-search.md +0 -0
  282. /package/.morph/{standards → framework/standards}/data/vector-search/rag-chunking.md +0 -0
  283. /package/.morph/{standards → framework/standards}/frontend/blazor/design-checklist.md +0 -0
  284. /package/.morph/{standards → framework/standards}/frontend/blazor/fluent-ui-setup.md +0 -0
  285. /package/.morph/{standards → framework/standards}/frontend/blazor/fluent-ui.md +0 -0
  286. /package/.morph/{standards → framework/standards}/frontend/blazor/html-conversion.md +0 -0
  287. /package/.morph/{standards → framework/standards}/frontend/blazor/lifecycle.md +0 -0
  288. /package/.morph/{standards → framework/standards}/frontend/blazor/pitfalls.md +0 -0
  289. /package/.morph/{standards → framework/standards}/frontend/blazor/state.md +0 -0
  290. /package/.morph/{standards → framework/standards}/frontend/design-system/animations.md +0 -0
  291. /package/.morph/{standards → framework/standards}/frontend/design-system/naming.md +0 -0
  292. /package/.morph/{standards → framework/standards}/infrastructure/azure/azure.md +0 -0
  293. /package/.morph/{standards → framework/standards}/infrastructure/azure/bicep/bicep-patterns.md +0 -0
  294. /package/.morph/{standards → framework/standards}/infrastructure/azure/devops/azure-devops-setup.md +0 -0
  295. /package/.morph/{standards → framework/standards}/infrastructure/azure/devops/local-development.md +0 -0
  296. /package/.morph/{standards → framework/standards}/infrastructure/azure/services/functions.md +0 -0
  297. /package/.morph/{standards → framework/standards}/infrastructure/azure/services/service-bus.md +0 -0
  298. /package/.morph/{standards → framework/standards}/infrastructure/azure/services/storage.md +0 -0
  299. /package/.morph/{standards → framework/standards}/infrastructure/docker/easypanel-deploy.md +0 -0
  300. /package/.morph/{standards → framework/standards}/infrastructure/supabase/mcp-setup.md +0 -0
  301. /package/.morph/{standards → framework/standards}/infrastructure/supabase/supabase-auth.md +0 -0
  302. /package/.morph/{standards → framework/standards}/infrastructure/supabase/supabase-pgvector.md +0 -0
  303. /package/.morph/{standards → framework/standards}/infrastructure/supabase/supabase-rls.md +0 -0
  304. /package/.morph/{standards → framework/standards}/infrastructure/supabase/supabase-storage.md +0 -0
  305. /package/.morph/{standards → framework/standards}/integration/api/graphql.md +0 -0
  306. /package/.morph/{standards → framework/standards}/integration/api/grpc.md +0 -0
  307. /package/.morph/{standards → framework/standards}/integration/api/rest-design.md +0 -0
  308. /package/.morph/{standards → framework/standards}/integration/event-driven/cqrs.md +0 -0
  309. /package/.morph/{standards → framework/standards}/integration/event-driven/event-sourcing.md +0 -0
  310. /package/.morph/{standards → framework/standards}/integration/event-driven/service-bus.md +0 -0
  311. /package/.morph/{standards → framework/standards}/observability/logging.md +0 -0
  312. /package/.morph/{standards → framework/standards}/observability/metrics.md +0 -0
  313. /package/.morph/{standards → framework/standards}/observability/monitoring.md +0 -0
  314. /package/.morph/{standards → framework/standards}/observability/tracing.md +0 -0
  315. /package/.morph/{standards → framework/standards}/workflows/parallel-execution.md +0 -0
  316. /package/.morph/{standards → framework/standards}/workflows/thread-management.md +0 -0
  317. /package/.morph/{templates → framework/templates}/.idea/morph-templates.xml +0 -0
  318. /package/.morph/{templates → framework/templates}/.vscode/morph-templates.code-snippets +0 -0
  319. /package/.morph/{templates → framework/templates}/IDE-SNIPPETS.md +0 -0
  320. /package/.morph/{templates → framework/templates}/code/dotnet/backend/repository.cs +0 -0
  321. /package/.morph/{templates → framework/templates}/code/dotnet/backend/service.cs +0 -0
  322. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/Commands.cs +0 -0
  323. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/Entities.cs +0 -0
  324. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/Queries.cs +0 -0
  325. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/README.md +0 -0
  326. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/api-contracts.cs +0 -0
  327. /package/.morph/{templates → framework/templates}/code/dotnet/contracts/contracts.cs +0 -0
  328. /package/.morph/{templates → framework/templates}/code/dotnet/database/migration.cs +0 -0
  329. /package/.morph/{templates → framework/templates}/code/dotnet/frontend/component.razor +0 -0
  330. /package/.morph/{templates → framework/templates}/code/dotnet/jobs/agent.cs +0 -0
  331. /package/.morph/{templates → framework/templates}/code/dotnet/jobs/job.cs +0 -0
  332. /package/.morph/{templates → framework/templates}/code/dotnet/test.cs +0 -0
  333. /package/.morph/{templates → framework/templates}/code/sql/rls-policy.sql +0 -0
  334. /package/.morph/{templates → framework/templates}/code/sql/supabase-migration.sql +0 -0
  335. /package/.morph/{templates → framework/templates}/code/sql/supabase-migration.template.sql +0 -0
  336. /package/.morph/{templates → framework/templates}/code/typescript/contracts.ts +0 -0
  337. /package/.morph/{templates → framework/templates}/docs/proposal.md +0 -0
  338. /package/.morph/{templates → framework/templates}/examples/design-system-examples.md +0 -0
  339. /package/.morph/{templates → framework/templates}/feature/decisions.md +0 -0
  340. /package/.morph/{templates → framework/templates}/feature/recap.md +0 -0
  341. /package/.morph/{templates → framework/templates}/feature/tasks.md +0 -0
  342. /package/.morph/{templates → framework/templates}/infrastructure/azure/Dockerfile.example +0 -0
  343. /package/.morph/{templates → framework/templates}/infrastructure/azure/README.md +0 -0
  344. /package/.morph/{templates → framework/templates}/infrastructure/azure/app-insights.bicep +0 -0
  345. /package/.morph/{templates → framework/templates}/infrastructure/azure/app-service.bicep +0 -0
  346. /package/.morph/{templates → framework/templates}/infrastructure/azure/container-app-env.bicep +0 -0
  347. /package/.morph/{templates → framework/templates}/infrastructure/azure/container-app.bicep +0 -0
  348. /package/.morph/{templates → framework/templates}/infrastructure/azure/deploy-checklist.md +0 -0
  349. /package/.morph/{templates → framework/templates}/infrastructure/azure/deploy.ps1 +0 -0
  350. /package/.morph/{templates → framework/templates}/infrastructure/azure/deploy.sh +0 -0
  351. /package/.morph/{templates → framework/templates}/infrastructure/azure/key-vault.bicep +0 -0
  352. /package/.morph/{templates → framework/templates}/infrastructure/azure/main.bicep +0 -0
  353. /package/.morph/{templates → framework/templates}/infrastructure/azure/parameters.dev.json +0 -0
  354. /package/.morph/{templates → framework/templates}/infrastructure/azure/parameters.prod.json +0 -0
  355. /package/.morph/{templates → framework/templates}/infrastructure/azure/parameters.staging.json +0 -0
  356. /package/.morph/{templates → framework/templates}/infrastructure/azure/sql-database.bicep +0 -0
  357. /package/.morph/{templates → framework/templates}/infrastructure/azure/storage.bicep +0 -0
  358. /package/.morph/{templates → framework/templates}/infrastructure/docker/Dockerfile.template +0 -0
  359. /package/.morph/{templates → framework/templates}/infrastructure/docker/docker-compose.template.yml +0 -0
  360. /package/.morph/{templates → framework/templates}/infrastructure/docker/dockerfile-api.dockerfile +0 -0
  361. /package/.morph/{templates → framework/templates}/infrastructure/docker/dockerfile-web.dockerfile +0 -0
  362. /package/.morph/{templates → framework/templates}/infrastructure/docker/easypanel.template.json +0 -0
  363. /package/.morph/{templates → framework/templates}/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -0
  364. /package/.morph/{templates → framework/templates}/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -0
  365. /package/.morph/{templates → framework/templates}/infrastructure/github/actions/health-check/action.yml.hbs +0 -0
  366. /package/.morph/{templates → framework/templates}/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -0
  367. /package/.morph/{templates → framework/templates}/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -0
  368. /package/.morph/{templates → framework/templates}/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -0
  369. /package/.morph/{templates → framework/templates}/integrations/asaas-client.cs +0 -0
  370. /package/.morph/{templates → framework/templates}/integrations/asaas-webhook.cs +0 -0
  371. /package/.morph/{templates → framework/templates}/integrations/azure-identity-config.cs +0 -0
  372. /package/.morph/{templates → framework/templates}/integrations/clerk-config.cs +0 -0
  373. /package/.morph/{templates → framework/templates}/meta-prompts/fusion/fusion-agent.md +0 -0
  374. /package/.morph/{templates → framework/templates}/meta-prompts/fusion/fusion-aggregator.md +0 -0
  375. /package/.morph/{templates → framework/templates}/meta-prompts/hops/hop-retry.md +0 -0
  376. /package/.morph/{templates → framework/templates}/meta-prompts/hops/hop-validation.md +0 -0
  377. /package/.morph/{templates → framework/templates}/meta-prompts/hops/hop-wrapper.md +0 -0
  378. /package/.morph/{templates → framework/templates}/meta-prompts/parallel-workers/parallel-coordinator.md +0 -0
  379. /package/.morph/{templates → framework/templates}/meta-prompts/squad-leaders/backend-squad.md +0 -0
  380. /package/.morph/{templates → framework/templates}/meta-prompts/squad-leaders/frontend-squad.md +0 -0
  381. /package/.morph/{templates → framework/templates}/meta-prompts/squad-leaders/squad-leader.md +0 -0
  382. /package/.morph/{templates → framework/templates}/meta-prompts/validators/checkpoint-validator.md +0 -0
  383. /package/.morph/{templates → framework/templates}/saas/subscription.cs +0 -0
  384. /package/.morph/{templates → framework/templates}/saas/tenant.cs +0 -0
  385. /package/.morph/{templates → framework/templates}/state.template.json +0 -0
  386. /package/.morph/{templates → framework/templates}/ui/FluentDesignTheme.cs +0 -0
  387. /package/.morph/{templates → framework/templates}/ui/MudTheme.cs +0 -0
  388. /package/.morph/{templates → framework/templates}/ui/design-system.css +0 -0
  389. /package/framework/{skills/level-2-domains → agents}/README.md +0 -0
  390. /package/framework/hooks/{commit-msg → git/commit-msg}/conventional-commits.sh +0 -0
  391. /package/framework/hooks/{pre-commit → git/pre-commit}/agents.sh +0 -0
  392. /package/framework/hooks/{pre-commit → git/pre-commit}/orchestrator.sh +0 -0
  393. /package/framework/hooks/{pre-commit → git/pre-commit}/specs.sh +0 -0
  394. /package/framework/hooks/{pre-push → git/pre-push}/run-tests.sh +0 -0
@@ -0,0 +1,98 @@
1
+ # UI Mockups & Wireframes: {{titleCase FEATURE_NAME}}
2
+
3
+ | Field | Value |
4
+ |-------|-------|
5
+ | **Feature** | {{FEATURE_NAME}} |
6
+ | **Created** | {{DATE}} |
7
+
8
+ ---
9
+
10
+ ## Screen Inventory
11
+
12
+ | Screen ID | Name | Route | Priority |
13
+ |-----------|------|-------|----------|
14
+ | **S001** | {Screen Name} | /path | High |
15
+ | **S002** | {Screen Name} | /path | Medium |
16
+
17
+ ---
18
+
19
+ ## S001: {Primary Screen}
20
+
21
+ ### Desktop Layout
22
+
23
+ ```
24
+ ┌─────────────────────────────────────┐
25
+ │ Header [User ▼] │
26
+ ├─────────────────────────────────────┤
27
+ │ │
28
+ │ [Title] │
29
+ │ │
30
+ │ ┌──────────────────────────────┐ │
31
+ │ │ Main Content Area │ │
32
+ │ │ │ │
33
+ │ │ [Card 1] [Card 2] │ │
34
+ │ │ │ │
35
+ │ │ ┌────────────────────────┐ │ │
36
+ │ │ │ Data Table │ │ │
37
+ │ │ │ ... │ │ │
38
+ │ │ └────────────────────────┘ │ │
39
+ │ └──────────────────────────────┘ │
40
+ │ │
41
+ └─────────────────────────────────────┘
42
+ ```
43
+
44
+ ### Mobile Layout
45
+
46
+ ```
47
+ ┌──────────────────────┐
48
+ │ ☰ Title [User ▼]│
49
+ ├──────────────────────┤
50
+ │ │
51
+ │ [Card 1] │
52
+ │ │
53
+ │ [Card 2] │
54
+ │ │
55
+ │ [View All Items] │
56
+ │ │
57
+ └──────────────────────┘
58
+ ```
59
+
60
+ ---
61
+
62
+ ## States
63
+
64
+ ### Loading
65
+ - Show skeleton placeholders
66
+ - Spinner for primary content
67
+
68
+ ### Empty
69
+ - Icon + message
70
+ - Clear call-to-action button
71
+
72
+ ### Error
73
+ - Warning icon
74
+ - User-friendly message
75
+ - Retry button
76
+
77
+ ### Success (After Action)
78
+ - Toast notification
79
+ - Auto-dismiss after 3s
80
+
81
+ ---
82
+
83
+ ## Interactions
84
+
85
+ - **Hover**: Subtle elevation increase
86
+ - **Click**: Scale down (0.98)
87
+ - **Transitions**: Fade-in 200ms
88
+
89
+ ---
90
+
91
+ ## Accessibility
92
+ - [ ] 44x44px minimum touch targets
93
+ - [ ] Focus indicators visible
94
+ - [ ] Proper heading hierarchy (H1 → H2 → H3)
95
+
96
+ ---
97
+
98
+ *Generated with MORPH Framework*
@@ -0,0 +1,34 @@
1
+ # User Stories: {{featureName}}
2
+
3
+ > Generated: {{date}} | Feature: {{featureName}} | Status: Draft
4
+
5
+ ---
6
+
7
+ ## Story 1: [Actor] [Action]
8
+
9
+ **Feature:** {{featureName}}
10
+ **Priority:** High / Medium / Low
11
+
12
+ ### Optimal Path
13
+ 1. [Step 1]
14
+ 2. [Step 2]
15
+ 3. [Step 3 — success state]
16
+
17
+ ### Edge Cases
18
+ - [Edge case] → [Expected behavior]
19
+ - [Error condition] → [Expected error handling]
20
+
21
+ ### Acceptance Criteria
22
+ - [ ] [Measurable criterion 1]
23
+ - [ ] [Measurable criterion 2]
24
+ - [ ] Edge: [edge case criterion]
25
+
26
+ ---
27
+
28
+ ## Story 2: [Actor] [Action]
29
+
30
+ [Repeat structure above]
31
+
32
+ ---
33
+
34
+ *Generated by MORPH-SPEC — complete before implementation begins*
@@ -2,7 +2,7 @@
2
2
 
3
3
  > **Layer:** 3 | **Load:** on-demand | **Keywords:** spec, specification, template
4
4
 
5
- **Use the stack's `.morph/templates/spec.md` as the canonical template.**
5
+ **Use the stack's `.morph/framework/templates/spec.md` as the canonical template.**
6
6
 
7
7
  This file contains extended examples for each spec section.
8
8
 
@@ -104,7 +104,7 @@ steps:
104
104
 
105
105
  **Workflows:**
106
106
  - Framework: `deploy-azure-app-service.yml.hbs`
107
- - Stack: `stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
107
+ - Stack: `stacks/blazor-azure/.morph/framework/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
108
108
 
109
109
  ### NextJS-Supabase (EasyPanel/Docker)
110
110
 
@@ -130,7 +130,7 @@ steps:
130
130
 
131
131
  **Workflows:**
132
132
  - Framework: `docker-build-push.yml.hbs`, `deploy-easypanel.yml.hbs`
133
- - Stack: `stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
133
+ - Stack: `stacks/nextjs-supabase/.morph/framework/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
134
134
 
135
135
  ---
136
136
 
@@ -290,7 +290,7 @@ morph-spec template render github-workflows \
290
290
  ### What Gets Committed
291
291
 
292
292
  ✅ **Commit:** Rendered `.yml` files in `.github/workflows/` and `.github/actions/`
293
- ❌ **Don't Commit:** Template sources (`.yml.hbs` files) - these stay in `.morph/templates/`
293
+ ❌ **Don't Commit:** Template sources (`.yml.hbs` files) - these stay in `.morph/framework/templates/`
294
294
 
295
295
  **Example:**
296
296
  ```
@@ -305,7 +305,7 @@ morph-spec template render github-workflows \
305
305
  └── action.yml # Rendered from template
306
306
 
307
307
  # NOT committed (template sources):
308
- .morph/templates/infrastructure/github/
308
+ .morph/framework/templates/infrastructure/github/
309
309
  ├── workflows/
310
310
  │ ├── ci-build.yml.hbs # Template source
311
311
  │ └── ...
@@ -318,11 +318,11 @@ morph-spec template render github-workflows \
318
318
  Templates follow the 3-tier resolution hierarchy:
319
319
 
320
320
  1. **Project-local** (highest priority)
321
- - `.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs`
321
+ - `.morph/framework/templates/infrastructure/github/workflows/ci-build.yml.hbs`
322
322
  - Use for project-specific customizations
323
323
 
324
324
  2. **Stack default** (medium priority)
325
- - `stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs`
325
+ - `stacks/blazor-azure/.morph/framework/templates/infrastructure/github/workflows/ci-build.yml.hbs`
326
326
  - Stack-specific workflows (production, staging, CI)
327
327
 
328
328
  3. **Framework fallback** (lowest priority)
@@ -333,7 +333,7 @@ Templates follow the 3-tier resolution hierarchy:
333
333
 
334
334
  Stack workflow `cd-prod.yml.hbs` **calls** framework workflow `dotnet-build.yml.hbs`:
335
335
  ```yaml
336
- # Stack: stacks/blazor-azure/.morph/templates/.../cd-prod.yml.hbs
336
+ # Stack: stacks/blazor-azure/.morph/framework/templates/.../cd-prod.yml.hbs
337
337
  jobs:
338
338
  build:
339
339
  uses: ./.github/workflows/dotnet-build.yml # Framework template (rendered)
@@ -394,7 +394,7 @@ actionlint .github/workflows/*.yml
394
394
 
395
395
  ### Example 1: CI Build (Blazor-Azure)
396
396
 
397
- **Stack Template:** `stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs`
397
+ **Stack Template:** `stacks/blazor-azure/.morph/framework/templates/infrastructure/github/workflows/ci-build.yml.hbs`
398
398
 
399
399
  ```yaml
400
400
  name: CI Build
@@ -424,7 +424,7 @@ jobs:
424
424
 
425
425
  ### Example 2: Production Deployment (NextJS-Supabase)
426
426
 
427
- **Stack Template:** `stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
427
+ **Stack Template:** `stacks/nextjs-supabase/.morph/framework/templates/infrastructure/github/workflows/cd-prod.yml.hbs`
428
428
 
429
429
  ```yaml
430
430
  name: Deploy to Production
@@ -459,13 +459,13 @@ jobs:
459
459
 
460
460
  1. **Create override template:**
461
461
  ```bash
462
- mkdir -p stacks/blazor-azure/.morph/templates/infrastructure/github/workflows
462
+ mkdir -p stacks/blazor-azure/.morph/framework/templates/infrastructure/github/workflows
463
463
  ```
464
464
 
465
465
  2. **Copy framework template:**
466
466
  ```bash
467
467
  cp framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs \
468
- stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/
468
+ stacks/blazor-azure/.morph/framework/templates/infrastructure/github/workflows/
469
469
  ```
470
470
 
471
471
  3. **Customize:**
@@ -35,8 +35,8 @@ jobs:
35
35
  uses: azure/arm-deploy@v1
36
36
  with:
37
37
  resourceGroupName: ${{{{ inputs.resource-group }}}}
38
- template: .morph/templates/infra/main.bicep
39
- parameters: .morph/templates/infra/parameters.${{{{ inputs.environment }}}}.json
38
+ template: .morph/framework/templates/infra/main.bicep
39
+ parameters: .morph/framework/templates/infra/parameters.${{{{ inputs.environment }}}}.json
40
40
 
41
41
  - name: Setup .NET
42
42
  uses: actions/setup-dotnet@v4
@@ -28,9 +28,9 @@ Files you OWN (safe to create/modify):
28
28
  {{DELIVERABLES}}
29
29
 
30
30
  Files you can READ (shared, do not modify):
31
- - `.morph/project/outputs/{{FEATURE_NAME}}/spec.md`
31
+ - `.morph/features/{{FEATURE_NAME}}/1-design/spec.md`
32
32
  - `framework/standards/` (all)
33
- - `.morph/project/outputs/{{FEATURE_NAME}}/contracts.*`
33
+ - `.morph/features/{{FEATURE_NAME}}/1-design/contracts.*`
34
34
 
35
35
  ## Spec Summary
36
36
  {{SPEC_SUMMARY}}
@@ -40,7 +40,7 @@ Check staged files for accidental secrets:
40
40
  - Private key headers
41
41
 
42
42
  ### 3. Agent Spec Validation (if agents.json staged)
43
- If `.morph/config/agents.json` is in staged files:
43
+ If `.morph/framework/agents.json` is in staged files:
44
44
  - Valid JSON structure
45
45
  - All required agent fields present (agentId, role, tier, domain)
46
46
  - No duplicate agentIds
@@ -0,0 +1,7 @@
1
+ {"timestamp":"2026-02-23T15:31:56.191Z","tool":"Read","error":"File does not exist. Note: your current working directory is R:\\Polymorphism Tech\\repos\\morph-spec-framework.","input":{"file_path":"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\override-feature\\3-tasks\\tasks.md"}}
2
+ {"timestamp":"2026-02-23T15:32:00.207Z","tool":"Bash","error":"Exit code 2\nIdentity added: /c/Users/Lucas/.ssh/id_ed25519 (lucas@polymorphism.com.br)\n/usr/bin/bash: eval: line 1: unexpected EOF while looking for matching `\"'\n\nIdentity added: /c/Users/Lucas/.ssh/id_ed25519 (lucas@polymorphism.com.br)\n/usr/bin/bash: eval: line 1: unexpected EOF while looking for matching `\"'","input":{"command":"ls -la \"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\\" 2>&1 || echo \"Directory check failed\""}}
3
+ {"timestamp":"2026-02-23T15:33:27.198Z","tool":"Read","error":"File does not exist. Note: your current working directory is R:\\Polymorphism Tech\\repos\\morph-spec-framework.","input":{"file_path":"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\override-feature\\3-tasks\\tasks.md"}}
4
+ {"timestamp":"2026-02-23T15:38:14.763Z","tool":"Read","error":"File does not exist. Note: your current working directory is R:\\Polymorphism Tech\\repos\\morph-spec-framework.","input":{"file_path":"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\override-feature\\3-tasks\\tasks.md"}}
5
+ {"timestamp":"2026-02-23T15:38:26.904Z","tool":"Bash","error":"Exit code 2\nIdentity added: /c/Users/Lucas/.ssh/id_ed25519 (lucas@polymorphism.com.br)\n/usr/bin/bash: eval: line 1: unexpected EOF while looking for matching `\"'\n\nIdentity added: /c/Users/Lucas/.ssh/id_ed25519 (lucas@polymorphism.com.br)\n/usr/bin/bash: eval: line 1: unexpected EOF while looking for matching `\"'","input":{"command":"ls -la \"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\\" 2>&1 || echo \"Directory does not exist\""}}
6
+ {"timestamp":"2026-02-23T15:42:51.893Z","tool":"Read","error":"File does not exist. Note: your current working directory is R:\\Polymorphism Tech\\repos\\morph-spec-framework.","input":{"file_path":"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\framework\\skills\\README.md"}}
7
+ {"timestamp":"2026-02-23T15:46:20.009Z","tool":"Read","error":"File does not exist. Note: your current working directory is R:\\Polymorphism Tech\\repos\\morph-spec-framework.","input":{"file_path":"R:\\Polymorphism Tech\\repos\\morph-spec-framework\\.morph\\features\\override-feature\\0-proposal\\proposal.md"}}
@@ -0,0 +1,16 @@
1
+ {
2
+ "timestamp": "2026-02-23T15:43:03.520Z",
3
+ "event": "pre-compact",
4
+ "activeFeature": "override-feature",
5
+ "features": {
6
+ "override-feature": {
7
+ "phase": "implement",
8
+ "status": "in_progress",
9
+ "tasks": {
10
+ "total": 20,
11
+ "completed": 30
12
+ },
13
+ "approvalGates": {}
14
+ }
15
+ }
16
+ }
package/.morph/state.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "3.0.0",
2
+ "version": "4.0.0",
3
3
  "features": {
4
4
  "override-feature": {
5
5
  "status": "in_progress",
package/CLAUDE.md CHANGED
@@ -1,155 +1,77 @@
1
- # MORPH-SPEC - Claude Code Instructions
2
-
3
- > by Polymorphism Tech
4
-
5
- Spec-driven development system. Specialized agent hub for multi-stack projects with Infrastructure as Code.
6
-
7
- ---
8
-
9
- ## CRITICAL RULES
10
-
11
- ### NEVER:
12
- - Skip to code without a specification
13
- - Implement without design approval
14
- - Ignore standards in `.morph/standards/`
15
- - Create infrastructure manually
16
- - Generate code without defined contracts
17
-
18
- ### ALWAYS:
19
- - Follow the 5 mandatory phases
20
- - Generate outputs in `.morph/project/outputs/{feature}/`
21
- - Document decisions in `decisions.md`
22
- - Checkpoint every 3 implemented tasks
23
- - Use Infrastructure as Code
24
-
25
- ---
26
-
27
- ## WORKFLOW (5 Phases)
28
-
29
- | Phase | Trigger | Actions | Output | Pause? |
30
- |-------|---------|---------|--------|--------|
31
- | **1. SETUP** | Feature request | Read project context, identify stack, activate agents, create folder | proposal.md | No |
32
- | **2. DESIGN** | Setup done | Spec + contracts + decisions + costs | spec.md, contracts, decisions.md | **Yes** |
33
- | **3. CLARIFY** | Design approved | Ambiguities, questions, edge cases | Updated spec | No |
34
- | **4. TASKS** | Clarifications resolved | Break into tasks, ordering, checkpoints, dependencies | tasks.md | **Yes** |
35
- | **5. IMPLEMENT** | Tasks approved | Task by task, checkpoint every 3, recap | Code + recap.md | No |
36
-
37
- ---
38
-
39
- ## PROJECT STRUCTURE
40
-
41
- ```
42
- project/
43
- ├── CLAUDE.md
44
- ├── .morph/
45
- │ ├── config/ # config.json, agents.json
46
- │ ├── standards/ # coding, architecture, stack-specific
47
- │ ├── templates/ # Output templates
48
- │ ├── project/
49
- │ │ ├── context/ # detection-log.md, project.md
50
- │ │ ├── standards/ # inferred.md, overrides.md
51
- │ │ └── outputs/{feature}/ # Features in development
52
- │ │ ├── proposal.md, spec.md, tasks.md
53
- │ │ ├── contracts, decisions.md, recap.md
54
- └── .claude/commands/ # Slash commands
55
- ```
56
-
57
- ---
58
-
59
- ## AGENTS
60
-
61
- ### Tier 1 — Orchestrators (Always Active)
62
-
63
- | Agent | Responsibilities |
64
- |-------|-----------------|
65
- | **Standards Architect** | Standards, naming, review, cross-cutting concerns |
66
- | **AI System Architect** | Agent systems, AI integrations, LLM orchestration |
67
- | **Thread Orchestrator** | Parallel execution, thread management, context optimization |
68
-
69
- ### Tier 2 — Domain Leaders
70
-
71
- | Agent | Responsibilities |
72
- |-------|-----------------|
73
- | **Tech Lead** | Architecture decisions, code quality, task breakdown |
74
- | **DevOps Engineer** | CI/CD, deployment pipelines, infrastructure |
75
- | **QA Lead** | Test strategies, validation, quality gates |
76
-
77
- ### Tier 3 Specialists (Activated by keywords)
78
-
79
- | Agent | Keywords |
80
- |-------|---------|
81
- | **Next.js Expert** | nextjs, react, frontend, app router, pages |
82
- | **Blazor Builder** | blazor, razor, mudblazor, fluent ui |
83
- | **API Designer** | api, endpoint, rest, openapi, swagger |
84
- | **.NET Senior** | dotnet, csharp, minimal api, ef core |
85
- | **EF Modeler** | entity framework, migrations, dbcontext |
86
- | **Azure Architect** | azure, container apps, bicep, app service |
87
- | **Bicep Architect** | bicep, iac, arm template, azure resources |
88
- | **Azure Deploy Specialist** | deploy, ci/cd, github actions, azure devops |
89
- | **Container Specialist** | docker, dockerfile, compose, kubernetes |
90
- | **Supabase Expert** | supabase, postgresql, rls, realtime, pgvector |
91
- | **Azure Identity** | auth, authentication, entra id, jwt, oauth |
92
- | **Clerk Auth** | clerk, auth0, authentication, social login |
93
- | **Asaas Financial** | payment, billing, subscription, asaas |
94
- | **Resend Email** | email, resend, smtp, notifications |
95
- | **Hangfire Orchestrator** | background jobs, queue, scheduling, hangfire |
96
- | **MS Agent Expert** | semantic kernel, microsoft agents, ai pipeline |
97
- | **UI/UX Designer** | design, ux, wireframe, mockup, figma |
98
- | **SEO Growth Hacker** | seo, performance, analytics, lighthouse |
99
- | **PO/PM Advisor** | product, roadmap, requirements, user stories |
100
- | **Prompt Engineer** | prompts, system prompts, llm, few-shot |
101
- | **Context Optimizer** | context window, token optimization, chunking |
102
- | **Vector Search Expert** | vector db, embeddings, semantic search, rag |
103
- | **Observability Expert** | logging, tracing, metrics, opentelemetry |
104
- | **Code Analyzer** | refactor, analysis, code review, complexity |
105
- | **Testing Specialist** | tests, coverage, tdd, bdd, vitest, jest, xunit |
106
-
107
- ### Tier 4 — Validators
108
-
109
- | Agent | Responsibilities |
110
- |-------|-----------------|
111
- | **Contract Compliance Validator** | Ensures implementation matches spec contracts |
112
-
113
- ---
114
-
115
- ## TEMPLATES
116
-
117
- > ALWAYS use `morph-spec template render` to render. NEVER fill placeholders manually.
118
-
119
- ### Placeholders: `{{PLACEHOLDER}}`
120
-
121
- | Placeholder | Example |
122
- |-------------|---------|
123
- | `{{FEATURE_NAME}}` | `scheduled-reports` |
124
- | `{{FEATURE_NAME_PASCAL}}` | `ScheduledReports` |
125
- | `{{FEATURE_NAME_CAMEL}}` | `scheduledReports` |
126
- | `{{STACK}}` | `blazor-azure` or `nextjs-supabase` |
127
- | `{{DATE}}`, `{{AUTHOR}}`, `{{NAMESPACE}}` | Auto from config.json |
128
-
129
- ---
130
-
131
- ## COMMANDS
132
-
133
- | Command | Action |
134
- |---------|--------|
135
- | `/morph-proposal {feature}` | Full spec pipeline (phases 1-4, auto-continuation with pauses) |
136
- | `/morph-apply {feature}` | Implement feature (phase 5) |
137
- | `/morph-status` | Dashboard |
138
- | `/morph-archive {feature}` | Archive completed feature |
139
- | `/morph-infra {action}` | Manage infrastructure |
140
- | `/morph-preflight` | Pre-deploy validation |
141
- | `/morph-troubleshoot {error}` | Error troubleshooting |
142
-
143
- ---
144
-
145
- ## REFERENCES
146
-
147
- - `.morph/config/config.json` — Project configuration
148
- - `.morph/config/agents.json` — Full agent definitions
149
- - `.morph/standards/` — Coding, architecture, stack-specific standards
150
- - `.morph/project/context/` — Detection log, project context
151
- - `.morph/project/standards/inferred.md` — Auto-detected project standards
152
-
153
- ---
154
-
155
- *MORPH-SPEC v4.3.0 by Polymorphism Tech*
1
+ # MORPH-SPEC Runtime Instructions
2
+
3
+ > by Polymorphism Tech — Spec-driven development for .NET/Blazor/Next.js/Azure
4
+
5
+ ---
6
+
7
+ ## Project Context
8
+
9
+ @.morph/context/README.md
10
+
11
+ ---
12
+
13
+ ## Critical Rules
14
+
15
+ **NEVER:**
16
+ - Skip to code without a specification
17
+ - Implement without design approval
18
+ - Ignore standards in `.morph/framework/standards/`
19
+ - Create infrastructure manually
20
+ - Generate code without defined contracts
21
+
22
+ **ALWAYS:**
23
+ - Follow the mandatory phases
24
+ - Generate outputs in `.morph/features/{feature}/`
25
+ - Document decisions in `decisions.md`
26
+ - Checkpoint every 3 implemented tasks
27
+ - Use Infrastructure as Code
28
+
29
+ ---
30
+
31
+ ## Quick Reference
32
+
33
+ | Command | Purpose |
34
+ |---------|---------|
35
+ | `/morph-proposal {feature}` | Full spec pipeline (phases 1–4, pauses for approval) |
36
+ | `/morph-apply {feature}` | Implement feature (phase 5) |
37
+ | `/morph-status` | Feature status dashboard |
38
+ | `/morph-preflight` | Pre-implementation validation |
39
+
40
+ ---
41
+
42
+ ## State & Outputs
43
+
44
+ | Path | Notes |
45
+ |------|-------|
46
+ | `.morph/state.json` | **READ-ONLY** — use `morph-spec` CLI to update |
47
+ | `.morph/features/{feature}/{phase}/` | Feature outputs organized by phase |
48
+ | `.morph/framework/` | **READ-ONLY** — framework files managed by morph-spec |
49
+ | `.morph/config/config.json` | Project configuration (editable) |
50
+
51
+ ---
52
+
53
+ ## Phase Sequence
54
+
55
+ ```
56
+ proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
57
+ ```
58
+
59
+ Use `morph-spec state show {feature}` to see current phase and pending approval gates.
60
+
61
+ ---
62
+
63
+ ## Agents
64
+
65
+ Tier-1 and tier-2 MORPH agents are available as native subagents in `.claude/agents/`.
66
+ They can be invoked directly by Claude Code during multi-agent workflows.
67
+
68
+ ---
69
+
70
+ ## Context Window Tip
71
+
72
+ When using 3+ MCPs, add `"experimental": { "mcpCliMode": true }` to `.claude/settings.json`.
73
+ MCP tools load on-demand instead of all at startup keeps context clean for actual work.
74
+
75
+ ---
76
+
77
+ *MORPH-SPEC v4.5.0 by Polymorphism Tech*
package/README.md CHANGED
@@ -84,7 +84,7 @@ MORPH-SPEC v3.0 torna o framework **explícito e orientado** para Claude Code co
84
84
  ### 8. **Interactive Decisions** (Decisões Estruturadas)
85
85
  - 💬 Templates para AskUserQuestion
86
86
  - 🎯 6 padrões documentados (scope, architecture, validation, etc.)
87
- - 📖 Guia completo em `.morph/templates/decision-prompts.md`
87
+ - 📖 Guia completo em `.morph/framework/templates/decision-prompts.md`
88
88
 
89
89
  **Configuração:** `.morph/config/llm-interaction.json` com 3 presets (strict, lightweight, no-guardrails)
90
90
 
@@ -246,9 +246,9 @@ npx @polymorphism-tech/morph-spec@latest update
246
246
  ### 3. O que é atualizado?
247
247
 
248
248
  O comando `update` sincroniza:
249
- - Templates (`.morph/templates/`)
250
- - Standards (`.morph/standards/`)
251
- - Agentes (`.morph/config/agents.json`)
249
+ - Templates (`.morph/framework/templates/`)
250
+ - Standards (`.morph/framework/standards/`)
251
+ - Agentes (`.morph/framework/agents.json`)
252
252
  - Comandos Claude (`.claude/commands/`)
253
253
  - Skills (`.claude/skills/`)
254
254
  - Instruções (CLAUDE.md)
@@ -497,20 +497,22 @@ seu-projeto/
497
497
  ├── CLAUDE.md # Instruções para o AI
498
498
  ├── .morph/
499
499
  │ ├── config/ # Configurações
500
- │ │ ├── config.json
501
- │ └── agents.json # 30 agentes em 4 tiers
502
- │ ├── standards/ # Padrões de código (26 arquivos)
503
- │ │ ├── coding.md
504
- │ │ ├── architecture.md
505
- │ │ ├── azure.md
506
- │ │ ├── blazor-*.md # Lifecycle, state, pitfalls, EF Core
507
- │ │ ├── css-*.md # Naming, animations
508
- │ │ ├── agent-framework-*.md # Setup, workflows, production, blazor-ui
509
- │ │ └── ...
510
- ├── templates/ # Templates de código e IaC
511
- │ │ ├── infra/
512
- │ │ ├── integrations/
513
- │ │ └── saas/
500
+ │ │ └── config.json
501
+ ├── framework/
502
+ ├── agents.json # 30 agentes em 4 tiers
503
+ │ │ ├── standards/ # Padrões de código (26 arquivos)
504
+ │ │ ├── coding.md
505
+ │ │ ├── architecture.md
506
+ │ │ ├── azure.md
507
+ │ │ ├── blazor-*.md # Lifecycle, state, pitfalls, EF Core
508
+ │ │ ├── css-*.md # Naming, animations
509
+ │ │ │ ├── agent-framework-*.md # Setup, workflows, production, blazor-ui
510
+ │ │ └── ...
511
+ │ │ └── templates/ # Templates de código e IaC
512
+ │ │ ├── infra/
513
+ │ │ ├── integrations/
514
+ │ │ └── saas/
515
+ │ ├── context/ # Contexto do projeto e overrides
514
516
  │ ├── features/ # Features em desenvolvimento
515
517
  │ └── archive/ # Features concluídas
516
518
  └── .claude/
@@ -18,7 +18,7 @@ import { fileURLToPath } from 'url';
18
18
 
19
19
  const __dirname = dirname(fileURLToPath(import.meta.url));
20
20
  const frameworkRoot = join(__dirname, '..');
21
- const AGENTS_CONFIG_PATH = join(frameworkRoot, '.morph/config/agents.json');
21
+ const AGENTS_CONFIG_PATH = join(frameworkRoot, '.morph/framework/agents.json');
22
22
 
23
23
  // Cores para output no terminal
24
24
  const colors = {