@polymorphism-tech/morph-spec 4.5.0 → 4.7.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 (292) hide show
  1. package/CLAUDE.md +77 -56
  2. package/README.md +394 -700
  3. package/docs/ARCHITECTURE.md +331 -0
  4. package/docs/CHEATSHEET.md +221 -0
  5. package/docs/COMMAND-FLOWS.md +368 -0
  6. package/docs/QUICKSTART.md +212 -0
  7. package/docs/examples/order-management/contracts.cs +84 -0
  8. package/docs/examples/order-management/proposal.md +24 -0
  9. package/docs/examples/order-management/spec.md +162 -0
  10. package/docs/plans/2026-02-23-ddd-architecture-refactor.md +1153 -0
  11. package/docs/plans/2026-02-23-ddd-nextsteps.md +682 -0
  12. package/docs/plans/2026-02-23-infra-architect-refactor.md +437 -0
  13. package/docs/plans/2026-02-23-nextjs-code-review-design.md +156 -0
  14. package/docs/plans/2026-02-23-nextjs-code-review-impl.md +1254 -0
  15. package/docs/plans/2026-02-23-nextjs-standards-design.md +149 -0
  16. package/docs/plans/2026-02-23-nextjs-standards-impl.md +1846 -0
  17. package/framework/{skills/level-2-domains → agents}/README.md +14 -14
  18. package/framework/{skills/level-2-domains → agents}/ai-agents/ai-system-architect.md +1 -4
  19. package/framework/{skills/level-2-domains → agents}/architecture/po-pm-advisor.md +1 -2
  20. package/framework/{skills/level-2-domains → agents}/architecture/prompt-engineer.md +1 -2
  21. package/framework/{skills/level-2-domains → agents}/architecture/seo-growth-hacker.md +1 -2
  22. package/framework/{skills/level-2-domains → agents}/architecture/standards-architect.md +159 -162
  23. package/framework/agents/backend/api-designer.md +103 -0
  24. package/framework/{skills/level-2-domains → agents}/backend/dotnet-senior.md +1 -2
  25. package/framework/agents/backend/ef-modeler.md +119 -0
  26. package/framework/{skills/level-2-domains → agents}/backend/hangfire-orchestrator.md +1 -4
  27. package/framework/{skills/level-2-domains → agents}/backend/ms-agent-expert.md +1 -4
  28. package/framework/{skills/level-2-domains → agents}/frontend/blazor-builder.md +1 -4
  29. package/framework/agents/frontend/nextjs-expert.md +118 -0
  30. package/framework/{skills/level-2-domains → agents}/frontend/ui-ux-designer.md +1 -2
  31. package/framework/{skills/level-2-domains → agents}/infrastructure/azure-architect.md +147 -148
  32. package/framework/{skills/level-2-domains → agents}/infrastructure/azure-deploy-specialist.md +1 -2
  33. package/framework/{skills/level-2-domains → agents}/infrastructure/bicep-architect.md +1 -4
  34. package/framework/{skills/level-2-domains → agents}/infrastructure/container-specialist.md +1 -4
  35. package/framework/{skills/level-2-domains → agents}/infrastructure/devops-engineer.md +1 -4
  36. package/framework/agents/infrastructure/infra-architect.md +45 -0
  37. package/framework/{skills/level-2-domains → agents}/integrations/asaas-financial.md +1 -4
  38. package/framework/{skills/level-2-domains → agents}/integrations/azure-identity.md +1 -4
  39. package/framework/{skills/level-2-domains → agents}/integrations/clerk-auth.md +1 -4
  40. package/framework/{skills/level-2-domains → agents}/integrations/hangfire-integration.md +1 -2
  41. package/framework/{skills/level-2-domains → agents}/integrations/resend-email.md +1 -4
  42. package/framework/{skills/level-2-domains → agents}/quality/code-analyzer.md +1 -4
  43. package/framework/{skills/level-2-domains → agents}/quality/testing-specialist.md +1 -4
  44. package/framework/agents.json +1145 -278
  45. package/framework/hooks/claude-code/statusline.py +384 -85
  46. package/framework/hooks/shared/phase-utils.js +129 -129
  47. package/framework/rules/frontend-standards.md +0 -3
  48. package/framework/rules/nextjs-standards.md +17 -0
  49. package/framework/skills/README.md +66 -0
  50. package/framework/skills/level-0-meta/{brainstorming.md → brainstorming/SKILL.md} +3 -1
  51. package/framework/skills/level-0-meta/brainstorming/references/proposal-example.md +138 -0
  52. package/framework/skills/level-0-meta/{code-review.md → code-review/SKILL.md} +3 -2
  53. package/framework/skills/level-0-meta/code-review/references/review-example.md +164 -0
  54. package/framework/skills/level-0-meta/code-review/scripts/scan-csharp.mjs +121 -0
  55. package/framework/skills/level-0-meta/code-review-nextjs/SKILL.md +147 -0
  56. package/framework/skills/level-0-meta/code-review-nextjs/references/review-example-nextjs.md +254 -0
  57. package/framework/skills/level-0-meta/{morph-checklist.md → morph-checklist/SKILL.md} +2 -5
  58. package/framework/skills/{level-1-workflows/morph-replicate.md → level-0-meta/morph-replicate/SKILL.md} +6 -7
  59. package/framework/skills/level-0-meta/{simulation-checklist.md → simulation-checklist/SKILL.md} +3 -6
  60. package/framework/skills/level-0-meta/{tool-usage-guide.md → tool-usage-guide/SKILL.md} +4 -5
  61. package/framework/skills/level-0-meta/{verification-before-completion.md → verification-before-completion/SKILL.md} +3 -1
  62. package/framework/skills/level-0-meta/verification-before-completion/scripts/check-phase-outputs.mjs +110 -0
  63. package/framework/skills/level-1-workflows/{phase-clarify.md → phase-clarify/SKILL.md} +3 -3
  64. package/framework/skills/level-1-workflows/phase-clarify/references/clarifications-example.md +117 -0
  65. package/framework/skills/level-1-workflows/{phase-codebase-analysis.md → phase-codebase-analysis/SKILL.md} +2 -3
  66. package/framework/skills/level-1-workflows/{phase-design.md → phase-design/SKILL.md} +46 -182
  67. package/framework/skills/level-1-workflows/phase-design/references/spec-example.md +253 -0
  68. package/framework/skills/level-1-workflows/{phase-implement.md → phase-implement/SKILL.md} +3 -3
  69. package/framework/skills/level-1-workflows/phase-implement/references/recap-example.md +132 -0
  70. package/framework/skills/level-1-workflows/{phase-setup.md → phase-setup/SKILL.md} +2 -3
  71. package/framework/skills/level-1-workflows/{phase-tasks.md → phase-tasks/SKILL.md} +42 -3
  72. package/framework/skills/level-1-workflows/phase-tasks/references/tasks-example.md +231 -0
  73. package/framework/skills/level-1-workflows/phase-tasks/scripts/validate-tasks.mjs +112 -0
  74. package/framework/skills/level-1-workflows/{phase-uiux.md → phase-uiux/SKILL.md} +2 -3
  75. package/framework/standards/STANDARDS.json +121 -0
  76. package/framework/standards/architecture/ddd/bounded-contexts.md +105 -0
  77. package/framework/standards/architecture/ddd/complexity-levels.md +108 -0
  78. package/framework/standards/architecture/ddd/ubiquitous-language.md +58 -0
  79. package/framework/standards/frontend/nextjs/app-router.md +123 -0
  80. package/framework/standards/frontend/nextjs/components.md +132 -0
  81. package/framework/standards/frontend/nextjs/data-fetching.md +126 -0
  82. package/framework/standards/frontend/nextjs/forms.md +128 -0
  83. package/framework/standards/frontend/nextjs/naming-conventions.md +67 -0
  84. package/framework/standards/frontend/nextjs/project-structure.md +102 -0
  85. package/framework/standards/frontend/nextjs/state-management.md +72 -0
  86. package/framework/standards/frontend/nextjs/testing.md +111 -0
  87. package/framework/templates/REGISTRY.json +538 -142
  88. package/framework/templates/code/dotnet/contracts/contracts-level1.cs +69 -0
  89. package/framework/templates/code/dotnet/contracts/contracts-level2.cs +86 -0
  90. package/framework/templates/code/dotnet/contracts/contracts-level3.cs +41 -0
  91. package/framework/templates/docs/spec.md +49 -0
  92. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -0
  93. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -0
  94. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -0
  95. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -0
  96. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -0
  97. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -0
  98. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -0
  99. package/framework/templates/project-structure/dotnet-ddd.md +70 -0
  100. package/framework/workflows/docs/enforcement-pipeline.md +2 -1
  101. package/package.json +1 -1
  102. package/scripts/scan-nextjs.mjs +169 -0
  103. package/src/commands/project/doctor.js +52 -1
  104. package/src/commands/project/init.js +19 -65
  105. package/src/commands/project/update.js +7 -63
  106. package/src/lib/detectors/claude-config-detector.js +1 -3
  107. package/src/lib/standards/standards-context-injector.js +5 -0
  108. package/src/lib/validators/nextjs/index.js +6 -0
  109. package/src/lib/validators/nextjs/next-component-validator.js +181 -0
  110. package/src/lib/validators/validation-runner.js +5 -0
  111. package/src/utils/agents-installer.js +16 -4
  112. package/src/utils/skills-installer.js +59 -15
  113. package/.morph/.morphversion +0 -5
  114. package/.morph/analytics/threads-log.jsonl +0 -44
  115. package/.morph/config/config.json +0 -8
  116. package/.morph/context/README.md +0 -17
  117. package/.morph/framework/agents.json +0 -948
  118. package/.morph/framework/standards/STANDARDS.json +0 -812
  119. package/.morph/framework/standards/ai-agents/blazor-ui.md +0 -364
  120. package/.morph/framework/standards/ai-agents/production.md +0 -415
  121. package/.morph/framework/standards/ai-agents/setup.md +0 -418
  122. package/.morph/framework/standards/ai-agents/team-orchestration.md +0 -479
  123. package/.morph/framework/standards/ai-agents/workflows.md +0 -354
  124. package/.morph/framework/standards/architecture/ddd/aggregates.md +0 -120
  125. package/.morph/framework/standards/architecture/ddd/entities.md +0 -99
  126. package/.morph/framework/standards/architecture/ddd/value-objects.md +0 -124
  127. package/.morph/framework/standards/backend/api/minimal-api.md +0 -494
  128. package/.morph/framework/standards/backend/api/rest.md +0 -492
  129. package/.morph/framework/standards/backend/api/validation.md +0 -88
  130. package/.morph/framework/standards/backend/authentication/passkeys.md +0 -428
  131. package/.morph/framework/standards/backend/database/ef-core.md +0 -199
  132. package/.morph/framework/standards/backend/database/migrations.md +0 -393
  133. package/.morph/framework/standards/backend/database/postgresql/database.md +0 -352
  134. package/.morph/framework/standards/backend/database/repository-patterns.md +0 -528
  135. package/.morph/framework/standards/backend/database/vector-search-rag.md +0 -541
  136. package/.morph/framework/standards/backend/dotnet/async.md +0 -366
  137. package/.morph/framework/standards/backend/dotnet/core.md +0 -117
  138. package/.morph/framework/standards/backend/dotnet/di.md +0 -439
  139. package/.morph/framework/standards/backend/dotnet/program-cs-checklist.md +0 -92
  140. package/.morph/framework/standards/backend/integrations/asaas/asaas-api.md +0 -216
  141. package/.morph/framework/standards/backend/integrations/clerk/clerk-auth.md +0 -290
  142. package/.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -350
  143. package/.morph/framework/standards/backend/integrations/resend/resend-email.md +0 -385
  144. package/.morph/framework/standards/context/analytics.md +0 -96
  145. package/.morph/framework/standards/context/bundles.md +0 -110
  146. package/.morph/framework/standards/context/priming.md +0 -78
  147. package/.morph/framework/standards/core/architecture.md +0 -185
  148. package/.morph/framework/standards/core/coding.md +0 -214
  149. package/.morph/framework/standards/core/git-branching-strategy.md +0 -403
  150. package/.morph/framework/standards/core/git.md +0 -185
  151. package/.morph/framework/standards/core/testing.md +0 -295
  152. package/.morph/framework/standards/data/nosql/blob-storage.md +0 -102
  153. package/.morph/framework/standards/data/nosql/cache/redis.md +0 -97
  154. package/.morph/framework/standards/data/nosql/cosmos-db.md +0 -118
  155. package/.morph/framework/standards/data/vector-search/azure-ai-search.md +0 -121
  156. package/.morph/framework/standards/data/vector-search/rag-chunking.md +0 -104
  157. package/.morph/framework/standards/frontend/blazor/design-checklist.md +0 -222
  158. package/.morph/framework/standards/frontend/blazor/fluent-ui-setup.md +0 -595
  159. package/.morph/framework/standards/frontend/blazor/fluent-ui.md +0 -137
  160. package/.morph/framework/standards/frontend/blazor/html-conversion.md +0 -184
  161. package/.morph/framework/standards/frontend/blazor/lifecycle.md +0 -195
  162. package/.morph/framework/standards/frontend/blazor/pitfalls.md +0 -198
  163. package/.morph/framework/standards/frontend/blazor/state.md +0 -191
  164. package/.morph/framework/standards/frontend/design-system/animations.md +0 -151
  165. package/.morph/framework/standards/frontend/design-system/naming.md +0 -64
  166. package/.morph/framework/standards/frontend/nextjs/nextjs-patterns.md +0 -198
  167. package/.morph/framework/standards/infrastructure/azure/azure.md +0 -624
  168. package/.morph/framework/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -422
  169. package/.morph/framework/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -516
  170. package/.morph/framework/standards/infrastructure/azure/devops/local-development.md +0 -520
  171. package/.morph/framework/standards/infrastructure/azure/services/functions.md +0 -486
  172. package/.morph/framework/standards/infrastructure/azure/services/service-bus.md +0 -459
  173. package/.morph/framework/standards/infrastructure/azure/services/storage.md +0 -407
  174. package/.morph/framework/standards/infrastructure/docker/easypanel-deploy.md +0 -196
  175. package/.morph/framework/standards/infrastructure/supabase/mcp-setup.md +0 -252
  176. package/.morph/framework/standards/infrastructure/supabase/supabase-auth.md +0 -176
  177. package/.morph/framework/standards/infrastructure/supabase/supabase-pgvector.md +0 -169
  178. package/.morph/framework/standards/infrastructure/supabase/supabase-rls.md +0 -184
  179. package/.morph/framework/standards/infrastructure/supabase/supabase-storage.md +0 -153
  180. package/.morph/framework/standards/integration/api/graphql.md +0 -91
  181. package/.morph/framework/standards/integration/api/grpc.md +0 -114
  182. package/.morph/framework/standards/integration/api/rest-design.md +0 -95
  183. package/.morph/framework/standards/integration/event-driven/cqrs.md +0 -101
  184. package/.morph/framework/standards/integration/event-driven/event-sourcing.md +0 -124
  185. package/.morph/framework/standards/integration/event-driven/service-bus.md +0 -95
  186. package/.morph/framework/standards/integration/mcp/mcp-tools.md +0 -384
  187. package/.morph/framework/standards/observability/logging.md +0 -131
  188. package/.morph/framework/standards/observability/metrics.md +0 -121
  189. package/.morph/framework/standards/observability/monitoring.md +0 -114
  190. package/.morph/framework/standards/observability/tracing.md +0 -132
  191. package/.morph/framework/standards/workflows/parallel-execution.md +0 -112
  192. package/.morph/framework/standards/workflows/thread-management.md +0 -113
  193. package/.morph/framework/templates/.idea/morph-templates.xml +0 -92
  194. package/.morph/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  195. package/.morph/framework/templates/IDE-SNIPPETS.md +0 -266
  196. package/.morph/framework/templates/README.md +0 -814
  197. package/.morph/framework/templates/REGISTRY.json +0 -1492
  198. package/.morph/framework/templates/code/dotnet/backend/repository.cs +0 -141
  199. package/.morph/framework/templates/code/dotnet/backend/service.cs +0 -139
  200. package/.morph/framework/templates/code/dotnet/contracts/Commands.cs +0 -74
  201. package/.morph/framework/templates/code/dotnet/contracts/Entities.cs +0 -25
  202. package/.morph/framework/templates/code/dotnet/contracts/Queries.cs +0 -74
  203. package/.morph/framework/templates/code/dotnet/contracts/README.md +0 -74
  204. package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs +0 -173
  205. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  206. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs +0 -172
  207. package/.morph/framework/templates/code/dotnet/database/migration.cs +0 -83
  208. package/.morph/framework/templates/code/dotnet/frontend/component.razor +0 -239
  209. package/.morph/framework/templates/code/dotnet/jobs/agent.cs +0 -163
  210. package/.morph/framework/templates/code/dotnet/jobs/job.cs +0 -171
  211. package/.morph/framework/templates/code/dotnet/test.cs +0 -239
  212. package/.morph/framework/templates/code/sql/rls-policy.sql +0 -57
  213. package/.morph/framework/templates/code/sql/supabase-migration.sql +0 -100
  214. package/.morph/framework/templates/code/sql/supabase-migration.template.sql +0 -113
  215. package/.morph/framework/templates/code/typescript/contracts.ts +0 -168
  216. package/.morph/framework/templates/context/CONTEXT-FEATURE.md +0 -276
  217. package/.morph/framework/templates/context/CONTEXT.md +0 -181
  218. package/.morph/framework/templates/docs/clarifications.md +0 -253
  219. package/.morph/framework/templates/docs/onboarding.md +0 -123
  220. package/.morph/framework/templates/docs/proposal.md +0 -182
  221. package/.morph/framework/templates/docs/schema-analysis.md +0 -119
  222. package/.morph/framework/templates/docs/spec.md +0 -149
  223. package/.morph/framework/templates/docs/ui-components.md +0 -124
  224. package/.morph/framework/templates/docs/ui-design-system.md +0 -76
  225. package/.morph/framework/templates/docs/ui-flows.md +0 -167
  226. package/.morph/framework/templates/docs/ui-mockups.md +0 -98
  227. package/.morph/framework/templates/examples/design-system-examples.md +0 -357
  228. package/.morph/framework/templates/examples/spec-examples.md +0 -90
  229. package/.morph/framework/templates/feature/decisions.md +0 -187
  230. package/.morph/framework/templates/feature/recap.md +0 -146
  231. package/.morph/framework/templates/feature/tasks.md +0 -199
  232. package/.morph/framework/templates/infrastructure/azure/Dockerfile.example +0 -82
  233. package/.morph/framework/templates/infrastructure/azure/README.md +0 -286
  234. package/.morph/framework/templates/infrastructure/azure/app-insights.bicep +0 -63
  235. package/.morph/framework/templates/infrastructure/azure/app-service.bicep +0 -164
  236. package/.morph/framework/templates/infrastructure/azure/container-app-env.bicep +0 -49
  237. package/.morph/framework/templates/infrastructure/azure/container-app.bicep +0 -156
  238. package/.morph/framework/templates/infrastructure/azure/deploy-checklist.md +0 -426
  239. package/.morph/framework/templates/infrastructure/azure/deploy.ps1 +0 -229
  240. package/.morph/framework/templates/infrastructure/azure/deploy.sh +0 -208
  241. package/.morph/framework/templates/infrastructure/azure/key-vault.bicep +0 -91
  242. package/.morph/framework/templates/infrastructure/azure/main.bicep +0 -189
  243. package/.morph/framework/templates/infrastructure/azure/parameters.dev.json +0 -29
  244. package/.morph/framework/templates/infrastructure/azure/parameters.prod.json +0 -29
  245. package/.morph/framework/templates/infrastructure/azure/parameters.staging.json +0 -29
  246. package/.morph/framework/templates/infrastructure/azure/sql-database.bicep +0 -103
  247. package/.morph/framework/templates/infrastructure/azure/storage.bicep +0 -106
  248. package/.morph/framework/templates/infrastructure/docker/Dockerfile.template +0 -58
  249. package/.morph/framework/templates/infrastructure/docker/docker-compose.template.yml +0 -67
  250. package/.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +0 -38
  251. package/.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +0 -48
  252. package/.morph/framework/templates/infrastructure/docker/easypanel.template.json +0 -54
  253. package/.morph/framework/templates/infrastructure/github/README.md +0 -593
  254. package/.morph/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -22
  255. package/.morph/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -45
  256. package/.morph/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +0 -27
  257. package/.morph/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +0 -61
  258. package/.morph/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -31
  259. package/.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -59
  260. package/.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -39
  261. package/.morph/framework/templates/integrations/asaas-client.cs +0 -387
  262. package/.morph/framework/templates/integrations/asaas-webhook.cs +0 -351
  263. package/.morph/framework/templates/integrations/azure-identity-config.cs +0 -288
  264. package/.morph/framework/templates/integrations/clerk-config.cs +0 -258
  265. package/.morph/framework/templates/meta-prompts/fusion/fusion-agent.md +0 -76
  266. package/.morph/framework/templates/meta-prompts/fusion/fusion-aggregator.md +0 -100
  267. package/.morph/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
  268. package/.morph/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
  269. package/.morph/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
  270. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  271. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  272. package/.morph/framework/templates/meta-prompts/squad-leaders/backend-squad.md +0 -90
  273. package/.morph/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +0 -126
  274. package/.morph/framework/templates/meta-prompts/squad-leaders/squad-leader.md +0 -43
  275. package/.morph/framework/templates/meta-prompts/validators/checkpoint-validator.md +0 -107
  276. package/.morph/framework/templates/meta-prompts/validators/pre-commit-validator.md +0 -95
  277. package/.morph/framework/templates/saas/subscription.cs +0 -347
  278. package/.morph/framework/templates/saas/tenant.cs +0 -338
  279. package/.morph/framework/templates/state.template.json +0 -17
  280. package/.morph/framework/templates/ui/FluentDesignTheme.cs +0 -149
  281. package/.morph/framework/templates/ui/MudTheme.cs +0 -281
  282. package/.morph/framework/templates/ui/design-system.css +0 -226
  283. package/.morph/logs/tool-failures.log +0 -51
  284. package/.morph/memory/pre-compact-2026-02-22T17-01-01-658Z.json +0 -16
  285. package/.morph/state.json +0 -48
  286. package/framework/skills/level-2-domains/backend/api-designer.md +0 -66
  287. package/framework/skills/level-2-domains/backend/ef-modeler.md +0 -65
  288. package/framework/skills/level-2-domains/frontend/nextjs-expert.md +0 -161
  289. package/framework/skills/level-3-technologies/README.md +0 -7
  290. package/framework/skills/level-4-patterns/README.md +0 -7
  291. package/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  292. package/framework/templates/code/dotnet/contracts/contracts.cs.hbs +0 -172
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: phase-design
3
- description: >
4
- MORPH-SPEC Phase 2 (Design). Expands the approved proposal into spec.md, contracts.cs, decisions.md, and schema-analysis.md. Called by /morph-proposal after setup completes.
3
+ description: MORPH-SPEC Phase 2 (Design). Analyzes codebase/schema, then produces spec.md, contracts-level{N}.cs, schema-analysis.md, and decisions.md for the feature. Use after setup phase to create a full technical specification with C# contracts based on the real database schema and architecture decision records.
5
4
  argument-hint: "[feature-name]"
