@polymorphism-tech/morph-spec 4.6.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 (239) hide show
  1. package/README.md +394 -700
  2. package/docs/ARCHITECTURE.md +331 -0
  3. package/docs/CHEATSHEET.md +221 -0
  4. package/docs/COMMAND-FLOWS.md +368 -0
  5. package/docs/QUICKSTART.md +212 -0
  6. package/docs/examples/order-management/contracts.cs +84 -0
  7. package/docs/examples/order-management/proposal.md +24 -0
  8. package/docs/examples/order-management/spec.md +162 -0
  9. package/docs/plans/2026-02-23-ddd-architecture-refactor.md +1153 -0
  10. package/docs/plans/2026-02-23-ddd-nextsteps.md +682 -0
  11. package/docs/plans/2026-02-23-infra-architect-refactor.md +437 -0
  12. package/docs/plans/2026-02-23-nextjs-code-review-design.md +156 -0
  13. package/docs/plans/2026-02-23-nextjs-code-review-impl.md +1254 -0
  14. package/docs/plans/2026-02-23-nextjs-standards-design.md +149 -0
  15. package/docs/plans/2026-02-23-nextjs-standards-impl.md +1846 -0
  16. package/framework/agents/README.md +14 -14
  17. package/framework/agents/architecture/standards-architect.md +159 -159
  18. package/framework/agents/frontend/nextjs-expert.md +87 -127
  19. package/framework/agents/infrastructure/azure-architect.md +147 -147
  20. package/framework/agents/infrastructure/infra-architect.md +45 -0
  21. package/framework/agents.json +1145 -278
  22. package/framework/rules/frontend-standards.md +0 -3
  23. package/framework/rules/nextjs-standards.md +17 -0
  24. package/framework/skills/level-0-meta/code-review-nextjs/SKILL.md +147 -0
  25. package/framework/skills/level-0-meta/code-review-nextjs/references/review-example-nextjs.md +254 -0
  26. package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +3 -3
  27. package/framework/skills/level-1-workflows/phase-design/SKILL.md +45 -9
  28. package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +38 -0
  29. package/framework/standards/STANDARDS.json +121 -0
  30. package/framework/standards/architecture/ddd/bounded-contexts.md +105 -0
  31. package/framework/standards/architecture/ddd/complexity-levels.md +108 -0
  32. package/framework/standards/architecture/ddd/ubiquitous-language.md +58 -0
  33. package/framework/standards/frontend/nextjs/app-router.md +123 -0
  34. package/framework/standards/frontend/nextjs/components.md +132 -0
  35. package/framework/standards/frontend/nextjs/data-fetching.md +126 -0
  36. package/framework/standards/frontend/nextjs/forms.md +128 -0
  37. package/framework/standards/frontend/nextjs/naming-conventions.md +67 -0
  38. package/framework/standards/frontend/nextjs/project-structure.md +102 -0
  39. package/framework/standards/frontend/nextjs/state-management.md +72 -0
  40. package/framework/standards/frontend/nextjs/testing.md +111 -0
  41. package/framework/templates/REGISTRY.json +538 -142
  42. package/framework/templates/code/dotnet/contracts/contracts-level1.cs +69 -0
  43. package/framework/templates/code/dotnet/contracts/contracts-level2.cs +86 -0
  44. package/framework/templates/code/dotnet/contracts/contracts-level3.cs +41 -0
  45. package/framework/templates/docs/spec.md +49 -0
  46. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -0
  47. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -0
  48. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -0
  49. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -0
  50. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -0
  51. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -0
  52. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -0
  53. package/framework/templates/project-structure/dotnet-ddd.md +70 -0
  54. package/framework/workflows/docs/enforcement-pipeline.md +2 -1
  55. package/package.json +1 -1
  56. package/scripts/scan-nextjs.mjs +169 -0
  57. package/src/commands/project/doctor.js +52 -1
  58. package/src/commands/project/init.js +15 -1
  59. package/src/commands/project/update.js +6 -1
  60. package/src/lib/standards/standards-context-injector.js +5 -0
  61. package/src/lib/validators/nextjs/index.js +6 -0
  62. package/src/lib/validators/nextjs/next-component-validator.js +181 -0
  63. package/src/lib/validators/validation-runner.js +5 -0
  64. package/src/utils/agents-installer.js +14 -2
  65. package/.morph/.morphversion +0 -5
  66. package/.morph/analytics/threads-log.jsonl +0 -6
  67. package/.morph/config/config.json +0 -8
  68. package/.morph/framework/agents.json +0 -948
  69. package/.morph/framework/standards/STANDARDS.json +0 -812
  70. package/.morph/framework/standards/ai-agents/blazor-ui.md +0 -364
  71. package/.morph/framework/standards/ai-agents/production.md +0 -415
  72. package/.morph/framework/standards/ai-agents/setup.md +0 -418
  73. package/.morph/framework/standards/ai-agents/team-orchestration.md +0 -479
  74. package/.morph/framework/standards/ai-agents/workflows.md +0 -354
  75. package/.morph/framework/standards/architecture/ddd/aggregates.md +0 -120
  76. package/.morph/framework/standards/architecture/ddd/entities.md +0 -99
  77. package/.morph/framework/standards/architecture/ddd/value-objects.md +0 -124
  78. package/.morph/framework/standards/backend/api/minimal-api.md +0 -494
  79. package/.morph/framework/standards/backend/api/rest.md +0 -492
  80. package/.morph/framework/standards/backend/api/validation.md +0 -88
  81. package/.morph/framework/standards/backend/authentication/passkeys.md +0 -428
  82. package/.morph/framework/standards/backend/database/ef-core.md +0 -199
  83. package/.morph/framework/standards/backend/database/migrations.md +0 -393
  84. package/.morph/framework/standards/backend/database/postgresql/database.md +0 -352
  85. package/.morph/framework/standards/backend/database/repository-patterns.md +0 -528
  86. package/.morph/framework/standards/backend/database/vector-search-rag.md +0 -541
  87. package/.morph/framework/standards/backend/dotnet/async.md +0 -366
  88. package/.morph/framework/standards/backend/dotnet/core.md +0 -117
  89. package/.morph/framework/standards/backend/dotnet/di.md +0 -439
  90. package/.morph/framework/standards/backend/dotnet/program-cs-checklist.md +0 -92
  91. package/.morph/framework/standards/backend/integrations/asaas/asaas-api.md +0 -216
  92. package/.morph/framework/standards/backend/integrations/clerk/clerk-auth.md +0 -290
  93. package/.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md +0 -350
  94. package/.morph/framework/standards/backend/integrations/resend/resend-email.md +0 -385
  95. package/.morph/framework/standards/context/analytics.md +0 -96
  96. package/.morph/framework/standards/context/bundles.md +0 -110
  97. package/.morph/framework/standards/context/priming.md +0 -78
  98. package/.morph/framework/standards/core/architecture.md +0 -185
  99. package/.morph/framework/standards/core/coding.md +0 -214
  100. package/.morph/framework/standards/core/git-branching-strategy.md +0 -403
  101. package/.morph/framework/standards/core/git.md +0 -185
  102. package/.morph/framework/standards/core/testing.md +0 -295
  103. package/.morph/framework/standards/data/nosql/blob-storage.md +0 -102
  104. package/.morph/framework/standards/data/nosql/cache/redis.md +0 -97
  105. package/.morph/framework/standards/data/nosql/cosmos-db.md +0 -118
  106. package/.morph/framework/standards/data/vector-search/azure-ai-search.md +0 -121
  107. package/.morph/framework/standards/data/vector-search/rag-chunking.md +0 -104
  108. package/.morph/framework/standards/frontend/blazor/design-checklist.md +0 -222
  109. package/.morph/framework/standards/frontend/blazor/fluent-ui-setup.md +0 -595
  110. package/.morph/framework/standards/frontend/blazor/fluent-ui.md +0 -137
  111. package/.morph/framework/standards/frontend/blazor/html-conversion.md +0 -184
  112. package/.morph/framework/standards/frontend/blazor/lifecycle.md +0 -195
  113. package/.morph/framework/standards/frontend/blazor/pitfalls.md +0 -198
  114. package/.morph/framework/standards/frontend/blazor/state.md +0 -191
  115. package/.morph/framework/standards/frontend/design-system/animations.md +0 -151
  116. package/.morph/framework/standards/frontend/design-system/naming.md +0 -64
  117. package/.morph/framework/standards/frontend/nextjs/nextjs-patterns.md +0 -215
  118. package/.morph/framework/standards/infrastructure/azure/azure.md +0 -624
  119. package/.morph/framework/standards/infrastructure/azure/bicep/bicep-patterns.md +0 -422
  120. package/.morph/framework/standards/infrastructure/azure/devops/azure-devops-setup.md +0 -516
  121. package/.morph/framework/standards/infrastructure/azure/devops/local-development.md +0 -520
  122. package/.morph/framework/standards/infrastructure/azure/services/functions.md +0 -486
  123. package/.morph/framework/standards/infrastructure/azure/services/service-bus.md +0 -459
  124. package/.morph/framework/standards/infrastructure/azure/services/storage.md +0 -407
  125. package/.morph/framework/standards/infrastructure/docker/easypanel-deploy.md +0 -196
  126. package/.morph/framework/standards/infrastructure/supabase/mcp-setup.md +0 -252
  127. package/.morph/framework/standards/infrastructure/supabase/supabase-auth.md +0 -176
  128. package/.morph/framework/standards/infrastructure/supabase/supabase-pgvector.md +0 -169
  129. package/.morph/framework/standards/infrastructure/supabase/supabase-rls.md +0 -184
  130. package/.morph/framework/standards/infrastructure/supabase/supabase-storage.md +0 -153
  131. package/.morph/framework/standards/integration/api/graphql.md +0 -91
  132. package/.morph/framework/standards/integration/api/grpc.md +0 -114
  133. package/.morph/framework/standards/integration/api/rest-design.md +0 -95
  134. package/.morph/framework/standards/integration/event-driven/cqrs.md +0 -101
  135. package/.morph/framework/standards/integration/event-driven/event-sourcing.md +0 -124
  136. package/.morph/framework/standards/integration/event-driven/service-bus.md +0 -95
  137. package/.morph/framework/standards/integration/mcp/mcp-tools.md +0 -384
  138. package/.morph/framework/standards/observability/logging.md +0 -131
  139. package/.morph/framework/standards/observability/metrics.md +0 -121
  140. package/.morph/framework/standards/observability/monitoring.md +0 -114
  141. package/.morph/framework/standards/observability/tracing.md +0 -132
  142. package/.morph/framework/standards/workflows/parallel-execution.md +0 -112
  143. package/.morph/framework/standards/workflows/thread-management.md +0 -113
  144. package/.morph/framework/templates/.idea/morph-templates.xml +0 -92
  145. package/.morph/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  146. package/.morph/framework/templates/IDE-SNIPPETS.md +0 -266
  147. package/.morph/framework/templates/README.md +0 -814
  148. package/.morph/framework/templates/REGISTRY.json +0 -1492
  149. package/.morph/framework/templates/code/dotnet/backend/repository.cs +0 -141
  150. package/.morph/framework/templates/code/dotnet/backend/service.cs +0 -139
  151. package/.morph/framework/templates/code/dotnet/contracts/Commands.cs +0 -74
  152. package/.morph/framework/templates/code/dotnet/contracts/Entities.cs +0 -25
  153. package/.morph/framework/templates/code/dotnet/contracts/Queries.cs +0 -74
  154. package/.morph/framework/templates/code/dotnet/contracts/README.md +0 -74
  155. package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs +0 -173
  156. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  157. package/.morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs +0 -172
  158. package/.morph/framework/templates/code/dotnet/database/migration.cs +0 -83
  159. package/.morph/framework/templates/code/dotnet/frontend/component.razor +0 -239
  160. package/.morph/framework/templates/code/dotnet/jobs/agent.cs +0 -163
  161. package/.morph/framework/templates/code/dotnet/jobs/job.cs +0 -171
  162. package/.morph/framework/templates/code/dotnet/test.cs +0 -239
  163. package/.morph/framework/templates/code/sql/rls-policy.sql +0 -57
  164. package/.morph/framework/templates/code/sql/supabase-migration.sql +0 -100
  165. package/.morph/framework/templates/code/sql/supabase-migration.template.sql +0 -113
  166. package/.morph/framework/templates/code/typescript/contracts.ts +0 -168
  167. package/.morph/framework/templates/context/CONTEXT-FEATURE.md +0 -276
  168. package/.morph/framework/templates/context/CONTEXT.md +0 -181
  169. package/.morph/framework/templates/docs/clarifications.md +0 -253
  170. package/.morph/framework/templates/docs/onboarding.md +0 -123
  171. package/.morph/framework/templates/docs/proposal.md +0 -182
  172. package/.morph/framework/templates/docs/schema-analysis.md +0 -119
  173. package/.morph/framework/templates/docs/spec.md +0 -149
  174. package/.morph/framework/templates/docs/ui-components.md +0 -124
  175. package/.morph/framework/templates/docs/ui-design-system.md +0 -76
  176. package/.morph/framework/templates/docs/ui-flows.md +0 -167
  177. package/.morph/framework/templates/docs/ui-mockups.md +0 -98
  178. package/.morph/framework/templates/docs/user-stories.md +0 -34
  179. package/.morph/framework/templates/examples/design-system-examples.md +0 -357
  180. package/.morph/framework/templates/examples/spec-examples.md +0 -90
  181. package/.morph/framework/templates/feature/decisions.md +0 -187
  182. package/.morph/framework/templates/feature/recap.md +0 -146
  183. package/.morph/framework/templates/feature/tasks.md +0 -199
  184. package/.morph/framework/templates/infrastructure/azure/Dockerfile.example +0 -82
  185. package/.morph/framework/templates/infrastructure/azure/README.md +0 -286
  186. package/.morph/framework/templates/infrastructure/azure/app-insights.bicep +0 -63
  187. package/.morph/framework/templates/infrastructure/azure/app-service.bicep +0 -164
  188. package/.morph/framework/templates/infrastructure/azure/container-app-env.bicep +0 -49
  189. package/.morph/framework/templates/infrastructure/azure/container-app.bicep +0 -156
  190. package/.morph/framework/templates/infrastructure/azure/deploy-checklist.md +0 -426
  191. package/.morph/framework/templates/infrastructure/azure/deploy.ps1 +0 -229
  192. package/.morph/framework/templates/infrastructure/azure/deploy.sh +0 -208
  193. package/.morph/framework/templates/infrastructure/azure/key-vault.bicep +0 -91
  194. package/.morph/framework/templates/infrastructure/azure/main.bicep +0 -189
  195. package/.morph/framework/templates/infrastructure/azure/parameters.dev.json +0 -29
  196. package/.morph/framework/templates/infrastructure/azure/parameters.prod.json +0 -29
  197. package/.morph/framework/templates/infrastructure/azure/parameters.staging.json +0 -29
  198. package/.morph/framework/templates/infrastructure/azure/sql-database.bicep +0 -103
  199. package/.morph/framework/templates/infrastructure/azure/storage.bicep +0 -106
  200. package/.morph/framework/templates/infrastructure/docker/Dockerfile.template +0 -58
  201. package/.morph/framework/templates/infrastructure/docker/docker-compose.template.yml +0 -67
  202. package/.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +0 -38
  203. package/.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +0 -48
  204. package/.morph/framework/templates/infrastructure/docker/easypanel.template.json +0 -54
  205. package/.morph/framework/templates/infrastructure/github/README.md +0 -593
  206. package/.morph/framework/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +0 -22
  207. package/.morph/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +0 -45
  208. package/.morph/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +0 -27
  209. package/.morph/framework/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +0 -61
  210. package/.morph/framework/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +0 -31
  211. package/.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +0 -59
  212. package/.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +0 -39
  213. package/.morph/framework/templates/integrations/asaas-client.cs +0 -387
  214. package/.morph/framework/templates/integrations/asaas-webhook.cs +0 -351
  215. package/.morph/framework/templates/integrations/azure-identity-config.cs +0 -288
  216. package/.morph/framework/templates/integrations/clerk-config.cs +0 -258
  217. package/.morph/framework/templates/meta-prompts/fusion/fusion-agent.md +0 -76
  218. package/.morph/framework/templates/meta-prompts/fusion/fusion-aggregator.md +0 -100
  219. package/.morph/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
  220. package/.morph/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
  221. package/.morph/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
  222. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  223. package/.morph/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  224. package/.morph/framework/templates/meta-prompts/squad-leaders/backend-squad.md +0 -90
  225. package/.morph/framework/templates/meta-prompts/squad-leaders/frontend-squad.md +0 -126
  226. package/.morph/framework/templates/meta-prompts/squad-leaders/squad-leader.md +0 -43
  227. package/.morph/framework/templates/meta-prompts/validators/checkpoint-validator.md +0 -107
  228. package/.morph/framework/templates/meta-prompts/validators/pre-commit-validator.md +0 -95
  229. package/.morph/framework/templates/saas/subscription.cs +0 -347
  230. package/.morph/framework/templates/saas/tenant.cs +0 -338
  231. package/.morph/framework/templates/state.template.json +0 -17
  232. package/.morph/framework/templates/ui/FluentDesignTheme.cs +0 -149
  233. package/.morph/framework/templates/ui/MudTheme.cs +0 -281
  234. package/.morph/framework/templates/ui/design-system.css +0 -226
  235. package/.morph/logs/tool-failures.log +0 -7
  236. package/.morph/memory/pre-compact-2026-02-23T15-43-03-521Z.json +0 -16
  237. package/.morph/state.json +0 -48
  238. package/framework/templates/code/dotnet/contracts/contracts.cs +0 -217
  239. 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
- }