@polymorphism-tech/morph-spec 2.4.0 → 3.0.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 (218) hide show
  1. package/CLAUDE.md +158 -26
  2. package/LICENSE +72 -72
  3. package/bin/detect-agents.js +225 -225
  4. package/bin/morph-spec.js +8 -0
  5. package/bin/render-template.js +302 -302
  6. package/bin/semantic-detect-agents.js +246 -246
  7. package/bin/validate-agents-skills.js +251 -251
  8. package/bin/validate-agents.js +69 -69
  9. package/bin/validate-phase.js +263 -263
  10. package/content/.azure/README.md +293 -293
  11. package/content/.azure/docs/azure-devops-setup.md +454 -454
  12. package/content/.azure/docs/branch-strategy.md +398 -398
  13. package/content/.azure/docs/local-development.md +515 -515
  14. package/content/.azure/pipelines/pipeline-variables.yml +34 -34
  15. package/content/.azure/pipelines/prod-pipeline.yml +319 -319
  16. package/content/.azure/pipelines/staging-pipeline.yml +234 -234
  17. package/content/.azure/pipelines/templates/build-dotnet.yml +75 -75
  18. package/content/.azure/pipelines/templates/deploy-app-service.yml +94 -94
  19. package/content/.azure/pipelines/templates/deploy-container-app.yml +120 -120
  20. package/content/.azure/pipelines/templates/infra-deploy.yml +90 -90
  21. package/content/.claude/commands/morph-archive.md +79 -79
  22. package/content/.claude/commands/morph-deploy.md +529 -0
  23. package/content/.claude/commands/morph-infra.md +209 -209
  24. package/content/.claude/commands/morph-preflight.md +227 -227
  25. package/content/.claude/commands/morph-troubleshoot.md +122 -122
  26. package/content/.claude/settings.local.json +15 -15
  27. package/content/.claude/skills/infra/azure-deploy-specialist.md +699 -0
  28. package/content/.claude/skills/level-0-meta/README.md +7 -0
  29. package/content/.claude/skills/{checklists → level-0-meta}/morph-checklist.md +117 -117
  30. package/content/.claude/skills/level-1-workflows/README.md +7 -0
  31. package/content/.claude/skills/{workflows → level-1-workflows}/morph-replicate.md +213 -213
  32. package/content/.claude/skills/{workflows → level-1-workflows}/phase-clarify.md +131 -131
  33. package/content/.claude/skills/{workflows → level-1-workflows}/phase-design.md +213 -205
  34. package/content/.claude/skills/{workflows → level-1-workflows}/phase-setup.md +106 -92
  35. package/content/.claude/skills/{workflows → level-1-workflows}/phase-tasks.md +164 -164
  36. package/content/.claude/skills/{workflows → level-1-workflows}/phase-uiux.md +169 -138
  37. package/content/.claude/skills/level-2-domains/README.md +14 -0
  38. package/content/.claude/skills/{specialists → level-2-domains/quality}/testing-specialist.md +126 -126
  39. package/content/.claude/skills/level-3-technologies/README.md +7 -0
  40. package/content/.claude/skills/level-4-patterns/README.md +7 -0
  41. package/content/.claude/skills/specialists/prompt-engineer.md +189 -0
  42. package/content/.claude/skills/specialists/seo-growth-hacker.md +320 -0
  43. package/content/.morph/.morphversion +5 -5
  44. package/content/.morph/archive/.gitkeep +25 -25
  45. package/content/.morph/config/agents.json +742 -358
  46. package/content/.morph/config/config.template.json +33 -0
  47. package/content/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -392
  48. package/content/.morph/docs/workflows/enforcement-pipeline.md +668 -0
  49. package/content/.morph/examples/api-nextjs/README.md +241 -241
  50. package/content/.morph/examples/api-nextjs/contracts.ts +307 -307
  51. package/content/.morph/examples/api-nextjs/spec.md +399 -399
  52. package/content/.morph/examples/api-nextjs/tasks.md +168 -168
  53. package/content/.morph/examples/micro-saas/README.md +125 -125
  54. package/content/.morph/examples/micro-saas/contracts.cs +358 -358
  55. package/content/.morph/examples/micro-saas/decisions.md +246 -246
  56. package/content/.morph/examples/micro-saas/spec.md +236 -236
  57. package/content/.morph/examples/micro-saas/tasks.md +150 -150
  58. package/content/.morph/examples/multi-agent/README.md +309 -309
  59. package/content/.morph/examples/multi-agent/contracts.cs +433 -433
  60. package/content/.morph/examples/multi-agent/spec.md +479 -479
  61. package/content/.morph/examples/multi-agent/tasks.md +185 -185
  62. package/content/.morph/examples/scheduled-reports/decisions.md +158 -158
  63. package/content/.morph/examples/scheduled-reports/proposal.md +95 -95
  64. package/content/.morph/examples/scheduled-reports/spec.md +267 -267
  65. package/content/.morph/examples/state-v3.json +188 -188
  66. package/content/.morph/features/.gitkeep +25 -25
  67. package/content/.morph/hooks/README.md +158 -0
  68. package/content/.morph/hooks/pre-commit-all.sh +48 -48
  69. package/content/.morph/hooks/pre-commit-specs.sh +49 -49
  70. package/content/.morph/hooks/pre-commit-tests.sh +60 -60
  71. package/content/.morph/hooks/task-completed.js +73 -0
  72. package/content/.morph/hooks/teammate-idle.js +68 -0
  73. package/content/.morph/project.md +160 -160
  74. package/content/.morph/schemas/agent.schema.json +296 -296
  75. package/content/.morph/schemas/tasks.schema.json +220 -220
  76. package/content/.morph/specs/.gitkeep +20 -20
  77. package/content/.morph/standards/agent-teams-workflow.md +474 -0
  78. package/content/.morph/standards/coding.md +377 -377
  79. package/content/.morph/standards/fluent-ui-setup.md +590 -590
  80. package/content/.morph/standards/migration-guide.md +514 -514
  81. package/content/.morph/standards/passkeys-auth.md +423 -423
  82. package/content/.morph/standards/vector-search-rag.md +536 -536
  83. package/content/.morph/state.json +17 -17
  84. package/content/.morph/templates/CONTEXT-FEATURE.md +276 -0
  85. package/content/.morph/templates/CONTEXT.md +170 -0
  86. package/content/.morph/templates/FluentDesignTheme.cs +149 -149
  87. package/content/.morph/templates/MudTheme.cs +281 -281
  88. package/content/.morph/templates/clarify-questions.md +159 -159
  89. package/content/.morph/templates/component.razor +239 -239
  90. package/content/.morph/templates/contracts/Commands.cs +74 -74
  91. package/content/.morph/templates/contracts/Entities.cs +25 -25
  92. package/content/.morph/templates/contracts/Queries.cs +74 -74
  93. package/content/.morph/templates/contracts/README.md +74 -74
  94. package/content/.morph/templates/contracts.cs +217 -217
  95. package/content/.morph/templates/design-system.css +226 -226
  96. package/content/.morph/templates/infra/.dockerignore.example +89 -89
  97. package/content/.morph/templates/infra/Dockerfile.example +82 -82
  98. package/content/.morph/templates/infra/README.md +286 -286
  99. package/content/.morph/templates/infra/app-insights.bicep +63 -63
  100. package/content/.morph/templates/infra/app-service.bicep +164 -164
  101. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -0
  102. package/content/.morph/templates/infra/container-app-env.bicep +49 -49
  103. package/content/.morph/templates/infra/container-app.bicep +156 -156
  104. package/content/.morph/templates/infra/deploy-checklist.md +426 -426
  105. package/content/.morph/templates/infra/deploy.ps1 +229 -229
  106. package/content/.morph/templates/infra/deploy.sh +208 -208
  107. package/content/.morph/templates/infra/key-vault.bicep +91 -91
  108. package/content/.morph/templates/infra/main.bicep +189 -189
  109. package/content/.morph/templates/infra/parameters.dev.json +29 -29
  110. package/content/.morph/templates/infra/parameters.prod.json +29 -29
  111. package/content/.morph/templates/infra/parameters.staging.json +29 -29
  112. package/content/.morph/templates/infra/sql-database.bicep +103 -103
  113. package/content/.morph/templates/infra/storage.bicep +106 -106
  114. package/content/.morph/templates/integrations/asaas-client.cs +387 -387
  115. package/content/.morph/templates/integrations/asaas-webhook.cs +351 -351
  116. package/content/.morph/templates/integrations/azure-identity-config.cs +288 -288
  117. package/content/.morph/templates/integrations/clerk-config.cs +258 -258
  118. package/content/.morph/templates/job.cs +171 -171
  119. package/content/.morph/templates/migration.cs +83 -83
  120. package/content/.morph/templates/repository.cs +141 -141
  121. package/content/.morph/templates/saas/subscription.cs +347 -347
  122. package/content/.morph/templates/saas/tenant.cs +338 -338
  123. package/content/.morph/templates/service.cs +139 -139
  124. package/content/.morph/templates/sprint-status.yaml +68 -68
  125. package/content/.morph/templates/story.md +143 -143
  126. package/content/.morph/templates/test.cs +239 -239
  127. package/content/.morph/templates/ui-design-system.md +286 -286
  128. package/content/.morph/templates/ui-flows.md +336 -336
  129. package/content/.morph/templates/ui-mockups.md +133 -133
  130. package/content/.morph/test-infra/example.bicep +59 -59
  131. package/content/README.md +79 -79
  132. package/detectors/config-detector.js +223 -223
  133. package/detectors/conversation-analyzer.js +163 -163
  134. package/detectors/index.js +84 -84
  135. package/detectors/standards-generator.js +275 -275
  136. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  137. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  138. package/docs/api/scripts/collapse.js +38 -38
  139. package/docs/api/scripts/commonNav.js +28 -28
  140. package/docs/api/scripts/linenumber.js +25 -25
  141. package/docs/api/scripts/nav.js +12 -12
  142. package/docs/api/scripts/polyfill.js +3 -3
  143. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  144. package/docs/api/scripts/prettify/lang-css.js +2 -2
  145. package/docs/api/scripts/prettify/prettify.js +28 -28
  146. package/docs/api/scripts/search.js +98 -98
  147. package/docs/api/styles/jsdoc.css +776 -776
  148. package/docs/api/styles/prettify.css +80 -80
  149. package/docs/examples.md +328 -328
  150. package/docs/templates.md +418 -418
  151. package/package.json +1 -1
  152. package/scripts/postinstall.js +132 -132
  153. package/src/commands/advance-phase.js +83 -0
  154. package/src/commands/analyze-blazor-concurrency.js +193 -193
  155. package/src/commands/create-story.js +351 -351
  156. package/src/commands/deploy.js +780 -0
  157. package/src/commands/detect-agents.js +34 -6
  158. package/src/commands/detect.js +104 -104
  159. package/src/commands/generate-context.js +40 -0
  160. package/src/commands/generate.js +149 -149
  161. package/src/commands/lint-fluent.js +352 -352
  162. package/src/commands/rollback-phase.js +185 -185
  163. package/src/commands/session-summary.js +291 -291
  164. package/src/commands/shard-spec.js +224 -224
  165. package/src/commands/sprint-status.js +250 -250
  166. package/src/commands/state.js +333 -333
  167. package/src/commands/sync.js +167 -167
  168. package/src/commands/troubleshoot.js +222 -222
  169. package/src/commands/validate-blazor-state.js +210 -210
  170. package/src/commands/validate-blazor.js +156 -156
  171. package/src/commands/validate-css.js +84 -84
  172. package/src/commands/validate-phase.js +221 -221
  173. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  174. package/src/lib/blazor-state-validator.js +291 -291
  175. package/src/lib/blazor-validator.js +374 -374
  176. package/src/lib/context-generator.js +513 -0
  177. package/src/lib/css-validator.js +352 -352
  178. package/src/lib/design-system-detector.js +187 -0
  179. package/src/lib/design-system-generator.js +298 -298
  180. package/src/lib/design-system-scaffolder.js +299 -0
  181. package/src/lib/hook-executor.js +256 -0
  182. package/src/lib/learning-system.js +520 -520
  183. package/src/lib/mockup-generator.js +366 -366
  184. package/src/lib/spec-validator.js +258 -0
  185. package/src/lib/standards-context-injector.js +287 -0
  186. package/src/lib/team-orchestrator.js +322 -0
  187. package/src/lib/troubleshoot-grep.js +194 -194
  188. package/src/lib/troubleshoot-index.js +144 -144
  189. package/src/lib/ui-detector.js +350 -350
  190. package/src/lib/validation-runner.js +65 -13
  191. package/src/lib/validators/architecture-validator.js +387 -387
  192. package/src/lib/validators/design-system-validator.js +231 -0
  193. package/src/lib/validators/package-validator.js +360 -360
  194. package/src/lib/validators/ui-contrast-validator.js +422 -422
  195. package/src/utils/file-copier.js +9 -1
  196. package/src/utils/logger.js +32 -32
  197. package/src/utils/version-checker.js +175 -175
  198. /package/content/.claude/skills/{checklists → level-0-meta}/code-review.md +0 -0
  199. /package/content/.claude/skills/{checklists → level-0-meta}/simulation-checklist.md +0 -0
  200. /package/content/.claude/skills/{specialists → level-2-domains/ai-agents}/ai-system-architect.md +0 -0
  201. /package/content/.claude/skills/{specialists → level-2-domains/architecture}/po-pm-advisor.md +0 -0
  202. /package/content/.claude/skills/{specialists → level-2-domains/architecture}/standards-architect.md +0 -0
  203. /package/content/.claude/skills/{specialists → level-2-domains/backend}/dotnet-senior.md +0 -0
  204. /package/content/.claude/skills/{specialists → level-2-domains/backend}/ef-modeler.md +0 -0
  205. /package/content/.claude/skills/{specialists → level-2-domains/backend}/hangfire-orchestrator.md +0 -0
  206. /package/content/.claude/skills/{specialists → level-2-domains/backend}/ms-agent-expert.md +0 -0
  207. /package/content/.claude/skills/{stacks/dotnet-blazor.md → level-2-domains/frontend/blazor-builder.md} +0 -0
  208. /package/content/.claude/skills/{stacks/dotnet-nextjs.md → level-2-domains/frontend/nextjs-expert.md} +0 -0
  209. /package/content/.claude/skills/{specialists → level-2-domains/frontend}/ui-ux-designer.md +0 -0
  210. /package/content/.claude/skills/{specialists → level-2-domains/infrastructure}/azure-architect.md +0 -0
  211. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/bicep-architect.md +0 -0
  212. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/container-specialist.md +0 -0
  213. /package/content/.claude/skills/{infra → level-2-domains/infrastructure}/devops-engineer.md +0 -0
  214. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/asaas-financial.md +0 -0
  215. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/azure-identity.md +0 -0
  216. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/clerk-auth.md +0 -0
  217. /package/content/.claude/skills/{integrations → level-2-domains/integrations}/resend-email.md +0 -0
  218. /package/content/.claude/skills/{specialists → level-2-domains/quality}/code-analyzer.md +0 -0