6
5
  user-invocable: false
7
6
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
@@ -21,8 +20,9 @@ Expanda a proposta em especificação técnica completa, contracts, decisões ar
21
20
 
22
21
  ## Ferramentas Recomendadas
23
22
 
24
- > **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
23
+ > **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
25
24
  > **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
25
+ > **Example:** `references/spec-example.md` — filled-in spec.md showing expected output quality.
26
26
 
27
27
  | Ação | Ferramenta | Alternativa |
28
28
  |------|------------|-------------|
@@ -35,7 +35,7 @@ Expanda a proposta em especificação técnica completa, contracts, decisões ar
35
35
  | Ler arquivos de query/tipos (fallback) | **Read** cada arquivo encontrado | — |
36
36
  | Pesquisar biblioteca para ADR | **Context7 MCP** `query_docs()` | **WebSearch** + **WebFetch** |
37
37
  | Buscar padrões no código | **GitHub MCP** `search_code()` | **Grep** padrões no projeto |
38
- | Renderizar template contracts.cs | **Bash** `npx morph-spec template render code/dotnet/contracts/contracts.cs ...` | — |
38
+ | Renderizar template contracts (nível detectado) | **Bash** `npx morph-spec template render code/dotnet/contracts/contracts-level{N}.cs ...` onde N = nível detectado no Passo 1.5 | — |
39
39
  | Renderizar template spec.md | **Bash** `npx morph-spec template render docs/spec ...` | — |
