@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,948 +0,0 @@
1
- {
2
- "$schema": "./agent-schema.json",
3
- "version": "3.1.0-hierarchical",
4
- "total_agents": 37,
5
- "tiers": {
6
- "tier_1_orchestrators": 3,
7
- "tier_2_leaders": 3,
8
- "tier_3_specialists": 26,
9
- "tier_4_validators": 5
10
- },
11
-
12
- "agents": {
13
-
14
- "_comment_tier_1": "=== TIER 1: ORCHESTRATORS (3) ===",
15
-
16
- "standards-architect": {
17
- "tier": 1,
18
- "role": "orchestrator",
19
- "title": "Chief Architect",
20
- "domains": ["architecture", "developer-experience"],
21
- "keywords": [],
22
- "always_active": true,
23
- "validators": ["architecture", "packages"],
24
- "relationships": {
25
- "reports_to": "user",
26
- "coordinates": ["dotnet-senior", "azure-architect", "ui-designer", "testing-specialist", "code-analyzer", "troubleshooting-expert", "documentation-specialist", "load-testing-expert"],
27
- "escalates_to": "user",
28
- "team_role": "lead"
29
- },
30
- "standards": ["core/coding.md", "core/architecture.md", "backend/dotnet/program-cs-checklist.md"],
31
- "teammate": {
32
- "role": "Team Lead (Delegate Mode)",
33
- "icon": "🎯",
34
- "spawn_prompt": "You are the Chief Architect and Team Lead in delegate mode. Coordinate Domain Leaders, resolve conflicts, synthesize results. DO NOT implement code yourself. Escalate conflicts to user when teammates disagree on architecture/tech choices."
35
- }
36
- },
37
-
38
- "ai-system-architect": {
39
- "tier": 1,
40
- "role": "orchestrator",
41
- "title": "AI/Agent Architect",
42
- "domains": ["ai-orchestration", "architecture"],
43
- "keywords": ["agent system", "ai architecture", "orchestration", "multi-agent", "agent workflow"],
44
- "always_active": false,
45
- "validators": ["architecture"],
46
- "relationships": {
47
- "reports_to": "standards-architect",
48
- "coordinates": ["ms-agent-expert"],
49
- "escalates_to": "standards-architect",
50
- "collaborates_with": ["dotnet-senior"],
51
- "team_role": "orchestrator"
52
- },
53
- "standards": ["core/coding.md", "core/architecture.md", "ai-agents/setup.md", "ai-agents/workflows.md", "ai-agents/production.md", "ai-agents/blazor-ui.md"],
54
- "teammate": {
55
- "role": "AI Architect",
56
- "icon": "🤖",
57
- "spawn_prompt": "You are the AI/Agent System Architect. Design agent workflows, tool integrations, and orchestration patterns. Coordinate with ms-agent-expert for implementation."
58
- }
59
- },
60
-
61
- "popm-advisor": {
62
- "tier": 1,
63
- "role": "orchestrator",
64
- "title": "Product/Project Advisor",
65
- "domains": ["requirements", "business-value"],
66
- "keywords": ["unclear", "requirements", "priority", "roi", "business value", "user story"],
67
- "always_active": false,
68
- "validators": [],
69
- "relationships": {
70
- "reports_to": "user",
71
- "coordinates": [],
72
- "team_role": "planning_only",
73
- "active_phases": ["proposal", "setup", "design"]
74
- },
75
- "standards": ["core/coding.md", "core/architecture.md"],
76
- "teammate": null
77
- },
78
-
79
- "_comment_tier_2": "=== TIER 2: DOMAIN LEADERS (3) ===",
80
-
81
- "dotnet-senior": {
82
- "tier": 2,
83
- "role": "domain-leader",
84
- "title": "Backend Squad Leader",
85
- "domains": ["backend"],
86
- "keywords": ["backend", "api", "dotnet", ".net", "csharp", "c#", "web api", "minimal api"],
87
- "always_active": true,
88
- "validators": ["architecture", "packages"],
89
- "relationships": {
90
- "reports_to": "standards-architect",
91
- "coordinates": ["ef-modeler", "event-architect", "api-designer", "nosql-cache-expert", "ddd-expert", "hangfire-orchestrator", "ms-agent-expert", "asaas-financial", "clerk-auth", "resend-email"],
92
- "escalates_to": "standards-architect",
93
- "collaborates_with": ["azure-architect", "blazor-builder", "nextjs-expert"],
94
- "team_role": "domain_leader"
95
- },
96
- "standards": ["core/coding.md", "core/architecture.md", "backend/dotnet/core.md", "backend/dotnet/program-cs-checklist.md"],
97
- "teammate": {
98
- "role": "Backend Squad Leader",
99
- "icon": "⚙️",
100
- "spawn_prompt": "You are the Backend Squad Leader. Coordinate backend specialists (ef-modeler, event-architect, api-designer, etc.). Assign tasks, review designs, enforce backend standards. Escalate cross-domain conflicts to standards-architect."
101
- }
102
- },
103
-
104
- "azure-architect": {
105
- "tier": 2,
106
- "role": "domain-leader",
107
- "title": "Infrastructure Squad Leader",
108
- "domains": ["infrastructure"],
109
- "keywords": ["infrastructure/azure/azure", "cloud", "infrastructure", "infra", "deployment", "hosting"],
110
- "always_active": true,
111
- "validators": ["architecture"],
112
- "relationships": {
113
- "reports_to": "standards-architect",
114
- "coordinates": ["bicep-architect", "devops-engineer", "container-specialist", "observability-expert", "azure-identity"],
115
- "escalates_to": "standards-architect",
116
- "collaborates_with": ["dotnet-senior", "blazor-builder", "nextjs-expert"],
117
- "team_role": "domain_leader"
118
- },
119
- "standards": ["core/coding.md", "core/architecture.md", "azure.md"],
120
- "teammate": {
121
- "role": "Infrastructure Squad Leader",
122
- "icon": "☁️",
123
- "spawn_prompt": "You are the Infrastructure Squad Leader. Coordinate infra specialists (bicep-architect, devops-engineer, container-specialist, observability-expert). Focus on Azure resources, IaC, CI/CD, cost optimization. Escalate to standards-architect if conflicts."
124
- }
125
- },
126
-
127
- "ui-designer": {
128
- "tier": 2,
129
- "role": "domain-leader",
130
- "title": "UI/UX Squad Leader",
131
- "domains": ["frontend-design"],
132
- "keywords": ["wireframe", "mockup", "user flow", "ux", "design", "interface design", "user experience", "page", "dashboard", "form", "UI", "settings", "interface", "screen", "panel", "portal", "view"],
133
- "always_active": false,
134
- "validators": ["design-system", "contrast"],
135
- "relationships": {
136
- "reports_to": "standards-architect",
137
- "coordinates": ["blazor-builder", "nextjs-expert", "css-specialist"],
138
- "escalates_to": "standards-architect",
139
- "collaborates_with": ["dotnet-senior"],
140
- "team_role": "domain_leader",
141
- "active_phases": ["uiux"]
142
- },
143
- "standards": ["frontend/blazor/fluent-ui.md", "mudblazor-blazor.md", "frontend/design-system/naming.md", "frontend/design-system/animations.md"],
144
- "teammate": {
145
- "role": "UI/UX Squad Leader (FASE 1.5)",
146
- "icon": "🎨",
147
- "spawn_prompt": "You are the UI/UX Squad Leader for FASE 1.5. Create wireframes, mockups, user flows. Define design system (colors, typography, spacing). Coordinate with blazor-builder or nextjs-expert for stack-specific patterns. Work is AGNOSTIC (no implementation code)."
148
- }
149
- },
150
-
151
- "_comment_tier_3_backend": "=== TIER 3: BACKEND SPECIALISTS (10) ===",
152
-
153
- "ef-modeler": {
154
- "tier": 3,
155
- "role": "specialist",
156
- "title": "Data Persistence Specialist (Relational)",
157
- "domains": ["backend-data"],
158
- "keywords": ["entity", "database", "migration", "ef core", "entity framework", "sql", "dbcontext"],
159
- "always_active": true,
160
- "validators": ["architecture", "blazor-concurrency"],
161
- "relationships": {
162
- "reports_to": "dotnet-senior",
163
- "coordinates": [],
164
- "escalates_to": "dotnet-senior",
165
- "collaborates_with": ["blazor-builder", "nextjs-expert", "api-designer", "nosql-cache-expert"],
166
- "team_role": "specialist"
167
- },
168
- "standards": ["core/coding.md", "backend/database/ef-core.md", "backend/dotnet/core.md"],
169
- "teammate": {
170
- "role": "Data Persistence Specialist",
171
- "icon": "🗄️",
172
- "spawn_prompt": "You are the Data Persistence Specialist (EF Core). Focus on Models/, Migrations/, DbContext. Follow blazor-efcore.md standards. Use IDbContextFactory for background ops. Message blazor-builder when entities ready for UI binding."
173
- }
174
- },
175
-
176
- "event-architect": {
177
- "tier": 3,
178
- "role": "specialist",
179
- "title": "Event-Driven Architecture Specialist",
180
- "domains": ["backend-events"],
181
- "keywords": ["event", "service bus", "rabbitmq", "cqrs", "event sourcing", "messaging", "pub/sub", "domain events", "saga", "real-time", "realtime", "websocket", "live updates"],
182
- "always_active": false,
183
- "validators": ["architecture", "event-driven"],
184
- "relationships": {
185
- "reports_to": "dotnet-senior",
186
- "coordinates": [],
187
- "escalates_to": "dotnet-senior",
188
- "collaborates_with": ["ddd-expert", "api-designer", "azure-architect"],
189
- "team_role": "specialist"
190
- },
191
- "standards": ["core/coding.md", "core/architecture.md"],
192
- "teammate": {
193
- "role": "Event-Driven Architecture Specialist",
194
- "icon": "📨",
195
- "spawn_prompt": "You are the Event-Driven Architecture Specialist. Implement Azure Service Bus queues/topics, CQRS patterns, Event Sourcing, Domain Events. Design idempotent handlers, dead letter queues, saga patterns. Collaborate with ddd-expert for event design."
196
- }
197
- },
198
-
199
- "api-designer": {
200
- "tier": 3,
201
- "role": "specialist",
202
- "title": "API Design Specialist",
203
- "domains": ["backend-api"],
204
- "keywords": ["rest", "graphql", "grpc", "api", "openapi", "swagger", "versioning", "rate limiting", "hot chocolate", "endpoint"],
205
- "always_active": false,
206
- "validators": ["architecture", "api-design"],
207
- "relationships": {
208
- "reports_to": "dotnet-senior",
209
- "coordinates": [],
210
- "escalates_to": "dotnet-senior",
211
- "collaborates_with": ["ef-modeler", "event-architect", "blazor-builder", "nextjs-expert"],
212
- "team_role": "specialist"
213
- },
214
- "standards": ["core/coding.md", "core/architecture.md"],
215
- "teammate": {
216
- "role": "API Design Specialist",
217
- "icon": "🔌",
218
- "spawn_prompt": "You are the API Design Specialist. Design REST APIs (resource naming, HTTP verbs, status codes), GraphQL schemas with Hot Chocolate, gRPC .proto files. Add OpenAPI/Swagger annotations. Implement API versioning, rate limiting. Review with frontend specialists."
219
- }
220
- },
221
-
222
- "nosql-cache-expert": {
223
- "tier": 3,
224
- "role": "specialist",
225
- "title": "NoSQL & Cache Specialist",
226
- "domains": ["backend-nosql"],
227
- "keywords": ["cosmos", "cosmosdb", "redis", "cache", "blob storage", "nosql", "document db", "key-value", "azure storage"],
228
- "always_active": false,
229
- "validators": ["architecture"],
230
- "relationships": {
231
- "reports_to": "dotnet-senior",
232
- "coordinates": [],
233
- "escalates_to": "dotnet-senior",
234
- "collaborates_with": ["ef-modeler", "azure-architect"],
235
- "team_role": "specialist"
236
- },
237
- "standards": ["core/coding.md", "core/architecture.md"],
238
- "teammate": {
239
- "role": "NoSQL & Cache Specialist",
240
- "icon": "💾",
241
- "spawn_prompt": "You are the NoSQL & Cache Specialist. Implement Azure Cosmos DB (SQL API, partition keys, RUs), Redis Cache (cache-aside, read-through, write-behind), Blob Storage (hot/cool/archive tiers). Design cache invalidation strategies."
242
- }
243
- },
244
-
245
- "ddd-expert": {
246
- "tier": 3,
247
- "role": "specialist",
248
- "title": "Domain-Driven Design Expert",
249
- "domains": ["backend-ddd"],
250
- "keywords": ["ddd", "domain driven design", "aggregate", "entity", "value object", "domain event", "bounded context", "ubiquitous language"],
251
- "always_active": false,
252
- "validators": ["architecture", "ddd"],
253
- "relationships": {
254
- "reports_to": "dotnet-senior",
255
- "coordinates": [],
256
- "escalates_to": "dotnet-senior",
257
- "collaborates_with": ["ef-modeler", "event-architect", "api-designer"],
258
- "team_role": "specialist"
259
- },
260
- "standards": ["core/coding.md", "core/architecture.md"],
261
- "teammate": {
262
- "role": "DDD Expert",
263
- "icon": "📐",
264
- "spawn_prompt": "You are the Domain-Driven Design Expert. Design Aggregates (consistency boundaries), distinguish Entities vs Value Objects, define Domain Events. Map Bounded Contexts, enforce Ubiquitous Language. Design Anti-Corruption Layers (ACL) for external integrations."
265
- }
266
- },
267
-
268
- "hangfire-orchestrator": {
269
- "tier": 3,
270
- "role": "specialist",
271
- "title": "Background Jobs Specialist",
272
- "domains": ["backend-jobs"],
273
- "keywords": ["scheduled", "job", "background", "cron", "hangfire", "recurring", "fire and forget", "delayed"],
274
- "always_active": false,
275
- "validators": ["architecture", "blazor-concurrency"],
276
- "relationships": {
277
- "reports_to": "dotnet-senior",
278
- "coordinates": [],
279
- "escalates_to": "dotnet-senior",
280
- "collaborates_with": ["ef-modeler", "azure-architect"],
281
- "team_role": "specialist"
282
- },
283
- "standards": ["core/coding.md", "core/architecture.md"],
284
- "teammate": {
285
- "role": "Background Jobs Specialist",
286
- "icon": "⏰",
287
- "spawn_prompt": "You are the Background Jobs Specialist (Hangfire). Implement fire-and-forget jobs, delayed jobs, recurring jobs (cron), continuations (chaining). Configure retry policies, queue management. Use IDbContextFactory for scoped operations."
288
- }
289
- },
290
-
291
- "ms-agent-expert": {
292
- "tier": 3,
293
- "role": "specialist",
294
- "title": "Microsoft Agent Framework Expert",
295
- "domains": ["ai-agents"],
296
- "keywords": ["agent", "ai", "llm", "rag", "embedding", "mcp", "a2a", "middleware", "microsoft agent framework", "ichatclient"],
297
- "always_active": false,
298
- "validators": ["architecture", "packages"],
299
- "relationships": {
300
- "reports_to": "ai-system-architect",
301
- "coordinates": [],
302
- "escalates_to": "ai-system-architect",
303
- "collaborates_with": ["dotnet-senior", "azure-architect"],
304
- "team_role": "specialist"
305
- },
306
- "standards": ["core/coding.md", "ai-agents/setup.md", "ai-agents/workflows.md", "ai-agents/production.md", "ai-agents/blazor-ui.md"],
307
- "teammate": {
308
- "role": "Microsoft Agent Framework Expert",
309
- "icon": "🤖",
310
- "spawn_prompt": "You are the Microsoft Agent Framework Expert. Implement ChatClientAgent, AIFunctionFactory, agent workflows (sequential, handoff, group chat). Integrate MCP tools (McpClientFactory, ListToolsAsync, Cast<AITool>). Host agents via A2A protocol (MapA2A, agent cards). Add middleware pipeline, observability (WithOpenTelemetry)."
311
- }
312
- },
313
-
314
- "supabase-expert": {
315
- "tier": 3,
316
- "role": "specialist",
317
- "title": "Supabase & PostgreSQL Specialist",
318
- "domains": ["backend-supabase"],
319
- "keywords": ["supabase", "postgresql", "rls", "realtime", "pgvector", "row level security", "edge functions"],
320
- "always_active": false,
321
- "validators": ["architecture", "packages"],
322
- "relationships": {
323
- "reports_to": "dotnet-senior",
324
- "coordinates": [],
325
- "escalates_to": "dotnet-senior",
326
- "collaborates_with": ["nextjs-expert", "vector-search-expert", "ef-modeler"],
327
- "team_role": "specialist"
328
- },
329
- "standards": ["core/coding.md", "core/architecture.md"],
330
- "teammate": {
331
- "role": "Supabase & PostgreSQL Specialist",
332
- "icon": "🐘",
333
- "spawn_prompt": "You are the Supabase & PostgreSQL Specialist. Implement Supabase Auth (magic links, OAuth, JWT), Row Level Security (RLS policies), Realtime subscriptions, Edge Functions (Deno/TypeScript). Use pgvector for embeddings/similarity search. Design efficient schemas with proper indexing. Coordinate with nextjs-expert for frontend integration."
334
- }
335
- },
336
-
337
- "vector-search-expert": {
338
- "tier": 3,
339
- "role": "specialist",
340
- "title": "Vector Search & RAG Specialist",
341
- "domains": ["ai-vector"],
342
- "keywords": ["vector db", "embeddings", "semantic search", "rag", "pgvector", "similarity search", "retrieval augmented"],
343
- "always_active": false,
344
- "validators": ["architecture"],
345
- "relationships": {
346
- "reports_to": "ai-system-architect",
347
- "coordinates": [],
348
- "escalates_to": "ai-system-architect",
349
- "collaborates_with": ["ms-agent-expert", "supabase-expert", "context-optimizer"],
350
- "team_role": "specialist"
351
- },
352
- "standards": ["core/coding.md", "ai-agents/setup.md", "ai-agents/workflows.md"],
353
- "teammate": {
354
- "role": "Vector Search & RAG Specialist",
355
- "icon": "🔎",
356
- "spawn_prompt": "You are the Vector Search & RAG Specialist. Implement vector embeddings (OpenAI, Azure AI), similarity search (pgvector, Azure AI Search), RAG pipelines (chunking, embedding, retrieval). Design hybrid search (vector + full-text). Optimize embedding dimensions and index types (HNSW, IVFFlat). Collaborate with ms-agent-expert for agent integration and supabase-expert for pgvector storage."
357
- }
358
- },
359
-
360
- "context-optimizer": {
361
- "tier": 3,
362
- "role": "specialist",
363
- "title": "Context & Token Optimization Specialist",
364
- "domains": ["ai-context"],
365
- "keywords": ["context window", "token optimization", "chunking", "context compression", "summarization", "token budget"],
366
- "always_active": false,
367
- "validators": [],
368
- "relationships": {
369
- "reports_to": "ai-system-architect",
370
- "coordinates": [],
371
- "escalates_to": "ai-system-architect",
372
- "collaborates_with": ["ms-agent-expert", "vector-search-expert"],
373
- "team_role": "specialist"
374
- },
375
- "standards": ["core/coding.md", "ai-agents/workflows.md"],
376
- "teammate": {
377
- "role": "Context & Token Optimization Specialist",
378
- "icon": "🧠",
379
- "spawn_prompt": "You are the Context & Token Optimization Specialist. Optimize context windows (sliding window, summarization, selective inclusion), implement token counting and budget management, design chunking strategies (semantic, fixed-size, recursive). Reduce costs through prompt caching, context compression. Coordinate with vector-search-expert for retrieval-based context building."
380
- }
381
- },
382
-
383
- "asaas-financial": {
384
- "tier": 3,
385
- "role": "specialist",
386
- "title": "Payment Integration Specialist (Brazil)",
387
- "domains": ["integration-payment"],
388
- "keywords": ["asaas", "payment", "pix", "boleto", "credit card", "subscription", "pagamento"],
389
- "always_active": false,
390
- "validators": ["architecture", "contract-compliance"],
391
- "relationships": {
392
- "reports_to": "dotnet-senior",
393
- "coordinates": [],
394
- "escalates_to": "dotnet-senior",
395
- "collaborates_with": ["blazor-builder", "nextjs-expert"],
396
- "team_role": "specialist"
397
- },
398
- "standards": ["core/coding.md", "core/architecture.md"],
399
- "teammate": {
400
- "role": "Payment Integration Specialist",
401
- "icon": "💳",
402
- "spawn_prompt": "You are the Payment Integration Specialist (Asaas SDK for Brazil). Implement PIX payments, Boleto generation, Credit Card processing, Subscription management. Follow contract-compliance validator patterns for SDK usage."
403
- }
404
- },
405
-
406
- "clerk-auth": {
407
- "tier": 3,
408
- "role": "specialist",
409
- "title": "Auth SaaS Integration Specialist",
410
- "domains": ["integration-auth"],
411
- "keywords": ["clerk", "clerk auth", "add auth", "implement auth", "login", "signup", "oauth"],
412
- "negativeKeywords": ["existing auth", "current auth", "integrate with auth", "already have auth"],
413
- "always_active": false,
414
- "validators": ["architecture"],
415
- "relationships": {
416
- "reports_to": "dotnet-senior",
417
- "coordinates": [],
418
- "escalates_to": "dotnet-senior",
419
- "collaborates_with": ["blazor-builder", "nextjs-expert", "azure-identity"],
420
- "team_role": "specialist"
421
- },
422
- "standards": ["core/coding.md", "core/architecture.md"],
423
- "teammate": {
424
- "role": "Auth SaaS Integration Specialist",
425
- "icon": "🔐",
426
- "spawn_prompt": "You are the Auth SaaS Integration Specialist (Clerk SDK). Implement Clerk authentication flows (login, signup, OAuth), session management, user profile. Integrate with Blazor or Next.js frontend."
427
- }
428
- },
429
-
430
- "resend-email": {
431
- "tier": 3,
432
- "role": "specialist",
433
- "title": "Email Integration Specialist",
434
- "domains": ["integration-email"],
435
- "keywords": ["resend", "email", "transactional email", "email notification", "send email", "email template", "smtp"],
436
- "negativeKeywords": ["push notification", "in-app notification", "notification preference", "notification settings"],
437
- "always_active": false,
438
- "validators": ["architecture", "contract-compliance"],
439
- "relationships": {
440
- "reports_to": "dotnet-senior",
441
- "coordinates": [],
442
- "escalates_to": "dotnet-senior",
443
- "collaborates_with": ["hangfire-orchestrator"],
444
- "team_role": "specialist"
445
- },
446
- "standards": ["core/coding.md", "core/architecture.md"],
447
- "teammate": {
448
- "role": "Email Integration Specialist",
449
- "icon": "📧",
450
- "spawn_prompt": "You are the Email Integration Specialist (Resend SDK). Implement transactional emails, email templates, notification sending. Follow contract-compliance validator for SDK usage patterns."
451
- }
452
- },
453
-
454
- "_comment_tier_3_frontend": "=== TIER 3: FRONTEND SPECIALISTS (3) ===",
455
-
456
- "blazor-builder": {
457
- "tier": 3,
458
- "role": "specialist",
459
- "title": "Blazor Development Specialist",
460
- "domains": ["frontend-blazor"],
461
- "keywords": ["blazor", "razor", "server-side", "component", "fluent ui", "mudblazor", "signalr", "page", "view", "form"],
462
- "always_active": false,
463
- "validators": ["architecture", "blazor", "blazor-concurrency", "blazor-state", "css", "design-system"],
464
- "relationships": {
465
- "reports_to": "ui-designer",
466
- "coordinates": [],
467
- "escalates_to": "standards-architect",
468
- "collaborates_with": ["ef-modeler", "api-designer", "css-specialist"],
469
- "team_role": "specialist",
470
- "active_phases": ["uiux", "implement"]
471
- },
472
- "standards": ["core/coding.md", "frontend/blazor/lifecycle.md", "frontend/blazor/state.md", "frontend/blazor/pitfalls.md", "backend/database/ef-core.md", "frontend/blazor/fluent-ui.md", "mudblazor-blazor.md"],
473
- "teammate": {
474
- "role": "Blazor Development Specialist",
475
- "icon": "⚡",
476
- "spawn_prompt": "You are the Blazor Development Specialist. Build Blazor Server components (Fluent UI or MudBlazor). Follow component-per-file pattern, use @inject for DI, implement loading states and error boundaries. Integrate SignalR for real-time features. Message ef-modeler for data, css-specialist for design system validation."
477
- }
478
- },
479
-
480
- "nextjs-expert": {
481
- "tier": 3,
482
- "role": "specialist",
483
- "title": "Next.js Development Specialist",
484
- "domains": ["frontend-nextjs"],
485
- "keywords": ["nextjs", "next.js", "react", "api", "frontend", "shadcn", "tanstack", "server actions"],
486
- "always_active": false,
487
- "validators": ["packages"],
488
- "relationships": {
489
- "reports_to": "ui-designer",
490
- "coordinates": [],
491
- "escalates_to": "standards-architect",
492
- "collaborates_with": ["api-designer", "css-specialist"],
493
- "team_role": "specialist",
494
- "active_phases": ["uiux", "implement"]
495
- },
496
- "standards": ["core/coding.md", "backend/dotnet/core.md"],
497
- "teammate": {
498
- "role": "Next.js Development Specialist",
499
- "icon": "⚛️",
500
- "spawn_prompt": "You are the Next.js Development Specialist. Build Next.js 14+ applications with shadcn/ui components, TanStack Query for data fetching, Server Actions for mutations. Implement Route Handlers for API routes. Message api-designer for backend endpoints, css-specialist for design system."
501
- }
502
- },
503
-
504
- "css-specialist": {
505
- "tier": 3,
506
- "role": "specialist",
507
- "title": "CSS & Design System Specialist",
508
- "domains": ["frontend-css"],
509
- "keywords": ["css", "design system", "styling", "theme", "design tokens", "palette"],
510
- "always_active": false,
511
- "validators": ["css", "contrast", "design-system"],
512
- "relationships": {
513
- "reports_to": "ui-designer",
514
- "coordinates": [],
515
- "escalates_to": "ui-designer",
516
- "collaborates_with": ["blazor-builder", "nextjs-expert"],
517
- "team_role": "specialist",
518
- "active_phases": ["implement"]
519
- },
520
- "standards": ["frontend/design-system/naming.md", "frontend/design-system/animations.md"],
521
- "teammate": {
522
- "role": "CSS & Design System Specialist",
523
- "icon": "🎨",
524
- "spawn_prompt": "You are the CSS & Design System Specialist (FASE 5 only). Validate CSS follows design system (no off-palette colors), review naming conventions (BEM), ensure no inline styles with hardcoded values. Run design-system, css, contrast validators."
525
- }
526
- },
527
-
528
- "_comment_tier_3_infra": "=== TIER 3: INFRASTRUCTURE SPECIALISTS (4) ===",
529
-
530
- "bicep-architect": {
531
- "tier": 3,
532
- "role": "specialist",
533
- "title": "Infrastructure as Code Specialist",
534
- "domains": ["infrastructure-iac"],
535
- "keywords": ["bicep", "iac", "infra", "provision", "arm template", "infrastructure as code"],
536
- "always_active": true,
537
- "validators": ["architecture"],
538
- "relationships": {
539
- "reports_to": "azure-architect",
540
- "coordinates": [],
541
- "escalates_to": "azure-architect",
542
- "collaborates_with": ["devops-engineer", "container-specialist"],
543
- "team_role": "specialist"
544
- },
545
- "standards": ["core/coding.md", "core/architecture.md", "azure.md"],
546
- "teammate": {
547
- "role": "Infrastructure as Code Specialist",
548
- "icon": "📜",
549
- "spawn_prompt": "You are the Infrastructure as Code Specialist (Bicep). Write main.bicep, modules/*.bicep, parameters.{env}.json. Never create Azure resources manually. Collaborate with azure-architect for resource design, devops-engineer for CI/CD integration."
550
- }
551
- },
552
-
553
- "devops-engineer": {
554
- "tier": 3,
555
- "role": "specialist",
556
- "title": "CI/CD Specialist",
557
- "domains": ["infrastructure-cicd"],
558
- "keywords": ["pipeline", "ci/cd", "deploy", "release", "github actions", "azure pipelines", "deployment"],
559
- "always_active": false,
560
- "validators": ["architecture"],
561
- "relationships": {
562
- "reports_to": "azure-architect",
563
- "coordinates": [],
564
- "escalates_to": "azure-architect",
565
- "collaborates_with": ["bicep-architect", "container-specialist"],
566
- "team_role": "specialist"
567
- },
568
- "standards": ["core/coding.md", "core/architecture.md"],
569
- "teammate": {
570
- "role": "CI/CD Specialist",
571
- "icon": "🚀",
572
- "spawn_prompt": "You are the CI/CD Specialist. Build Azure Pipelines or GitHub Actions workflows. Implement Blue-Green, Canary, Rolling deployment strategies. Integrate with bicep-architect for IaC deployment, container-specialist for image builds."
573
- }
574
- },
575
-
576
- "container-specialist": {
577
- "tier": 3,
578
- "role": "specialist",
579
- "title": "Containerization Specialist",
580
- "domains": ["infrastructure-containers"],
581
- "keywords": ["docker", "container", "containerize", "dockerfile", "multi-stage", "container apps"],
582
- "always_active": false,
583
- "validators": ["architecture"],
584
- "relationships": {
585
- "reports_to": "azure-architect",
586
- "coordinates": [],
587
- "escalates_to": "azure-architect",
588
- "collaborates_with": ["bicep-architect", "devops-engineer"],
589
- "team_role": "specialist"
590
- },
591
- "standards": ["core/coding.md", "core/architecture.md"],
592
- "teammate": {
593
- "role": "Containerization Specialist",
594
- "icon": "🐳",
595
- "spawn_prompt": "You are the Containerization Specialist. Write Dockerfiles (multi-stage builds), .dockerignore. Deploy to Azure Container Apps (scale-to-zero, KEDA scaling). Optimize image size, configure health checks."
596
- }
597
- },
598
-
599
- "observability-expert": {
600
- "tier": 3,
601
- "role": "specialist",
602
- "title": "Observability Specialist",
603
- "domains": ["infrastructure-observability"],
604
- "keywords": ["monitoring", "logging", "tracing", "metrics", "app insights", "serilog", "opentelemetry", "dashboards", "alerts"],
605
- "always_active": false,
606
- "validators": ["observability"],
607
- "relationships": {
608
- "reports_to": "azure-architect",
609
- "coordinates": [],
610
- "escalates_to": "azure-architect",
611
- "collaborates_with": ["dotnet-senior", "ms-agent-expert"],
612
- "team_role": "specialist"
613
- },
614
- "standards": ["core/coding.md", "core/architecture.md"],
615
- "teammate": {
616
- "role": "Observability Specialist",
617
- "icon": "📊",
618
- "spawn_prompt": "You are the Observability Specialist. Setup Application Insights (connection strings, sampling), configure Serilog (sinks, enrichers), instrument OpenTelemetry (.NET SDK). Create custom metrics, dashboards, alert rules. Write Log Analytics queries (KQL)."
619
- }
620
- },
621
-
622
- "azure-identity": {
623
- "tier": 3,
624
- "role": "specialist",
625
- "title": "Microsoft Identity Specialist",
626
- "domains": ["infrastructure-identity"],
627
- "keywords": ["identity", "entra", "microsoft auth", "azure ad", "b2c", "passkeys", "webauthn", "managed identity"],
628
- "always_active": false,
629
- "validators": ["architecture"],
630
- "relationships": {
631
- "reports_to": "azure-architect",
632
- "coordinates": [],
633
- "escalates_to": "azure-architect",
634
- "collaborates_with": ["blazor-builder", "nextjs-expert", "clerk-auth"],
635
- "team_role": "specialist"
636
- },
637
- "standards": ["core/coding.md", "core/architecture.md"],
638
- "teammate": {
639
- "role": "Microsoft Identity Specialist",
640
- "icon": "🔑",
641
- "spawn_prompt": "You are the Microsoft Identity Specialist. Implement Azure AD B2C, Entra External ID, Managed Identity for Azure resources. Add WebAuthn/Passkeys support (FIDO2 registration/authentication flows). Collaborate with frontend specialists for UI integration."
642
- }
643
- },
644
-
645
- "_comment_tier_3_quality": "=== TIER 3: QUALITY SPECIALISTS (6) ===",
646
-
647
- "testing-specialist": {
648
- "tier": 3,
649
- "role": "specialist",
650
- "title": "Testing Specialist",
651
- "domains": ["quality-testing"],
652
- "keywords": ["test", "testing", "unit", "integration", "e2e", "xunit", "moq", "testcontainers", "bunit"],
653
- "always_active": false,
654
- "validators": ["architecture"],
655
- "relationships": {
656
- "reports_to": "standards-architect",
657
- "coordinates": [],
658
- "escalates_to": "standards-architect",
659
- "collaborates_with": ["dotnet-senior", "blazor-builder", "nextjs-expert"],
660
- "team_role": "specialist"
661
- },
662
- "standards": ["core/coding.md", "core/architecture.md"],
663
- "teammate": {
664
- "role": "Testing Specialist",
665
- "icon": "🧪",
666
- "spawn_prompt": "You are the Testing Specialist. Write unit tests (xUnit, Moq/NSubstitute, FluentAssertions), integration tests (TestContainers, Respawn for DB reset), Blazor component tests (bUnit), HTTP mocking (WireMock). Follow Arrange-Act-Assert (AAA) pattern."
667
- }
668
- },
669
-
670
- "code-analyzer": {
671
- "tier": 3,
672
- "role": "specialist",
673
- "title": "Code Quality Analyst",
674
- "domains": ["quality-review"],
675
- "keywords": ["analyze", "review", "refactor", "clean code", "smell", "duplicate", "solid", "architecture review"],
676
- "always_active": false,
677
- "validators": ["architecture", "packages"],
678
- "relationships": {
679
- "reports_to": "standards-architect",
680
- "coordinates": [],
681
- "escalates_to": "standards-architect",
682
- "collaborates_with": ["dotnet-senior", "troubleshooting-expert"],
683
- "team_role": "specialist"
684
- },
685
- "standards": ["core/coding.md", "core/architecture.md"],
686
- "teammate": {
687
- "role": "Code Quality Analyst",
688
- "icon": "🔍",
689
- "spawn_prompt": "You are the Code Quality Analyst. Review code for architecture violations, clean code principles (naming, complexity, duplication), SOLID principles. Identify code smells, suggest refactorings. Run architecture and packages validators."
690
- }
691
- },
692
-
693
- "troubleshooting-expert": {
694
- "tier": 3,
695
- "role": "specialist",
696
- "title": "Troubleshooting & Debug Expert",
697
- "domains": ["quality-debug"],
698
- "keywords": ["debug", "troubleshoot", "root cause", "analyze error", "investigate", "diagnose"],
699
- "always_active": false,
700
- "validators": [],
701
- "relationships": {
702
- "reports_to": "standards-architect",
703
- "coordinates": [],
704
- "escalates_to": "standards-architect",
705
- "collaborates_with": ["code-analyzer", "testing-specialist"],
706
- "team_role": "escalation_specialist",
707
- "spawn_trigger": "escalation_after_3_failures"
708
- },
709
- "standards": ["core/coding.md", "core/architecture.md"],
710
- "teammate": {
711
- "role": "Troubleshooting Expert (Escalation)",
712
- "icon": "🔧",
713
- "spawn_prompt": "You are the Troubleshooting Expert (spawned after 3 failed attempts). Analyze root cause of failures: validation errors, compilation errors, runtime exceptions. Review attempt logs from recovery-tracker. Propose alternative approaches. Message standards-architect with findings."
714
- }
715
- },
716
-
717
- "load-testing-expert": {
718
- "tier": 3,
719
- "role": "specialist",
720
- "title": "Load Testing & Performance Specialist",
721
- "domains": ["quality-performance"],
722
- "keywords": ["load test", "performance test", "k6", "jmeter", "stress test", "capacity planning", "bottleneck", "scalability", "concurrent users"],
723
- "always_active": false,
724
- "validators": ["performance"],
725
- "relationships": {
726
- "reports_to": "standards-architect",
727
- "coordinates": [],
728
- "escalates_to": "standards-architect",
729
- "collaborates_with": ["azure-architect", "observability-expert"],
730
- "team_role": "specialist"
731
- },
732
- "standards": ["core/coding.md", "core/architecture.md"],
733
- "teammate": {
734
- "role": "Load Testing Specialist",
735
- "icon": "📈",
736
- "spawn_prompt": "You are the Load Testing Specialist. Write k6 scripts (stress test, spike test, soak test), JMeter test plans. Analyze bottlenecks (DB, CPU, memory). Recommend capacity planning (how many users system supports). Collaborate with observability-expert for metrics."
737
- }
738
- },
739
-
740
- "documentation-specialist": {
741
- "tier": 3,
742
- "role": "specialist",
743
- "title": "Documentation Specialist",
744
- "domains": ["developer-experience-docs"],
745
- "keywords": ["readme", "documentation", "api docs", "contributing", "deployment guide", "onboarding"],
746
- "always_active": false,
747
- "validators": [],
748
- "relationships": {
749
- "reports_to": "standards-architect",
750
- "coordinates": [],
751
- "escalates_to": "standards-architect",
752
- "collaborates_with": ["api-designer", "devops-engineer"],
753
- "team_role": "post_implementation",
754
- "spawn_trigger": "post_fase_5"
755
- },
756
- "standards": ["core/coding.md", "core/architecture.md"],
757
- "teammate": {
758
- "role": "Documentation Specialist (Post-FASE 5)",
759
- "icon": "📝",
760
- "spawn_prompt": "You are the Documentation Specialist (runs after FASE 5). Generate README.md (how to run project), CONTRIBUTING.md (contributor guide), API documentation (Swagger annotations, markdown docs), deployment guides (infra setup). Update existing docs with new features."
761
- }
762
- },
763
-
764
- "_comment_tier_4": "=== TIER 4: VALIDATORS (5) ===",
765
-
766
- "security-expert": {
767
- "tier": 4,
768
- "role": "validator",
769
- "title": "Security Validator",
770
- "domains": ["security"],
771
- "keywords": ["sql injection", "xss", "secrets", "security scan", "vulnerability", "csrf", "insecure deserialization"],
772
- "always_active": true,
773
- "validators": ["security"],
774
- "relationships": {
775
- "reports_to": "standards-architect",
776
- "coordinates": [],
777
- "runs_in": "hooks",
778
- "hook_triggers": ["TeammateIdle", "TaskCompleted"],
779
- "team_role": "validator"
780
- },
781
- "standards": ["core/coding.md", "core/architecture.md"],
782
- "teammate": null,
783
- "hook_behavior": {
784
- "validates": [
785
- "SQL injection (string concatenation in queries)",
786
- "Hardcoded secrets (API keys, passwords, connection strings)",
787
- "XSS (@Html.Raw usage in Razor/Blazor)",
788
- "Insecure deserialization (BinaryFormatter)",
789
- "CSRF (missing anti-forgery tokens)"
790
- ],
791
- "severity": "error",
792
- "blocks_on_fail": true
793
- }
794
- },
795
-
796
- "architecture-expert": {
797
- "tier": 4,
798
- "role": "validator",
799
- "title": "Architecture Validator",
800
- "domains": ["architecture"],
801
- "keywords": ["architecture", "clean code", "solid", "dependency injection"],
802
- "always_active": true,
803
- "validators": ["architecture"],
804
- "relationships": {
805
- "reports_to": "standards-architect",
806
- "coordinates": [],
807
- "runs_in": "hooks",
808
- "hook_triggers": ["TeammateIdle", "TaskCompleted"],
809
- "team_role": "validator"
810
- },
811
- "standards": ["core/coding.md", "core/architecture.md"],
812
- "teammate": null,
813
- "hook_behavior": {
814
- "validates": [
815
- "DbContext injection (IDbContextFactory required)",
816
- "Async/await patterns (no .Result or .Wait)",
817
- "DI registration order (services before middleware)",
818
- "Blazor render mode compatibility"
819
- ],
820
- "severity": "error",
821
- "blocks_on_fail": true
822
- }
823
- },
824
-
825
- "packages-validator": {
826
- "tier": 4,
827
- "role": "validator",
828
- "title": "Packages Validator",
829
- "domains": ["packages"],
830
- "keywords": ["nuget", "packages", "dependencies", "version conflict"],
831
- "always_active": true,
832
- "validators": ["packages"],
833
- "relationships": {
834
- "reports_to": "standards-architect",
835
- "coordinates": [],
836
- "runs_in": "hooks",
837
- "hook_triggers": ["TaskCompleted"],
838
- "team_role": "validator"
839
- },
840
- "standards": ["core/coding.md"],
841
- "teammate": null,
842
- "hook_behavior": {
843
- "validates": [
844
- "NuGet version conflicts (same package, different versions)",
845
- "Incompatible .NET 10 packages",
846
- "Security vulnerabilities (outdated packages)"
847
- ],
848
- "severity": "error",
849
- "blocks_on_fail": true
850
- }
851
- },
852
-
853
- "design-system-validator": {
854
- "tier": 4,
855
- "role": "validator",
856
- "title": "Design System Validator",
857
- "domains": ["design-system"],
858
- "keywords": ["design system", "css", "color palette", "spacing"],
859
- "always_active": true,
860
- "validators": ["design-system"],
861
- "relationships": {
862
- "reports_to": "ui-designer",
863
- "coordinates": [],
864
- "runs_in": "hooks",
865
- "hook_triggers": ["TeammateIdle"],
866
- "team_role": "validator"
867
- },
868
- "standards": ["frontend/design-system/naming.md", "frontend/design-system/animations.md"],
869
- "teammate": null,
870
- "hook_behavior": {
871
- "validates": [
872
- "CSS color palette compliance (primary, secondary, accent)",
873
- "Spacing values (use var(--spacing-*))",
874
- "Typography scale (use var(--font-*))",
875
- "Component naming (PascalCase for Blazor, kebab-case for CSS)"
876
- ],
877
- "severity": "warning",
878
- "blocks_on_fail": false
879
- }
880
- },
881
-
882
- "blazor-concurrency-validator": {
883
- "tier": 4,
884
- "role": "validator",
885
- "title": "Blazor Concurrency Validator",
886
- "domains": ["blazor-concurrency"],
887
- "keywords": ["blazor", "dbcontext", "lifecycle", "async", "concurrency"],
888
- "always_active": true,
889
- "validators": ["blazor-concurrency"],
890
- "relationships": {
891
- "reports_to": "blazor-builder",
892
- "coordinates": [],
893
- "runs_in": "hooks",
894
- "hook_triggers": ["TaskCompleted"],
895
- "team_role": "validator"
896
- },
897
- "standards": ["frontend/blazor/lifecycle.md", "frontend/blazor/pitfalls.md", "frontend/blazor/state.md"],
898
- "teammate": null,
899
- "hook_behavior": {
900
- "validates": [
901
- "DbContext lifecycle violations (dispose, scope issues)",
902
- "Async void methods (use async Task instead)",
903
- "JSInterop in OnInitialized (move to OnAfterRender)",
904
- "State mutation without StateHasChanged"
905
- ],
906
- "severity": "error",
907
- "blocks_on_fail": true
908
- }
909
- }
910
- },
911
-
912
- "squads": {
913
- "backend_squad": {
914
- "leader": "dotnet-senior",
915
- "members": ["ef-modeler", "event-architect", "api-designer", "nosql-cache-expert", "ddd-expert", "hangfire-orchestrator", "ms-agent-expert", "supabase-expert", "vector-search-expert", "context-optimizer", "asaas-financial", "clerk-auth", "resend-email"],
916
- "domains": ["backend", "backend-data", "backend-events", "backend-api", "backend-nosql", "backend-ddd", "backend-jobs", "ai-agents", "backend-supabase", "ai-vector", "ai-context", "integration-payment", "integration-auth", "integration-email"]
917
- },
918
- "frontend_squad": {
919
- "leader": "ui-designer",
920
- "members": ["blazor-builder", "nextjs-expert", "css-specialist"],
921
- "domains": ["frontend-design", "frontend-blazor", "frontend-nextjs", "frontend-css"],
922
- "active_phases": {
923
- "design": ["ui-designer"],
924
- "implement": ["blazor-builder", "nextjs-expert", "css-specialist"]
925
- }
926
- },
927
- "infrastructure_squad": {
928
- "leader": "azure-architect",
929
- "members": ["bicep-architect", "devops-engineer", "container-specialist", "observability-expert", "azure-identity"],
930
- "domains": ["infrastructure", "infrastructure-iac", "infrastructure-cicd", "infrastructure-containers", "infrastructure-observability", "infrastructure-identity"]
931
- },
932
- "quality_squad": {
933
- "leader": "standards-architect",
934
- "members": ["testing-specialist", "code-analyzer", "troubleshooting-expert", "load-testing-expert", "documentation-specialist"],
935
- "domains": ["quality-testing", "quality-review", "quality-debug", "quality-performance", "developer-experience-docs"],
936
- "note": "No permanent leader — standards-architect coordinates directly"
937
- }
938
- },
939
-
940
- "relationship_types": {
941
- "reports_to": "Hierarchical manager relationship",
942
- "coordinates": "Manages/leads these agents",
943
- "escalates_to": "Where to escalate unresolved issues",
944
- "collaborates_with": "Peer agents for cross-domain work",
945
- "runs_in": "Execution context (hooks, not teammates)",
946
- "team_role": "Role in Agent Teams (lead, domain_leader, specialist, validator, escalation_specialist, post_implementation, planning_only)"
947
- }
948
- }