@@ -1,378 +1,762 @@
1
1
  {
2
- "version": "1.0.0",
2
+ "$schema": "./agent-schema.json",
3
+ "version": "3.0.0-hierarchical",
4
+ "total_agents": 30,
5
+ "tiers": {
6
+ "tier_1_orchestrators": 3,
7
+ "tier_2_leaders": 3,
8
+ "tier_3_specialists": 23,
9
+ "tier_4_validators": 1
10
+ },
11
+
3
12
  "agents": {
4
- "core": [
5
- {
6
- "id": "standards-architect",
7
- "name": "Standards Architect",
8
- "emoji": "📐",
9
- "type": "core",
10
- "skillPath": ".claude/skills/specialists/standards-architect.md",
11
- "description": "Guardião dos padrões de código e arquitetura",
12
- "responsibilities": [
13
- "Validar aderência aos padrões em .morph/standards/",
14
- "Revisar nomenclatura e estrutura de código",
15
- "Garantir consistência entre features",
16
- "Aprovar código antes de merge"
17
- ],
18
- "validatesPhases": ["design", "implement"]
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"
19
29
  },
20
- {
21
- "id": "azure-architect",
22
- "name": "Azure Architect",
23
- "emoji": "☁️",
24
- "type": "core",
25
- "skillPath": ".claude/skills/specialists/azure-architect.md",
26
- "description": "Especialista em infraestrutura Azure",
27
- "responsibilities": [
28
- "Desenhar infraestrutura eficiente",
29
- "Configurar Container Apps com scale-to-zero",
30
- "Definir estratégias de deployment",
31
- "Gerenciar recursos e networking"
32
- ],
33
- "expertise": ["Container Apps", "Azure SQL", "ACR", "App Insights", "Managed Identity"]
30
+ "standards": ["coding.md", "architecture.md", "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"
34
52
  },
35
- {
36
- "id": "blazor-builder",
37
- "name": "Blazor Builder",
38
- "emoji": "🔥",
39
- "type": "core",
40
- "skillPath": ".claude/skills/stacks/dotnet-blazor.md",
41
- "description": "Especialista em componentes Blazor Server",
42
- "responsibilities": [
43
- "Criar componentes reutilizáveis",
44
- "Implementar UI seguindo padrões",
45
- "Gerenciar estado e lifecycle",
46
- "Integrar SignalR quando necessário"
47
- ],
48
- "patterns": ["Component-per-file", "@inject para DI", "Loading states", "Error boundaries"]
53
+ "standards": ["coding.md", "architecture.md", "agent-framework-setup.md", "agent-framework-workflows.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"]
49
74
  },
50
- {
51
- "id": "ef-modeler",
52
- "name": "EF Modeler",
53
- "emoji": "🗄️",
54
- "type": "core",
55
- "skillPath": ".claude/skills/specialists/ef-modeler.md",
56
- "description": "Especialista em Entity Framework e modelagem de dados",
57
- "responsibilities": [
58
- "Modelar entidades e relacionamentos",
59
- "Criar migrations seguras",
60
- "Otimizar queries com EF Core",
61
- "Configurar DbContext"
62
- ],
63
- "patterns": ["Fluent API always", "Private setters", "Value Objects", "Owned Types"]
75
+ "standards": ["coding.md", "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"
64
95
  },
65
- {
66
- "id": "dotnet-senior",
67
- "name": ".NET Senior Engineer",
68
- "emoji": "🧠",
69
- "type": "core",
70
- "skillPath": ".claude/skills/specialists/dotnet-senior.md",
71
- "description": "Senior .NET engineer with ultrathink mode for complex decisions and high-quality code. Always active.",
72
- "responsibilities": [
73
- "Write production-quality C# following all standards",
74
- "Make complex architectural decisions with ultrathink mode",
75
- "Ensure all code follows coding.md conventions",
76
- "Trigger code-analyzer for post-implementation review",
77
- "Provide ADR-style decision documentation"
78
- ],
79
- "validatesPhases": ["design", "implement"],
80
- "patterns": ["Result pattern", "Primary constructors", "sealed classes", "Structured logging", "CancellationToken propagation"]
96
+ "standards": ["coding.md", "architecture.md", "dotnet10-compatibility.md", "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": ["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"
81
118
  },
82
- {
83
- "id": "ms-agent-expert",
84
- "name": "MS Agent Expert",
85
- "emoji": "🤖",
86
- "type": "core",
87
- "skillPath": ".claude/skills/specialists/ms-agent-expert.md",
88
- "description": "Especialista em Microsoft Agent Framework, workflows e AI",
89
- "responsibilities": [
90
- "Integrate Microsoft Agent Framework",
91
- "Configure agents with tools via AIFunctionFactory",
92
- "Build multi-agent workflows (Sequential, Handoff, GroupChat)",
93
- "Implement middleware, A2A, and MCP integration",
94
- "Optimize prompts and tokens"
95
- ],
96
- "defaultModel": "gpt-4o-mini",
97
- "patterns": ["ChatClientAgent", "AIFunctionFactory", "AgentWorkflowBuilder", "Middleware pipeline", "A2A hosting", "MCP tools"]
119
+ "standards": ["coding.md", "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."
98
124
  }
99
- ],
100
- "specialists": [
101
- {
102
- "id": "hangfire-orchestrator",
103
- "name": "Hangfire Orchestrator",
104
- "emoji": "",
105
- "type": "specialist",
106
- "skillPath": ".claude/skills/specialists/hangfire-orchestrator.md",
107
- "description": "Especialista em background jobs",
108
- "autoActivation": {
109
- "keywords": ["scheduled", "job", "background", "recurring", "batch", "cron", "queue"]
110
- },
111
- "responsibilities": [
112
- "Configurar jobs Hangfire",
113
- "Definir retry policies",
114
- "Implementar job chaining",
115
- "Monitorar via dashboard"
116
- ],
117
- "patterns": ["AutomaticRetry", "Queue attribute", "DisableConcurrentExecution"]
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"],
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"]
118
142
  },
119
- {
120
- "id": "uiux-designer",
121
- "name": "UI/UX Designer",
122
- "emoji": "🎨",
123
- "type": "specialist",
124
- "skillPath": ".claude/skills/specialists/ui-ux-designer.md",
125
- "description": "Especialista em UI/UX, Fluent UI Blazor e MudBlazor. FASE 1.5 obrigatória para features com front-end.",
126
- "autoActivation": {
127
- "keywords": [
128
- "blazor", "component", "page", "razor", "ui", "ux", "design", "layout", "responsive",
129
- "wizard", "dashboard", "form", "chart", "table", "dialog", "modal", "button",
130
- "input", "select", "dropdown", "menu", "navigation", "sidebar", "header", "footer",
131
- "tela", "telas", "interface", "formulario", "visualizacao", "exibicao",
132
- "screen", "screens", "view", "views", "display",
133
- "mostrar", "exibir", "apresentar", "renderizar", "show", "render", "present",
134
- "card", "cards", "list", "lists", "grid", "panel", "panels", "stepper", "tabs", "tab",
135
- "login", "signup", "cadastro", "report", "reports", "detail", "details", "edit", "create",
136
- "frontend", "front-end", "web", "app", "application", "client-side", "clientside",
137
- "redesign", "redesenhar", "bonito", "bonitas", "visual", "estetica", "aesthetics",
138
- "css", "design system", "refresh", "modernizar", "modernize",
139
- "melhorar visual", "mais bonito", "prettier", "beautiful",
140
- "prototipo", "prototype", "figma", "html para", "converter design", "replicar",
141
- "from design", "based on mockup", "mockup", "wireframe"
142
- ]
143
- },
144
- "validatesPhases": ["uiux-design"],
145
- "responsibilities": [
146
- "Coletar input do usuário sobre preferências de UI/UX",
147
- "Analisar screenshots/mockups de referência",
148
- "Gerar wireframes ASCII e mockups",
149
- "Especificar componentes Fluent UI ou MudBlazor",
150
- "Desenhar fluxos de usuário completos",
151
- "Documentar edge cases e estados (loading, error, empty)",
152
- "Garantir acessibilidade WCAG 2.1",
153
- "Validar responsividade (desktop, tablet, mobile)"
154
- ],
155
- "deliverables": [
156
- "ui-design-system.md (cores, tipografia, spacing)",
157
- "ui-mockups.md (wireframes ASCII + descrições)",
158
- "ui-components.md (specs Fluent UI/MudBlazor)",
159
- "ui-flows.md (fluxos + diagramas + edge cases)"
160
- ],
161
- "expertise": [
162
- "Fluent UI Blazor (AI-first components)",
163
- "MudBlazor (complex components)",
164
- "WCAG 2.1 Accessibility",
165
- "Responsive Design",
166
- "ASCII wireframing",
167
- "User flow diagrams"
168
- ],
169
- "workflow": [
170
- "1. Perguntar ao usuário sobre preferências de layout/referências",
171
- "2. Analisar imagens de exemplo (se fornecidas)",
172
- "3. Decidir Fluent UI vs MudBlazor (justificar)",
173
- "4. Gerar ui-mockups.md, ui-components.md, ui-flows.md",
174
- "5. Pausar para aprovação do usuário"
175
- ]
143
+ "standards": ["fluent-ui-blazor.md", "mudblazor-blazor.md", "css-naming.md", "css-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"
176
167
  },
177
- {
178
- "id": "popm-advisor",
179
- "name": "PO/PM Advisor",
180
- "emoji": "📋",
181
- "type": "specialist",
182
- "skillPath": ".claude/skills/specialists/po-pm-advisor.md",
183
- "description": "Consultor de produto e requisitos",
184
- "autoActivation": {
185
- "keywords": ["unclear", "requirements", "priority", "roi", "business", "value", "scope"]
186
- },
187
- "responsibilities": [
188
- "Clarificar requisitos vagos",
189
- "Priorizar funcionalidades",
190
- "Definir MVP vs Nice-to-have",
191
- "Questionar valor de negócio"
192
- ],
193
- "techniques": ["5 Whys", "MoSCoW", "User story mapping"]
168
+ "standards": ["coding.md", "blazor-efcore.md", "dotnet10-compatibility.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"],
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"
194
190
  },
195
- {
196
- "id": "ai-system-architect",
197
- "name": "AI System Architect",
198
- "emoji": "🏗️",
199
- "type": "specialist",
200
- "skillPath": ".claude/skills/specialists/ai-system-architect.md",
201
- "description": "Especialista em arquitetura de sistemas agênticos e orquestração multi-agente",
202
- "autoActivation": {
203
- "keywords": [
204
- "orchestration", "multi-agent", "workflow", "agent-to-agent", "a2a",
205
- "system-design", "reflection", "planning", "memory", "rag",
206
- "vector-search", "chunking", "embedding", "retrieval", "agentic",
207
- "reasoning", "chain-of-thought", "tree-of-thought", "prompt-chaining",
208
- "routing", "parallelization", "collaboration", "evaluation",
209
- "guardrails", "prioritization", "exploration", "discovery"
210
- ]
211
- },
212
- "validatesPhases": ["design"],
213
- "responsibilities": [
214
- "Desenhar arquiteturas agênticas complexas e escaláveis",
215
- "Definir padrões de orquestração (workflows, comunicação inter-agentes)",
216
- "Implementar pipelines RAG (Retrieval-Augmented Generation)",
217
- "Avaliar estratégias de chunking, embedding e retrieval",
218
- "Selecionar padrões adequados dos 20 padrões de design agêntico",
219
- "Definir estrutura de memória e estado de agentes",
220
- "Implementar monitoramento e avaliação de sistemas agênticos"
221
- ],
222
- "expertise": [
223
- "20 Padrões de Design Agêntico",
224
- "Framework TACO (Taskers, Automators, Collaborators, Orchestrators)",
225
- "Microsoft Agent Framework Workflows",
226
- "Azure AI Search + RAG Pipeline",
227
- "Semantic Kernel Memory Connectors",
228
- "A2A (Agent-to-Agent) Protocol",
229
- "Reasoning Techniques (Chain of Thought, Tree of Thought)",
230
- "Multi-Agent Collaboration Patterns"
231
- ],
232
- "patterns": [
233
- "Prompt Chaining",
234
- "Routing",
235
- "Parallelization",
236
- "Reflection",
237
- "Multi-Agent Collaboration",
238
- "Memory Management",
239
- "RAG Pipeline",
240
- "Resource-Aware Optimization",
241
- "Evaluation and Monitoring"
242
- ]
191
+ "standards": ["coding.md", "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"
243
213
  },
244
- {
245
- "id": "code-analyzer",
246
- "name": "Code Analyzer",
247
- "emoji": "🔍",
248
- "type": "specialist",
249
- "skillPath": ".claude/skills/specialists/code-analyzer.md",
250
- "description": "Deep code analysis: architecture review, clean code checks, duplication detection",
251
- "autoActivation": {
252
- "keywords": [
253
- "analyze", "analysis", "review", "refactor", "refactoring",
254
- "clean code", "smell", "smells", "code smell",
255
- "duplicate", "duplication", "duplicated",
256
- "architecture review", "quality", "code quality",
257
- "tech debt", "technical debt",
258
- "unused", "dead code", "dead-code",
259
- "code review", "code analysis"
260
- ]
261
- },
262
- "validatesPhases": ["implement"],
263
- "responsibilities": [
264
- "Analyze architecture for structural issues and layer violations",
265
- "Detect code smells and clean code violations",
266
- "Find duplicate and redundant code across the codebase",
267
- "Validate naming conventions against coding.md",
268
- "Generate actionable findings with severity levels (CRITICAL/HIGH/MEDIUM/LOW)"
269
- ],
270
- "expertise": [
271
- "Architecture analysis",
272
- "Clean code principles",
273
- "Code duplication detection",
274
- "SOLID violations",
275
- "Naming convention enforcement"
276
- ]
214
+ "standards": ["coding.md", "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"
277
236
  },
278
- {
279
- "id": "testing-specialist",
280
- "name": "Testing Specialist",
281
- "emoji": "🧪",
282
- "type": "specialist",
283
- "skillPath": ".claude/skills/specialists/testing-specialist.md",
284
- "description": "Especialista em testes, mocking e simulação",
285
- "autoActivation": {
286
- "keywords": [
287
- "test", "tests", "testing", "teste", "testes",
288
- "mock", "mocks", "mocking", "fake", "fakes",
289
- "stub", "stubs", "spy", "spies",
290
- "simulate", "simulation", "simulacao",
291
- "unit", "integration", "e2e", "end-to-end",
292
- "xunit", "nunit", "moq", "nsubstitute",
293
- "coverage", "cobertura", "tdd", "bdd",
294
- "arrange", "act", "assert", "given", "when", "then",
295
- "fixture", "factory", "builder", "testdata"
296
- ]
297
- },
298
- "validatesPhases": ["implement"],
299
- "responsibilities": [
300
- "Definir estratégia de testes (unit, integration, e2e)",
301
- "Criar mocks e fakes para dependências externas",
302
- "Implementar test fixtures e data builders",
303
- "Garantir cobertura adequada de código",
304
- "Configurar ambiente de testes (TestContainers, etc.)",
305
- "Escrever testes legíveis seguindo padrões AAA/GWT",
306
- "Identificar edge cases para testar"
307
- ],
308
- "expertise": [
309
- "xUnit.net",
310
- "Moq / NSubstitute",
311
- "FluentAssertions",
312
- "TestContainers",
313
- "Bogus (fake data)",
314
- "Respawn (database reset)",
315
- "WireMock (HTTP mocking)",
316
- "bUnit (Blazor testing)"
317
- ],
318
- "patterns": [
319
- "Arrange-Act-Assert (AAA)",
320
- "Given-When-Then (BDD)",
321
- "Test Data Builders",
322
- "Object Mother",
323
- "Test Fixtures",
324
- "Mocking vs Faking",
325
- "Integration Test Isolation"
326
- ]
237
+ "standards": ["coding.md", "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"
327
259
  },
328
- {
329
- "id": "asaas-financial",
330
- "name": "Asaas Financial",
331
- "emoji": "💰",
332
- "type": "integration",
333
- "skillPath": ".claude/skills/integrations/asaas-financial.md",
334
- "description": "Integration with Asaas payment platform (PIX, Boleto, Credit Card)",
335
- "autoActivation": {
336
- "keywords": ["asaas", "payment", "pix", "boleto", "cobranca", "subscription", "billing", "pagamento"]
337
- },
338
- "validatesPhases": ["design", "implement"]
260
+ "standards": ["coding.md", "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": ["coding.md", "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"
339
305
  },
340
- {
341
- "id": "clerk-auth",
342
- "name": "Clerk Auth",
343
- "emoji": "🔐",
344
- "type": "integration",
345
- "skillPath": ".claude/skills/integrations/clerk-auth.md",
346
- "description": "Authentication with Clerk SaaS platform",
347
- "autoActivation": {
348
- "keywords": ["clerk", "auth", "login", "signup", "authentication", "session"]
349
- },
350
- "validatesPhases": ["design", "implement"]
306
+ "standards": ["coding.md", "agent-framework-setup.md", "agent-framework-workflows.md", "agent-framework-production.md", "agent-framework-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
+ "asaas-financial": {
315
+ "tier": 3,
316
+ "role": "specialist",
317
+ "title": "Payment Integration Specialist (Brazil)",
318
+ "domains": ["integration-payment"],
319
+ "keywords": ["asaas", "payment", "pix", "boleto", "credit card", "subscription", "pagamento"],
320
+ "always_active": false,
321
+ "validators": ["architecture", "contract-compliance"],
322
+ "relationships": {
323
+ "reports_to": "dotnet-senior",
324
+ "coordinates": [],
325
+ "escalates_to": "dotnet-senior",
326
+ "collaborates_with": ["blazor-builder", "nextjs-expert"],
327
+ "team_role": "specialist"
351
328
  },
352
- {
353
- "id": "azure-identity",
354
- "name": "Azure Identity",
355
- "emoji": "🆔",
356
- "type": "integration",
357
- "skillPath": ".claude/skills/integrations/azure-identity.md",
358
- "description": "Microsoft Identity Platform for .NET/Blazor",
359
- "autoActivation": {
360
- "keywords": ["identity", "entra", "azure ad", "microsoft auth", "msal", "oauth", "oidc"]
361
- },
362
- "validatesPhases": ["design", "implement"]
329
+ "standards": ["coding.md", "architecture.md"],
330
+ "teammate": {
331
+ "role": "Payment Integration Specialist",
332
+ "icon": "💳",
333
+ "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."
334
+ }
335
+ },
336
+
337
+ "clerk-auth": {
338
+ "tier": 3,
339
+ "role": "specialist",
340
+ "title": "Auth SaaS Integration Specialist",
341
+ "domains": ["integration-auth"],
342
+ "keywords": ["clerk", "auth", "login", "signup", "oauth", "authentication"],
343
+ "always_active": false,
344
+ "validators": ["architecture"],
345
+ "relationships": {
346
+ "reports_to": "dotnet-senior",
347
+ "coordinates": [],
348
+ "escalates_to": "dotnet-senior",
349
+ "collaborates_with": ["blazor-builder", "nextjs-expert", "azure-identity"],
350
+ "team_role": "specialist"
351
+ },
352
+ "standards": ["coding.md", "architecture.md"],
353
+ "teammate": {
354
+ "role": "Auth SaaS Integration Specialist",
355
+ "icon": "🔐",
356
+ "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."
357
+ }
358
+ },
359
+
360
+ "resend-email": {
361
+ "tier": 3,
362
+ "role": "specialist",
363
+ "title": "Email Integration Specialist",
364
+ "domains": ["integration-email"],
365
+ "keywords": ["resend", "email", "transactional", "notification", "template", "smtp"],
366
+ "always_active": false,
367
+ "validators": ["architecture", "contract-compliance"],
368
+ "relationships": {
369
+ "reports_to": "dotnet-senior",
370
+ "coordinates": [],
371
+ "escalates_to": "dotnet-senior",
372
+ "collaborates_with": ["hangfire-orchestrator"],
373
+ "team_role": "specialist"
363
374
  },
364
- {
365
- "id": "resend-email",
366
- "name": "Resend Email",
367
- "emoji": "📧",
368
- "type": "integration",
369
- "skillPath": ".claude/skills/integrations/resend-email.md",
370
- "description": "Transactional email via Resend API",
371
- "autoActivation": {
372
- "keywords": ["resend", "email", "envio", "transactional", "notification", "send email"]
373
- },
374
- "validatesPhases": ["design", "implement"]
375
+ "standards": ["coding.md", "architecture.md"],
376
+ "teammate": {
377
+ "role": "Email Integration Specialist",
378
+ "icon": "📧",
379
+ "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."
380
+ }
381
+ },
382
+
383
+ "_comment_tier_3_frontend": "=== TIER 3: FRONTEND SPECIALISTS (3) ===",
384
+
385
+ "blazor-builder": {
386
+ "tier": 3,
387
+ "role": "specialist",
388
+ "title": "Blazor Development Specialist",
389
+ "domains": ["frontend-blazor"],
390
+ "keywords": ["blazor", "razor", "server-side", "component", "fluent ui", "mudblazor", "signalr"],
391
+ "always_active": false,
392
+ "validators": ["architecture", "blazor", "blazor-concurrency", "blazor-state", "css", "design-system"],
393
+ "relationships": {
394
+ "reports_to": "ui-designer",
395
+ "coordinates": [],
396
+ "escalates_to": "standards-architect",
397
+ "collaborates_with": ["ef-modeler", "api-designer", "css-specialist"],
398
+ "team_role": "specialist",
399
+ "active_phases": ["uiux", "implement"]
400
+ },
401
+ "standards": ["coding.md", "blazor-lifecycle.md", "blazor-state.md", "blazor-pitfalls.md", "blazor-efcore.md", "fluent-ui-blazor.md", "mudblazor-blazor.md"],
402
+ "teammate": {
403
+ "role": "Blazor Development Specialist",
404
+ "icon": "⚡",
405
+ "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."
406
+ }
407
+ },
408
+
409
+ "nextjs-expert": {
410
+ "tier": 3,
411
+ "role": "specialist",
412
+ "title": "Next.js Development Specialist",
413
+ "domains": ["frontend-nextjs"],
414
+ "keywords": ["nextjs", "next.js", "react", "api", "frontend", "shadcn", "tanstack", "server actions"],
415
+ "always_active": false,
416
+ "validators": ["packages"],
417
+ "relationships": {
418
+ "reports_to": "ui-designer",
419
+ "coordinates": [],
420
+ "escalates_to": "standards-architect",
421
+ "collaborates_with": ["api-designer", "css-specialist"],
422
+ "team_role": "specialist",
423
+ "active_phases": ["uiux", "implement"]
424
+ },
425
+ "standards": ["coding.md", "dotnet10-compatibility.md"],
426
+ "teammate": {
427
+ "role": "Next.js Development Specialist",
428
+ "icon": "⚛️",
429
+ "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."
430
+ }
431
+ },
432
+
433
+ "css-specialist": {
434
+ "tier": 3,
435
+ "role": "specialist",
436
+ "title": "CSS & Design System Specialist",
437
+ "domains": ["frontend-css"],
438
+ "keywords": ["css", "design system", "styling", "theme", "design tokens", "palette"],
439
+ "always_active": false,
440
+ "validators": ["css", "contrast", "design-system"],
441
+ "relationships": {
442
+ "reports_to": "ui-designer",
443
+ "coordinates": [],
444
+ "escalates_to": "ui-designer",
445
+ "collaborates_with": ["blazor-builder", "nextjs-expert"],
446
+ "team_role": "specialist",
447
+ "active_phases": ["implement"]
448
+ },
449
+ "standards": ["css-naming.md", "css-animations.md"],
450
+ "teammate": {
451
+ "role": "CSS & Design System Specialist",
452
+ "icon": "🎨",
453
+ "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."
454
+ }
455
+ },
456
+
457
+ "_comment_tier_3_infra": "=== TIER 3: INFRASTRUCTURE SPECIALISTS (4) ===",
458
+
459
+ "bicep-architect": {
460
+ "tier": 3,
461
+ "role": "specialist",
462
+ "title": "Infrastructure as Code Specialist",
463
+ "domains": ["infrastructure-iac"],
464
+ "keywords": ["bicep", "iac", "infra", "provision", "arm template", "infrastructure as code"],
465
+ "always_active": true,
466
+ "validators": ["architecture"],
467
+ "relationships": {
468
+ "reports_to": "azure-architect",
469
+ "coordinates": [],
470
+ "escalates_to": "azure-architect",
471
+ "collaborates_with": ["devops-engineer", "container-specialist"],
472
+ "team_role": "specialist"
473
+ },
474
+ "standards": ["coding.md", "architecture.md", "azure.md"],
475
+ "teammate": {
476
+ "role": "Infrastructure as Code Specialist",
477
+ "icon": "📜",
478
+ "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."
479
+ }
480
+ },
481
+
482
+ "devops-engineer": {
483
+ "tier": 3,
484
+ "role": "specialist",
485
+ "title": "CI/CD Specialist",
486
+ "domains": ["infrastructure-cicd"],
487
+ "keywords": ["pipeline", "ci/cd", "deploy", "release", "github actions", "azure pipelines", "deployment"],
488
+ "always_active": false,
489
+ "validators": ["architecture"],
490
+ "relationships": {
491
+ "reports_to": "azure-architect",
492
+ "coordinates": [],
493
+ "escalates_to": "azure-architect",
494
+ "collaborates_with": ["bicep-architect", "container-specialist"],
495
+ "team_role": "specialist"
496
+ },
497
+ "standards": ["coding.md", "architecture.md"],
498
+ "teammate": {
499
+ "role": "CI/CD Specialist",
500
+ "icon": "🚀",
501
+ "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."
502
+ }
503
+ },
504
+
505
+ "container-specialist": {
506
+ "tier": 3,
507
+ "role": "specialist",
508
+ "title": "Containerization Specialist",
509
+ "domains": ["infrastructure-containers"],
510
+ "keywords": ["docker", "container", "containerize", "dockerfile", "multi-stage", "container apps"],
511
+ "always_active": false,
512
+ "validators": ["architecture"],
513
+ "relationships": {
514
+ "reports_to": "azure-architect",
515
+ "coordinates": [],
516
+ "escalates_to": "azure-architect",
517
+ "collaborates_with": ["bicep-architect", "devops-engineer"],
518
+ "team_role": "specialist"
519
+ },
520
+ "standards": ["coding.md", "architecture.md"],
521
+ "teammate": {
522
+ "role": "Containerization Specialist",
523
+ "icon": "🐳",
524
+ "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."
525
+ }
526
+ },
527
+
528
+ "observability-expert": {
529
+ "tier": 3,
530
+ "role": "specialist",
531
+ "title": "Observability Specialist",
532
+ "domains": ["infrastructure-observability"],
533
+ "keywords": ["monitoring", "logging", "tracing", "metrics", "app insights", "serilog", "opentelemetry", "dashboards", "alerts"],
534
+ "always_active": false,
535
+ "validators": ["observability"],
536
+ "relationships": {
537
+ "reports_to": "azure-architect",
538
+ "coordinates": [],
539
+ "escalates_to": "azure-architect",
540
+ "collaborates_with": ["dotnet-senior", "ms-agent-expert"],
541
+ "team_role": "specialist"
542
+ },
543
+ "standards": ["coding.md", "architecture.md"],
544
+ "teammate": {
545
+ "role": "Observability Specialist",
546
+ "icon": "📊",
547
+ "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)."
548
+ }
549
+ },
550
+
551
+ "azure-identity": {
552
+ "tier": 3,
553
+ "role": "specialist",
554
+ "title": "Microsoft Identity Specialist",
555
+ "domains": ["infrastructure-identity"],
556
+ "keywords": ["identity", "entra", "microsoft auth", "azure ad", "b2c", "passkeys", "webauthn", "managed identity"],
557
+ "always_active": false,
558
+ "validators": ["architecture"],
559
+ "relationships": {
560
+ "reports_to": "azure-architect",
561
+ "coordinates": [],
562
+ "escalates_to": "azure-architect",
563
+ "collaborates_with": ["blazor-builder", "nextjs-expert", "clerk-auth"],
564
+ "team_role": "specialist"
565
+ },
566
+ "standards": ["coding.md", "architecture.md"],
567
+ "teammate": {
568
+ "role": "Microsoft Identity Specialist",
569
+ "icon": "🔑",
570
+ "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."
571
+ }
572
+ },
573
+
574
+ "_comment_tier_3_quality": "=== TIER 3: QUALITY SPECIALISTS (6) ===",
575
+
576
+ "testing-specialist": {
577
+ "tier": 3,
578
+ "role": "specialist",
579
+ "title": "Testing Specialist",
580
+ "domains": ["quality-testing"],
581
+ "keywords": ["test", "testing", "unit", "integration", "e2e", "xunit", "moq", "testcontainers", "bunit"],
582
+ "always_active": false,
583
+ "validators": ["architecture"],
584
+ "relationships": {
585
+ "reports_to": "standards-architect",
586
+ "coordinates": [],
587
+ "escalates_to": "standards-architect",
588
+ "collaborates_with": ["dotnet-senior", "blazor-builder", "nextjs-expert"],
589
+ "team_role": "specialist"
590
+ },
591
+ "standards": ["coding.md", "architecture.md"],
592
+ "teammate": {
593
+ "role": "Testing Specialist",
594
+ "icon": "🧪",
595
+ "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."
596
+ }
597
+ },
598
+
599
+ "code-analyzer": {
600
+ "tier": 3,
601
+ "role": "specialist",
602
+ "title": "Code Quality Analyst",
603
+ "domains": ["quality-review"],
604
+ "keywords": ["analyze", "review", "refactor", "clean code", "smell", "duplicate", "solid", "architecture review"],
605
+ "always_active": false,
606
+ "validators": ["architecture", "packages"],
607
+ "relationships": {
608
+ "reports_to": "standards-architect",
609
+ "coordinates": [],
610
+ "escalates_to": "standards-architect",
611
+ "collaborates_with": ["dotnet-senior", "troubleshooting-expert"],
612
+ "team_role": "specialist"
613
+ },
614
+ "standards": ["coding.md", "architecture.md"],
615
+ "teammate": {
616
+ "role": "Code Quality Analyst",
617
+ "icon": "🔍",
618
+ "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."
619
+ }
620
+ },
621
+
622
+ "troubleshooting-expert": {
623
+ "tier": 3,
624
+ "role": "specialist",
625
+ "title": "Troubleshooting & Debug Expert",
626
+ "domains": ["quality-debug"],
627
+ "keywords": ["debug", "troubleshoot", "root cause", "analyze error", "investigate", "diagnose"],
628
+ "always_active": false,
629
+ "validators": [],
630
+ "relationships": {
631
+ "reports_to": "standards-architect",
632
+ "coordinates": [],
633
+ "escalates_to": "standards-architect",
634
+ "collaborates_with": ["code-analyzer", "testing-specialist"],
635
+ "team_role": "escalation_specialist",
636
+ "spawn_trigger": "escalation_after_3_failures"
637
+ },
638
+ "standards": ["coding.md", "architecture.md"],
639
+ "teammate": {
640
+ "role": "Troubleshooting Expert (Escalation)",
641
+ "icon": "🔧",
642
+ "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."
643
+ }
644
+ },
645
+
646
+ "load-testing-expert": {
647
+ "tier": 3,
648
+ "role": "specialist",
649
+ "title": "Load Testing & Performance Specialist",
650
+ "domains": ["quality-performance"],
651
+ "keywords": ["load test", "performance test", "k6", "jmeter", "stress test", "capacity planning", "bottleneck", "scalability", "concurrent users"],
652
+ "always_active": false,
653
+ "validators": ["performance"],
654
+ "relationships": {
655
+ "reports_to": "standards-architect",
656
+ "coordinates": [],
657
+ "escalates_to": "standards-architect",
658
+ "collaborates_with": ["azure-architect", "observability-expert"],
659
+ "team_role": "specialist"
660
+ },
661
+ "standards": ["coding.md", "architecture.md"],
662
+ "teammate": {
663
+ "role": "Load Testing Specialist",
664
+ "icon": "📈",
665
+ "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."
666
+ }
667
+ },
668
+
669
+ "documentation-specialist": {
670
+ "tier": 3,
671
+ "role": "specialist",
672
+ "title": "Documentation Specialist",
673
+ "domains": ["developer-experience-docs"],
674
+ "keywords": ["readme", "documentation", "api docs", "contributing", "deployment guide", "onboarding"],
675
+ "always_active": false,
676
+ "validators": [],
677
+ "relationships": {
678
+ "reports_to": "standards-architect",
679
+ "coordinates": [],
680
+ "escalates_to": "standards-architect",
681
+ "collaborates_with": ["api-designer", "devops-engineer"],
682
+ "team_role": "post_implementation",
683
+ "spawn_trigger": "post_fase_5"
684
+ },
685
+ "standards": ["coding.md", "architecture.md"],
686
+ "teammate": {
687
+ "role": "Documentation Specialist (Post-FASE 5)",
688
+ "icon": "📝",
689
+ "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."
690
+ }
691
+ },
692
+
693
+ "_comment_tier_4": "=== TIER 4: VALIDATORS (1) ===",
694
+
695
+ "security-expert": {
696
+ "tier": 4,
697
+ "role": "validator",
698
+ "title": "Security Validator",
699
+ "domains": ["security"],
700
+ "keywords": ["sql injection", "xss", "secrets", "security scan", "vulnerability", "csrf", "insecure deserialization"],
701
+ "always_active": true,
702
+ "validators": ["security"],
703
+ "relationships": {
704
+ "reports_to": "standards-architect",
705
+ "coordinates": [],
706
+ "runs_in": "hooks",
707
+ "hook_triggers": ["TeammateIdle", "TaskCompleted"],
708
+ "team_role": "validator"
709
+ },
710
+ "standards": ["coding.md", "architecture.md"],
711
+ "teammate": null,
712
+ "hook_behavior": {
713
+ "validates": [
714
+ "SQL injection (string concatenation in queries)",
715
+ "Hardcoded secrets (API keys, passwords, connection strings)",
716
+ "XSS (@Html.Raw usage in Razor/Blazor)",
717
+ "Insecure deserialization (BinaryFormatter)",
718
+ "CSRF (missing anti-forgery tokens)"
719
+ ],
720
+ "severity": "error",
721
+ "blocks_on_fail": true
722
+ }
723
+ }
724
+ },
725
+
726
+ "squads": {
727
+ "backend_squad": {
728
+ "leader": "dotnet-senior",
729
+ "members": ["ef-modeler", "event-architect", "api-designer", "nosql-cache-expert", "ddd-expert", "hangfire-orchestrator", "ms-agent-expert", "asaas-financial", "clerk-auth", "resend-email"],
730
+ "domains": ["backend", "backend-data", "backend-events", "backend-api", "backend-nosql", "backend-ddd", "backend-jobs", "ai-agents", "integration-payment", "integration-auth", "integration-email"]
731
+ },
732
+ "frontend_squad": {
733
+ "leader": "ui-designer",
734
+ "members": ["blazor-builder", "nextjs-expert", "css-specialist"],
735
+ "domains": ["frontend-design", "frontend-blazor", "frontend-nextjs", "frontend-css"],
736
+ "active_phases": {
737
+ "design": ["ui-designer"],
738
+ "implement": ["blazor-builder", "nextjs-expert", "css-specialist"]
375
739
  }
376
- ]
740
+ },
741
+ "infrastructure_squad": {
742
+ "leader": "azure-architect",
743
+ "members": ["bicep-architect", "devops-engineer", "container-specialist", "observability-expert", "azure-identity"],
744
+ "domains": ["infrastructure", "infrastructure-iac", "infrastructure-cicd", "infrastructure-containers", "infrastructure-observability", "infrastructure-identity"]
745
+ },
746
+ "quality_squad": {
747
+ "leader": "standards-architect",
748
+ "members": ["testing-specialist", "code-analyzer", "troubleshooting-expert", "load-testing-expert", "documentation-specialist"],
749
+ "domains": ["quality-testing", "quality-review", "quality-debug", "quality-performance", "developer-experience-docs"],
750
+ "note": "No permanent leader — standards-architect coordinates directly"
751
+ }
752
+ },
753
+
754
+ "relationship_types": {
755
+ "reports_to": "Hierarchical manager relationship",
756
+ "coordinates": "Manages/leads these agents",
757
+ "escalates_to": "Where to escalate unresolved issues",
758
+ "collaborates_with": "Peer agents for cross-domain work",
759
+ "runs_in": "Execution context (hooks, not teammates)",
760
+ "team_role": "Role in Agent Teams (lead, domain_leader, specialist, validator, escalation_specialist, post_implementation, planning_only)"
377
761
  }
378
762
  }