40
40
  | Renderizar template decisions.md | **Bash** `npx morph-spec template render docs/decisions ...` | — |
41
41
  | Criar schema-analysis.md | **Write** no diretório de outputs | — |
@@ -47,7 +47,7 @@ Expanda a proposta em especificação técnica completa, contracts, decisões ar
47
47
  - ❌ Adivinhar nomes de campos sem verificar schema (use MCP ou Grep primeiro!)
48
48
  - ❌ Task agent para ler um único arquivo spec (use Read direto)
49
49
  - ❌ WebSearch para schema do banco (use Supabase MCP ou análise de código)
50
- - ❌ Escrever contracts.cs do zero (use template render)
50
+ - ❌ Escrever contracts-level{N}.cs do zero (use template render)
51
51
 
52
52
  ---
53
53
 
@@ -71,199 +71,63 @@ Parse o JSON para obter `activeAgents`, então use standards context (já carreg
71
71
 
72
72
  **Use standards context ao gerar spec.md:**
73
73
  - Architecture standards → guiam Technical Architecture section
74
- - Coding standards → definem contracts.cs patterns
74
+ - Coding standards → definem contracts-level{N}.cs patterns
75
75
  - Azure standards → determinam Infrastructure Requirements
76
76
 
77
- ### Passo 2: Analisar Código Existente (CRÍTICO - FAZER ANTES DE CONTRACTS!)
78
-
79
- **⚠️ ATENÇÃO:** Este passo é OBRIGATÓRIO antes de gerar `contracts.cs`. Previne geração de DTOs com nomes de campos errados.
80
-
81
- #### 2.1. Detectar Se Análise É Necessária
82
-
83
- A análise de código é necessária se:
84
- - Feature interage com banco de dados existente
85
- - Feature usa APIs ou serviços existentes
86
- - Projeto tem código frontend/backend que será integrado
87
-
88
- **Pule este passo apenas se:**
89
- - Feature é 100% nova (sem dependências em código existente)
90
- - Não há banco de dados ou APIs envolvidas
91
-
92
- #### 2.2. Tentar MCP Tools Primeiro (Preferencial)
93
-
94
- **Se MCP Supabase disponível:**
77
+ ### Passo 1.5: Detectar Nível de Domínio (domain-architect)
95
78
 
96
- ```javascript
97
- // Verificar se MCP está disponível (procure por ferramentas mcp__supabase__*)
98
- // Se disponível, use para obter schema real:
79
+ **⚠️ OBRIGATÓRIO:** Execute antes de gerar qualquer contrato.
99
80
 
100
- // 1. Listar todas as tabelas
101
- await mcp__supabase__list_tables();
81
+ **Ref:** `framework/standards/architecture/ddd/complexity-levels.md`
102
82
 
103
- // 2. Para cada tabela relevante, obter schema completo
104
- await mcp__supabase__get_table_schema({ table: 'leads' });
105
- await mcp__supabase__get_table_schema({ table: 'users' });
83
+ O `domain-architect` analisa a `proposal.md` e responde às seguintes perguntas:
106
84
 
107
- // 3. Obter relacionamentos
108
- await mcp__supabase__get_relationships({ table: 'leads' });
109
-
110
- // 4. Documentar findings em SCHEMA-ANALYSIS.md
111
85
  ```
112
-
113
- **Se MCP Database/ORM disponível:**
114
- - Use ferramentas MCP equivalentes para PostgreSQL, MySQL, EF Core, etc.
115
- - Obtenha schema diretamente do banco
116
-
117
- #### 2.3. Fallback: Análise Manual de Código
118
-
119
- **Se MCP não disponível, use análise estática:**
120
-
121
- **Passo A: Encontrar Queries no Código**
122
-
123
- ```bash
124
- # Use Grep tool para encontrar todas as queries:
125
- pattern: "\.from\(|\.select\(|SELECT |supabase\.|context\.|dbContext\.|ef\.Database\."
126
- type: "ts,tsx,js,jsx,cs"
127
- output_mode: "files_with_matches"
128
- ```
129
-
130
- **Passo B: Ler Arquivos de Query**
131
-
132
- Para cada arquivo encontrado, use Read tool para extrair:
133
- - **Nomes de tabelas:** `from('leads')`, `DbSet<Lead>`, `FROM leads`
134
- - **Nomes de colunas:** `.select('fullname, phonenumber')`, `l.FullName`, `SELECT full_name`
135
- - **Tipos de dados:** TypeScript interfaces, C# DTOs, column types
136
- - **Relacionamentos:** JOIN clauses, navigation properties, foreign keys
137
-
138
- **Passo C: Encontrar Type Definitions**
139
-
140
- ```bash
141
- # TypeScript/JavaScript projects:
142
- Glob: "src/**/types/**/*.ts"
143
- Glob: "src/**/*.d.ts"
144
- Glob: "src/**/interfaces/*.ts"
145
-
146
- # .NET projects:
147
- Glob: "**/*Dto.cs"
148
- Glob: "**/Entities/**/*.cs"
149
- Glob: "**/Models/**/*.cs"
86
+ 1. A entidade principal tem estados com transições? (Draft → Confirmed → Shipped)
87
+ 2. Existem invariants de negócio? ("só cancela se estiver Ativo")
88
+ 3. Cálculos derivados existem? (Total, Saldo, Desconto)
89
+ 4. Outros módulos precisam reagir a mudanças? (Domain Events com consumidores)
90
+ 5. O usuário declarou explicitamente Bounded Context na proposta?
91
+
92
+ → Nenhuma acima: Nível 1 (CRUD)
93
+ 1-4 verdadeiros: Nível 2 (Business Logic)
94
+ → 5 verdadeiro OU múltiplos domínios com modelos conflitantes: Nível 3 (BC)
150
95
  ```
151
96
 
152
- Leia cada arquivo e mapeie:
153
- - Interface/Type → Database Table
154
- - Property names → Column names
155
- - Data types → SQL types
156
-
157
- **Passo D: Inferir Schema Real**
158
-
159
- Com base nos arquivos lidos, criar um mapa:
160
-
161
- ```markdown
162
- | Frontend/Code | Database | Type | Notes |
163
- |--------------|----------|------|-------|
164
- | user.name | users.fullname | string | MISMATCH! |
165
- | lead.phone | leads.phonenumber | string | MISMATCH! |
166
- | order.metadata | orders.metadata | JSONB | Complex type |
167
- | user.orders | users → orders (1:N) | relation | Foreign key: orders.user_id |
168
- ```
97
+ **Documente no spec.md** (seção `## Domain Complexity`) antes de continuar para o Passo 3.
169
98
 
170
- #### 2.4. Criar SCHEMA-ANALYSIS.md
99
+ **Template a usar no Passo 4 (contracts-level{N}.cs):**
171
100
 
172
- Documente os findings em `.morph/features/$ARGUMENTS/1-design/schema-analysis.md`:
101
+ | Nível | Template |
102
+ |-------|----------|
103
+ | 1 | `code/dotnet/contracts/contracts-level1.cs` |
104
+ | 2 | `code/dotnet/contracts/contracts-level2.cs` |
105
+ | 3 | `code/dotnet/contracts/contracts-level3.cs` |
173
106
 
174
- ```markdown
175
- # Schema Analysis - {Feature Name}
176
-
177
- **Date:** {DATE}
178
- **Method:** {MCP Supabase / Manual Code Analysis}
179
-
180
- ## Tables Analyzed
181
-
182
- ### Table: leads
183
-
184
- **Source:**
185
- - MCP: supabase.list_tables()
186
- - Code: src/lib/database/queries.ts
187
-
188
- **Columns:**
189
- | Column Name | Type | Nullable | Default | Notes |
190
- |------------|------|----------|---------|-------|
191
- | id | uuid | NO | gen_random_uuid() | Primary key |
192
- | fullname | varchar(255) | NO | - | NOT 'name'! |
193
- | phonenumber | varchar(20) | YES | - | NOT 'phone'! |
194
- | metadata | jsonb | YES | {} | Complex object |
195
- | created_at | timestamptz | NO | now() | Auto-generated |
196
- | user_id | uuid | YES | - | FK to users table |
197
-
198
- **Relationships:**
199
- - leads.user_id → users.id (N:1)
200
- - leads.id ← roulette_spins.lead_id (1:N)
201
-
202
- **Indexes:**
203
- - PRIMARY KEY (id)
204
- - INDEX idx_leads_user_id ON (user_id)
205
-
206
- ### Table: users
207
- {Repetir para cada tabela}
208
-
209
- ## ⚠️ CRITICAL FINDINGS
210
-
211
- **Field Name Mismatches (MUST FIX):**
212
- - ❌ Use `fullname`, NOT `name` (column doesn't exist!)
213
- - ❌ Use `phonenumber`, NOT `phone` (column doesn't exist!)
214
-
215
- **Type Mismatches:**
216
- - ⚠️ `metadata` is JSONB, not `Record<string, string>` (use proper type)
217
-
218
- **Relationship Corrections:**
219
- - ✅ Lead → User is N:1 (NOT 1:1)
220
- - ✅ Lead → RouletteSpins is 1:N (NOT 1:1)
221
-
222
- ## Recommendations for contracts.cs
223
-
224
- Based on real schema, DTOs should use:
225
- \`\`\`csharp
226
- public record LeadDto(
227
- Guid Id,
228
- string Fullname, // NOT 'Name'!
229
- string? Phonenumber, // NOT 'Phone'! Nullable!
230
- JsonObject? Metadata, // NOT Record<string,string>!
231
- Guid? UserId, // Nullable FK
232
- DateTime CreatedAt
233
- );
234
- \`\`\`
235
- ```
107
+ **Para Nível 2+:** Preencha o `## Aggregate Blueprint` no spec.md antes de gerar contracts-level{N}.cs.
236
108
 
237
- #### 2.5. CHECKPOINT OBRIGATÓRIO: Revisar Schema Analysis
109
+ **Para Nível 3:** Adicione `BOUNDED_CONTEXT` como variável ao renderizar o template.
238
110
 
239
- **⏸️ PAUSE - Validar findings antes de continuar:**
111
+ ---
240
112
 
241
- Apresente ao usuário:
242
- - [ ] Analisei {N} arquivos de código
243
- - [ ] Identifiquei {N} tabelas: {lista}
244
- - [ ] Encontrei {N} field name mismatches
245
- - [ ] Encontrei {N} type mismatches
246
- - [ ] Mapeei {N} relacionamentos
247
- - [ ] Criei `schema-analysis.md` com todos os findings
113
+ ### Passo 2: Analisar Código Existente (CRÍTICO - FAZER ANTES DE CONTRACTS!)
248
114
 
249
- **Perguntas ao usuário:**
250
- 1. "O schema analysis está correto?"
251
- 2. "Encontrei field mismatches (fullname vs name). Confirma?"
252
- 3. "Posso prosseguir para gerar contracts.cs com base nesse schema real?"
115
+ **⚠️ ATENÇÃO:** Este passo é OBRIGATÓRIO antes de gerar `contracts-level{N}.cs`. Previne geração de DTOs com nomes de campos errados.
253
116
 
254
- **❌ Se usuário responder "Não" ou encontrar erros:**
255
- → VOLTAR e revisar análise
256
- → Corrigir schema-analysis.md
257
- → Re-apresentar para aprovação
117
+ **Delegate para skill dedicada:**
258
118
 
259
- **✅ Se usuário aprovar:**
260
- → Prosseguir para Passo 3 (Gerar spec.md)
119
+ > **Ref:** `framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md` — workflow completo de análise de schema (MCP Supabase → fallback análise estática → SCHEMA-ANALYSIS.md → checkpoint de aprovação)
261
120
 
262
- #### 2.6. Atualizar State
121
+ Execute o workflow de `phase-codebase-analysis.md` para:
122
+ 1. Detectar se análise é necessária
123
+ 2. Tentar MCP Supabase (preferencial) ou análise estática (fallback)
124
+ 3. Mapear field name mismatches e type mismatches
125
+ 4. Gerar `schema-analysis.md` com findings reais
126
+ 5. Apresentar checkpoint ao usuário e aguardar aprovação
263
127
 
264
- ```bash
265
- npx morph-spec state mark-output $ARGUMENTS schema-analysis
266
- ```
128
+ **Pule se:**
129
+ - Feature é 100% nova (sem dependências em código existente)
130
+ - Não há banco de dados ou APIs envolvidas
267
131
 
268
132
  ### Passo 3: Gerar `spec.md`
269
133
 
@@ -311,7 +175,7 @@ Se houver recursos Azure:
311
175
 
312
176
  **SEMPRE usar Bicep para infra!**
313
177
 
314
- ### Passo 4: Gerar `contracts.cs` (BASEADO NO SCHEMA REAL!)
178
+ ### Passo 4: Gerar `contracts-level{N}.cs` (BASEADO NO SCHEMA REAL!)
315
179
 
316
180
  **⚠️ IMPORTANTE:** Use `schema-analysis.md` (do Passo 2) para gerar DTOs corretos!
317
181
 
@@ -320,7 +184,7 @@ Se houver recursos Azure:
320
184
  ```bash
321
185
  # Use o template de contracts com dados do schema-analysis.md:
322
186
  npx morph-spec template render \
323
- code/dotnet/contracts/contracts.cs \
187
+ code/dotnet/contracts/contracts-level{N}.cs \
324
188
  .morph/features/$ARGUMENTS/1-design/contracts.cs \
325
189
  '{
326
190
  "FEATURE_NAME": "$ARGUMENTS",
@@ -336,7 +200,7 @@ npx morph-spec template render \
336
200
 
337
201
  ```bash
338
202
  # Leia o template base:
339
- Read: .morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs
203
+ Read: .morph/framework/templates/code/dotnet/contracts/contracts-level{N}.cs.hbs
340
204
 
341
205
  # Preencha manualmente usando dados de schema-analysis.md
342
206
  # Template contém placeholders para:
@@ -440,7 +304,7 @@ Apresente ao usuário 3 ações sugeridas:
440
304
  ## Critérios de Avanço
441
305
 
442
306
  - [x] `spec.md` completo com todos os requisitos
443
- - [x] `contracts.cs` com interfaces e DTOs
307
+ - [x] `contracts-level{N}.cs` com interfaces e DTOs
444
308
  - [x] `decisions.md` com ADRs relevantes
445
309
  - [x] Custos estimados e documentados (se houver infra)
446
310
  - [x] State atualizado
@@ -0,0 +1,253 @@
1
+ # Feature Specification: Photo Processing Pipeline
2
+
3
+ > Example of a well-structured spec.md. This is a filled-in reference — not a template.
4
+
5
+ | Field | Value |
6
+ |-------|-------|
7
+ | **ID** | photo-processing |
8
+ | **Status** | Approved |
9
+ | **Created** | 2025-01-15 |
10
+ | **Stack** | blazor-azure |
11
+ | **Complexity** | Medium |
12
+ | **Estimated Cost** | ~$5.50/month |
13
+ | **Agents** | Core: All / Specialists: azure-architect, dotnet-senior, blazor-builder |
14
+
15
+ ---
16
+
17
+ ## Overview
18
+
19
+ **Problem:** Users cannot submit photos for AI transformation — the core product value proposition is blocked.
20
+
21
+ **Solution:** End-to-end pipeline: upload → Blob Storage → Hangfire background job → AI processing → download link.
22
+
23
+ **Success Criteria:**
24
+ - [ ] Upload endpoint accepts .jpg/.png up to 10MB and stores in Azure Blob
25
+ - [ ] Background job processes photo and updates status to Completed within 120s (p95)
26
+ - [ ] Status polling page reflects real-time processing progress
27
+ - [ ] Failed jobs retry up to 3 times with exponential backoff
28
+
29
+ ---
30
+
31
+ ## Requirements
32
+
33
+ **Functional:**
34
+ FR1: Upload photo (.jpg/.png, max 10MB) via Blazor form
35
+ FR2: Store photo in Azure Blob Storage under `uploads/{jobId}`
36
+ FR3: Enqueue Hangfire background job for AI processing
37
+ FR4: Status polling endpoint returns `{ status, progress, createdAt }`
38
+ FR5: Download endpoint redirects to Blob URL for completed jobs
39
+
40
+ **Non-Functional:**
41
+ NFR1: Processing time < 120s for p95 of requests
42
+ NFR2: Upload endpoint < 2s response time
43
+ NFR3: Retry 3x on AI API failure with 5s/30s/120s backoff
44
+
45
+ ---
46
+
47
+ ## User Stories
48
+
49
+ ### US001: Upload Photo
50
+ **As** an authenticated user **I want** to upload a photo **so that** the AI can transform it.
51
+
52
+ **Acceptance Criteria:**
53
+ 1. Accepts .jpg and .png files only — rejects other formats with clear error
54
+ 2. Rejects files larger than 10MB with a specific error message
55
+ 3. Returns a `jobId` and redirects to `/processing/{jobId}` on success
56
+
57
+ **Edge Cases:**
58
+ - Network timeout during upload: show retry button
59
+ - Duplicate upload: create new job each time (idempotency not required)
60
+
61
+ ### US002: Track Progress
62
+ **As** a user who uploaded a photo **I want** to see real-time status **so that** I know when my photo is ready.
63
+
64
+ **Acceptance Criteria:**
65
+ 1. Page polls `/api/status/{jobId}` every 5 seconds
66
+ 2. Shows status label: Pending / Processing / Completed / Failed
67
+ 3. Shows "Download" button when status = Completed
68
+
69
+ ---
70
+
71
+ ## Technical Design
72
+
73
+ ### Stack
74
+
75
+ | Component | Technology |
76
+ |-----------|------------|
77
+ | Frontend | Blazor Server |
78
+ | Backend | .NET 10 / C# 14 Minimal API |
79
+ | Background Jobs | Hangfire (self-hosted) |
80
+ | Storage | Azure Blob Storage (LRS) |
81
+ | Database | Azure SQL |
82
+
83
+ ### Data Model
84
+
85
+ #### ProcessingJob
86
+
87
+ | Column | Type | Constraints |
88
+ |--------|------|-------------|
89
+ | Id | Guid | PK, default NEWID() |
90
+ | OriginalPhotoUrl | nvarchar(500) | NOT NULL |
91
+ | ProcessedPhotoUrl | nvarchar(500) | NULL (populated after processing) |
92
+ | Status | int | NOT NULL, default 0 (Pending) |
93
+ | ErrorMessage | nvarchar(1000) | NULL |
94
+ | RetryCount | int | NOT NULL, default 0 |
95
+ | CreatedAt | datetime2 | NOT NULL, default GETUTCDATE() |
96
+ | UpdatedAt | datetime2 | NOT NULL |
97
+
98
+ #### ProcessingStatus Enum
99
+
100
+ ```csharp
101
+ public enum ProcessingStatus
102
+ {
103
+ Pending = 0,
104
+ Processing = 1,
105
+ Completed = 2,
106
+ Failed = 100
107
+ }
108
+ ```
109
+
110
+ ### Contracts
111
+
112
+ ```csharp
113
+ // Commands
114
+ public record UploadPhotoCommand(IFormFile Photo, string? Email);
115
+ public record UploadPhotoResult(Guid JobId);
116
+
117
+ // Queries
118
+ public record GetJobStatusQuery(Guid JobId);
119
+ public record JobStatusDto(Guid JobId, ProcessingStatus Status, string? ProcessedPhotoUrl, DateTime CreatedAt);
120
+
121
+ // Service Interface
122
+ public interface IPhotoProcessingService
123
+ {
124
+ Task<UploadPhotoResult> UploadAsync(UploadPhotoCommand command, CancellationToken ct);
125
+ Task<JobStatusDto> GetStatusAsync(GetJobStatusQuery query, CancellationToken ct);
126
+ }
127
+
128
+ // Hangfire Job
129
+ public interface IPhotoProcessingJob
130
+ {
131
+ Task ProcessAsync(Guid jobId, CancellationToken ct);
132
+ }
133
+ ```
134
+
135
+ ---
136
+
137
+ ## UI/UX Design
138
+
139
+ ### Upload Page (/upload)
140
+
141
+ ```
142
+ ┌─────────────────────────────────────┐
143
+ │ Upload Photo │
144
+ │ ───────────────────────────────── │
145
+ │ [📁 Select File] photo.jpg (2.3MB) │
146
+ │ │
147
+ │ Allowed: JPG, PNG — Max: 10MB │
148
+ │ │
149
+ │ [Upload →] │
150
+ │ │
151
+ │ Error state: │
152
+ │ ⚠ File too large. Max size is 10MB. │
153
+ └─────────────────────────────────────┘
154
+ ```
155
+
156
+ ### Status Page (/processing/{jobId})
157
+
158
+ ```
159
+ ┌─────────────────────────────────────┐
160
+ │ Processing your photo │
161
+ │ ───────────────────────────────── │
162
+ │ Status: ⏳ Processing │
163
+ │ ████████░░░░░░░ 60% │
164
+ │ │
165
+ │ Started: 2025-01-15 14:32:01 │
166
+ │ │
167
+ │ [Completed state]: │
168
+ │ Status: ✅ Done! │
169
+ │ [📥 Download] │
170
+ └─────────────────────────────────────┘
171
+ ```
172
+
173
+ ---
174
+
175
+ ## Flows
176
+
177
+ ### Upload Flow
178
+ **Trigger:** User submits photo form
179
+
180
+ 1. User selects file → client validates type/size before submit
181
+ 2. `POST /api/upload` — server validates, uploads to Blob at `uploads/{jobId}/original.jpg`
182
+ 3. Create `ProcessingJob` entity (status = Pending)
183
+ 4. Enqueue Hangfire job with `jobId`
184
+ 5. Return `{ jobId }` → client redirects to `/processing/{jobId}`
185
+
186
+ **End State:** Job queued, user on status page
187
+
188
+ ### Processing Flow
189
+ **Trigger:** Hangfire executes job
190
+
191
+ 1. Load `ProcessingJob` by Id, set status = Processing
192
+ 2. Download original from Blob Storage
193
+ 3. Call AI API (`POST /transform`, multipart/form-data)
194
+ 4. On success: upload result to `uploads/{jobId}/processed.jpg`, set status = Completed
195
+ 5. On failure: increment RetryCount, set status = Failed if RetryCount >= 3
196
+
197
+ **End State:** Job = Completed (photo available) or Failed (user sees error)
198
+
199
+ ---
200
+
201
+ ## Cost Estimate
202
+
203
+ | Resource | SKU | Monthly | Justification |
204
+ |----------|-----|---------|---------------|
205
+ | Blob Storage | LRS | $0.02 | ~500 photos/month × 2 files × avg 3MB |
206
+ | Azure SQL | Basic | $4.99 | < 100k jobs/month |
207
+ | Container App | Consumption | $0.49 | Scale to zero when idle |
208
+ | Hangfire | Self-hosted | $0.00 | In-process with Container App |
209
+ | **Total** | | **~$5.50** | |
210
+
211
+ ---
212
+
213
+ ## ADRs
214
+
215
+ ### ADR-001: Hangfire over Azure Functions for Background Processing
216
+ **Status:** Accepted
217
+ **Context:** Need async processing for AI photo transformation (30–120s duration).
218
+ **Decision:** Hangfire (self-hosted in Container App)
219
+ **Alternatives:**
220
+ 1. Azure Functions — serverless, auto-scaling, but cold start latency + $10/mo for 50k executions
221
+ 2. Quartz.NET — more features (CRON, clustering), steeper learning curve
222
+ **Trade-offs:** Simplicity + zero cost vs scalability (Hangfire sufficient for MVP < 10k/month)
223
+
224
+ ### ADR-002: Polling over WebSockets for Status Updates
225
+ **Status:** Accepted
226
+ **Context:** Users need real-time feedback; SSE/WebSocket adds Blazor Hub complexity.
227
+ **Decision:** 5-second HTTP polling from Blazor component
228
+ **Trade-offs:** Slightly higher server load vs significantly simpler implementation; polling sufficient at MVP scale
229
+
230
+ ---
231
+
232
+ ## Security
233
+
234
+ | Action | Required Policy |
235
+ |--------|-----------------|
236
+ | Upload | Authenticated user |
237
+ | View status | Owner of job (check UserId) |
238
+ | Download | Owner of job (check UserId) |
239
+
240
+ ---
241
+
242
+ ## Definition of Done
243
+
244
+ - [ ] Upload endpoint working, validated with unit + integration tests
245
+ - [ ] Hangfire job processes photos end-to-end in dev environment
246
+ - [ ] Status page shows correct states (Pending/Processing/Completed/Failed)
247
+ - [ ] Code review approved
248
+ - [ ] Deployed to staging environment
249
+ - [ ] `recap.md` generated with implementation notes
250
+
251
+ ---
252
+
253
+ *MORPH-SPEC by Polymorphism Tech*
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: phase-implement
3
- description: >
4
- MORPH-SPEC Phase 5 (Implement). Executes tasks.md task-by-task with checkpoint validation every 3 tasks, producing code and recap.md. Called by /morph-apply.
3
+ description: MORPH-SPEC Phase 5 (Implement). Executes feature tasks using TDD with checkpoint validation every 3 tasks, smoke tests via Playwright, and generates code + recap.md. Use after task list approval when starting feature implementation.
5
4
  argument-hint: "[feature-name]"
6
5
  disable-model-invocation: true
7
6
  context: fork
@@ -25,8 +24,9 @@ Implemente as tasks definidas na FASE 4, com checkpoints a cada 3 tasks e recap
25
24
 
26
25
  ## Ferramentas Recomendadas
27
26
 
28
- > **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
27
+ > **Ref:** `framework/skills/level-0-meta/tool-usage-guide/SKILL.md` para guia completo.
29
28
  > **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
29
+ > **Example:** `references/recap-example.md` — filled-in recap.md showing expected output quality.
30
30
 
31
31
  | Ação | Ferramenta | Alternativa |
32
32
  |------|------------|-------------|