@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/content/.morph/config/agents.json

@@ -1,242 +1,762 @@
-{
-  "version": "1.0.0",
-  "agents": {
-    "core": [
-      {
-        "id": "standards-architect",
-        "name": "Standards Architect",
-        "emoji": "📐",
-        "type": "core",
-        "skillPath": ".claude/skills/specialists/standards-architect.md",
-        "description": "Guardião dos padrões de código e arquitetura",
-        "responsibilities": [
-          "Validar aderência aos padrões em .morph/standards/",
-          "Revisar nomenclatura e estrutura de código",
-          "Garantir consistência entre features",
-          "Aprovar código antes de merge"
-        ],
-        "validatesPhases": ["design", "implement"]
-      },
-      {
-        "id": "azure-architect",
-        "name": "Azure Architect",
-        "emoji": "☁️",
-        "type": "core",
-        "skillPath": ".claude/skills/specialists/azure-architect.md",
-        "description": "Especialista em infraestrutura Azure",
-        "responsibilities": [
-          "Desenhar infraestrutura cost-effective",
-          "Configurar Container Apps com scale-to-zero",
-          "Definir estratégias de deployment",
-          "Gerenciar recursos e networking"
-        ],
-        "expertise": ["Container Apps", "Azure SQL", "ACR", "App Insights", "Managed Identity"]
-      },
-      {
-        "id": "blazor-builder",
-        "name": "Blazor Builder",
-        "emoji": "🔥",
-        "type": "core",
-        "skillPath": ".claude/skills/stacks/dotnet-blazor.md",
-        "description": "Especialista em componentes Blazor Server",
-        "responsibilities": [
-          "Criar componentes reutilizáveis",
-          "Implementar UI seguindo padrões",
-          "Gerenciar estado e lifecycle",
-          "Integrar SignalR quando necessário"
-        ],
-        "patterns": ["Component-per-file", "@inject para DI", "Loading states", "Error boundaries"]
-      },
-      {
-        "id": "ef-modeler",
-        "name": "EF Modeler",
-        "emoji": "🗄️",
-        "type": "core",
-        "skillPath": ".claude/skills/specialists/ef-modeler.md",
-        "description": "Especialista em Entity Framework e modelagem de dados",
-        "responsibilities": [
-          "Modelar entidades e relacionamentos",
-          "Criar migrations seguras",
-          "Otimizar queries com EF Core",
-          "Configurar DbContext"
-        ],
-        "patterns": ["Fluent API always", "Private setters", "Value Objects", "Owned Types"]
-      },
-      {
-        "id": "cost-guardian",
-        "name": "Cost Guardian",
-        "emoji": "💰",
-        "type": "core",
-        "skillPath": ".claude/skills/specialists/cost-guardian.md",
-        "description": "Guardião dos custos e otimização financeira",
-        "responsibilities": [
-          "Validar custos de cada recurso proposto",
-          "Alertar sobre recursos caros",
-          "Propor alternativas free/cheap",
-          "Bloquear recursos acima do budget"
-        ],
-        "limits": {
-          "noApproval": "Free tier only",
-          "withApproval": "$10/month",
-          "requiresJustification": ">$10/month"
-        }
-      },
-      {
-        "id": "ms-agent-expert",
-        "name": "MS Agent Expert",
-        "emoji": "🤖",
-        "type": "core",
-        "skillPath": ".claude/skills/specialists/ms-agent-expert.md",
-        "description": "Especialista em Microsoft Agent Framework e AI",
-        "responsibilities": [
-          "Integrar Semantic Kernel",
-          "Configurar plugins e skills",
-          "Otimizar prompts e tokens",
-          "Implementar agents para funcionalidades AI"
-        ],
-        "defaultModel": "gpt-4o-mini",
-        "patterns": ["KernelFunction", "DI de Kernel", "Structured outputs", "Retry exponential"]
-      }
-    ],
-    "specialists": [
-      {
-        "id": "hangfire-orchestrator",
-        "name": "Hangfire Orchestrator",
-        "emoji": "⏰",
-        "type": "specialist",
-        "skillPath": ".claude/skills/specialists/hangfire-orchestrator.md",
-        "description": "Especialista em background jobs",
-        "autoActivation": {
-          "keywords": ["scheduled", "job", "background", "recurring", "batch", "cron", "queue"]
-        },
-        "responsibilities": [
-          "Configurar jobs Hangfire",
-          "Definir retry policies",
-          "Implementar job chaining",
-          "Monitorar via dashboard"
-        ],
-        "patterns": ["AutomaticRetry", "Queue attribute", "DisableConcurrentExecution"]
-      },
-      {
-        "id": "uiux-designer",
-        "name": "UI/UX Designer",
-        "emoji": "🎨",
-        "type": "specialist",
-        "skillPath": ".claude/skills/specialists/ui-ux-designer.md",
-        "description": "Especialista em UI/UX, Fluent UI Blazor e MudBlazor. FASE 1.5 obrigatória para features com front-end.",
-        "autoActivation": {
-          "keywords": [
-            "blazor", "component", "page", "razor", "ui", "ux", "design", "layout", "responsive",
-            "wizard", "dashboard", "form", "chart", "table", "dialog", "modal", "button",
-            "input", "select", "dropdown", "menu", "navigation", "sidebar", "header", "footer",
-            "tela", "telas", "interface", "formulario", "visualizacao", "exibicao",
-            "screen", "screens", "view", "views", "display",
-            "mostrar", "exibir", "apresentar", "renderizar", "show", "render", "present",
-            "card", "cards", "list", "lists", "grid", "panel", "panels", "stepper", "tabs", "tab",
-            "login", "signup", "cadastro", "report", "reports", "detail", "details", "edit", "create",
-            "frontend", "front-end", "web", "app", "application", "client-side", "clientside"
-          ]
-        },
-        "validatesPhases": ["uiux-design"],
-        "responsibilities": [
-          "Coletar input do usuário sobre preferências de UI/UX",
-          "Analisar screenshots/mockups de referência",
-          "Gerar wireframes ASCII e mockups",
-          "Especificar componentes Fluent UI ou MudBlazor",
-          "Desenhar fluxos de usuário completos",
-          "Documentar edge cases e estados (loading, error, empty)",
-          "Garantir acessibilidade WCAG 2.1",
-          "Validar responsividade (desktop, tablet, mobile)"
-        ],
-        "deliverables": [
-          "ui-design-system.md (cores, tipografia, spacing)",
-          "ui-mockups.md (wireframes ASCII + descrições)",
-          "ui-components.md (specs Fluent UI/MudBlazor)",
-          "ui-flows.md (fluxos + diagramas + edge cases)"
-        ],
-        "expertise": [
-          "Fluent UI Blazor (AI-first components)",
-          "MudBlazor (complex components)",
-          "WCAG 2.1 Accessibility",
-          "Responsive Design",
-          "ASCII wireframing",
-          "User flow diagrams"
-        ],
-        "workflow": [
-          "1. Perguntar ao usuário sobre preferências de layout/referências",
-          "2. Analisar imagens de exemplo (se fornecidas)",
-          "3. Decidir Fluent UI vs MudBlazor (justificar)",
-          "4. Gerar ui-mockups.md, ui-components.md, ui-flows.md",
-          "5. Pausar para aprovação do usuário"
-        ]
-      },
-      {
-        "id": "popm-advisor",
-        "name": "PO/PM Advisor",
-        "emoji": "📋",
-        "type": "specialist",
-        "skillPath": ".claude/skills/specialists/po-pm-advisor.md",
-        "description": "Consultor de produto e requisitos",
-        "autoActivation": {
-          "keywords": ["unclear", "requirements", "priority", "roi", "business", "value", "scope"]
-        },
-        "responsibilities": [
-          "Clarificar requisitos vagos",
-          "Priorizar funcionalidades",
-          "Definir MVP vs Nice-to-have",
-          "Questionar valor de negócio"
-        ],
-        "techniques": ["5 Whys", "MoSCoW", "User story mapping"]
-      },
-      {
-        "id": "ai-system-architect",
-        "name": "AI System Architect",
-        "emoji": "🏗️",
-        "type": "specialist",
-        "skillPath": ".claude/skills/specialists/ai-system-architect.md",
-        "description": "Especialista em arquitetura de sistemas agênticos e orquestração multi-agente",
-        "autoActivation": {
-          "keywords": [
-            "orchestration", "multi-agent", "workflow", "agent-to-agent", "a2a",
-            "system-design", "reflection", "planning", "memory", "rag",
-            "vector-search", "chunking", "embedding", "retrieval", "agentic",
-            "reasoning", "chain-of-thought", "tree-of-thought", "prompt-chaining",
-            "routing", "parallelization", "collaboration", "evaluation",
-            "guardrails", "prioritization", "exploration", "discovery"
-          ]
-        },
-        "validatesPhases": ["design"],
-        "responsibilities": [
-          "Desenhar arquiteturas agênticas complexas e escaláveis",
-          "Definir padrões de orquestração (workflows, comunicação inter-agentes)",
-          "Implementar pipelines RAG (Retrieval-Augmented Generation)",
-          "Avaliar estratégias de chunking, embedding e retrieval",
-          "Selecionar padrões adequados dos 20 padrões de design agêntico",
-          "Definir estrutura de memória e estado de agentes",
-          "Implementar monitoramento e avaliação de sistemas agênticos"
-        ],
-        "expertise": [
-          "20 Padrões de Design Agêntico",
-          "Framework TACO (Taskers, Automators, Collaborators, Orchestrators)",
-          "Microsoft Agent Framework Workflows",
-          "Azure AI Search + RAG Pipeline",
-          "Semantic Kernel Memory Connectors",
-          "A2A (Agent-to-Agent) Protocol",
-          "Reasoning Techniques (Chain of Thought, Tree of Thought)",
-          "Multi-Agent Collaboration Patterns"
-        ],
-        "patterns": [
-          "Prompt Chaining",
-          "Routing",
-          "Parallelization",
-          "Reflection",
-          "Multi-Agent Collaboration",
-          "Memory Management",
-          "RAG Pipeline",
-          "Resource-Aware Optimization",
-          "Evaluation and Monitoring"
-        ]
-      }
-    ]
-  }
-}
+{
+  "$schema": "./agent-schema.json",
+  "version": "3.0.0-hierarchical",
+  "total_agents": 30,
+  "tiers": {
+    "tier_1_orchestrators": 3,
+    "tier_2_leaders": 3,
+    "tier_3_specialists": 23,
+    "tier_4_validators": 1
+  },
+
+  "agents": {
+
+    "_comment_tier_1": "=== TIER 1: ORCHESTRATORS (3) ===",
+
+    "standards-architect": {
+      "tier": 1,
+      "role": "orchestrator",
+      "title": "Chief Architect",
+      "domains": ["architecture", "developer-experience"],
+      "keywords": [],
+      "always_active": true,
+      "validators": ["architecture", "packages"],
+      "relationships": {
+        "reports_to": "user",
+        "coordinates": ["dotnet-senior", "azure-architect", "ui-designer", "testing-specialist", "code-analyzer", "troubleshooting-expert", "documentation-specialist", "load-testing-expert"],
+        "escalates_to": "user",
+        "team_role": "lead"
+      },
+      "standards": ["coding.md", "architecture.md", "program-cs-checklist.md"],
+      "teammate": {
+        "role": "Team Lead (Delegate Mode)",
+        "icon": "🎯",
+        "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."
+      }
+    },
+
+    "ai-system-architect": {
+      "tier": 1,
+      "role": "orchestrator",
+      "title": "AI/Agent Architect",
+      "domains": ["ai-orchestration", "architecture"],
+      "keywords": ["agent system", "ai architecture", "orchestration", "multi-agent", "agent workflow"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": ["ms-agent-expert"],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["dotnet-senior"],
+        "team_role": "orchestrator"
+      },
+      "standards": ["coding.md", "architecture.md", "agent-framework-setup.md", "agent-framework-workflows.md"],
+      "teammate": {
+        "role": "AI Architect",
+        "icon": "🤖",
+        "spawn_prompt": "You are the AI/Agent System Architect. Design agent workflows, tool integrations, and orchestration patterns. Coordinate with ms-agent-expert for implementation."
+      }
+    },
+
+    "popm-advisor": {
+      "tier": 1,
+      "role": "orchestrator",
+      "title": "Product/Project Advisor",
+      "domains": ["requirements", "business-value"],
+      "keywords": ["unclear", "requirements", "priority", "roi", "business value", "user story"],
+      "always_active": false,
+      "validators": [],
+      "relationships": {
+        "reports_to": "user",
+        "coordinates": [],
+        "team_role": "planning_only",
+        "active_phases": ["proposal", "setup", "design"]
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": null
+    },
+
+    "_comment_tier_2": "=== TIER 2: DOMAIN LEADERS (3) ===",
+
+    "dotnet-senior": {
+      "tier": 2,
+      "role": "domain-leader",
+      "title": "Backend Squad Leader",
+      "domains": ["backend"],
+      "keywords": ["backend", "api", "dotnet", ".net", "csharp", "c#", "web api", "minimal api"],
+      "always_active": true,
+      "validators": ["architecture", "packages"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": ["ef-modeler", "event-architect", "api-designer", "nosql-cache-expert", "ddd-expert", "hangfire-orchestrator", "ms-agent-expert", "asaas-financial", "clerk-auth", "resend-email"],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["azure-architect", "blazor-builder", "nextjs-expert"],
+        "team_role": "domain_leader"
+      },
+      "standards": ["coding.md", "architecture.md", "dotnet10-compatibility.md", "program-cs-checklist.md"],
+      "teammate": {
+        "role": "Backend Squad Leader",
+        "icon": "⚙️",
+        "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."
+      }
+    },
+
+    "azure-architect": {
+      "tier": 2,
+      "role": "domain-leader",
+      "title": "Infrastructure Squad Leader",
+      "domains": ["infrastructure"],
+      "keywords": ["azure", "cloud", "infrastructure", "infra", "deployment", "hosting"],
+      "always_active": true,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": ["bicep-architect", "devops-engineer", "container-specialist", "observability-expert", "azure-identity"],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["dotnet-senior", "blazor-builder", "nextjs-expert"],
+        "team_role": "domain_leader"
+      },
+      "standards": ["coding.md", "architecture.md", "azure.md"],
+      "teammate": {
+        "role": "Infrastructure Squad Leader",
+        "icon": "☁️",
+        "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."
+      }
+    },
+
+    "ui-designer": {
+      "tier": 2,
+      "role": "domain-leader",
+      "title": "UI/UX Squad Leader",
+      "domains": ["frontend-design"],
+      "keywords": ["wireframe", "mockup", "user flow", "ux", "design", "interface design", "user experience"],
+      "always_active": false,
+      "validators": ["design-system", "contrast"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": ["blazor-builder", "nextjs-expert", "css-specialist"],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["dotnet-senior"],
+        "team_role": "domain_leader",
+        "active_phases": ["uiux"]
+      },
+      "standards": ["fluent-ui-blazor.md", "mudblazor-blazor.md", "css-naming.md", "css-animations.md"],
+      "teammate": {
+        "role": "UI/UX Squad Leader (FASE 1.5)",
+        "icon": "🎨",
+        "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)."
+      }
+    },
+
+    "_comment_tier_3_backend": "=== TIER 3: BACKEND SPECIALISTS (10) ===",
+
+    "ef-modeler": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Data Persistence Specialist (Relational)",
+      "domains": ["backend-data"],
+      "keywords": ["entity", "database", "migration", "ef core", "entity framework", "sql", "dbcontext"],
+      "always_active": true,
+      "validators": ["architecture", "blazor-concurrency"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["blazor-builder", "nextjs-expert", "api-designer", "nosql-cache-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "blazor-efcore.md", "dotnet10-compatibility.md"],
+      "teammate": {
+        "role": "Data Persistence Specialist",
+        "icon": "🗄️",
+        "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."
+      }
+    },
+
+    "event-architect": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Event-Driven Architecture Specialist",
+      "domains": ["backend-events"],
+      "keywords": ["event", "service bus", "rabbitmq", "cqrs", "event sourcing", "messaging", "pub/sub", "domain events", "saga"],
+      "always_active": false,
+      "validators": ["architecture", "event-driven"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["ddd-expert", "api-designer", "azure-architect"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Event-Driven Architecture Specialist",
+        "icon": "📨",
+        "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."
+      }
+    },
+
+    "api-designer": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "API Design Specialist",
+      "domains": ["backend-api"],
+      "keywords": ["rest", "graphql", "grpc", "api", "openapi", "swagger", "versioning", "rate limiting", "hot chocolate", "endpoint"],
+      "always_active": false,
+      "validators": ["architecture", "api-design"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["ef-modeler", "event-architect", "blazor-builder", "nextjs-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "API Design Specialist",
+        "icon": "🔌",
+        "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."
+      }
+    },
+
+    "nosql-cache-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "NoSQL & Cache Specialist",
+      "domains": ["backend-nosql"],
+      "keywords": ["cosmos", "cosmosdb", "redis", "cache", "blob storage", "nosql", "document db", "key-value", "azure storage"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["ef-modeler", "azure-architect"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "NoSQL & Cache Specialist",
+        "icon": "💾",
+        "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."
+      }
+    },
+
+    "ddd-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Domain-Driven Design Expert",
+      "domains": ["backend-ddd"],
+      "keywords": ["ddd", "domain driven design", "aggregate", "entity", "value object", "domain event", "bounded context", "ubiquitous language"],
+      "always_active": false,
+      "validators": ["architecture", "ddd"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["ef-modeler", "event-architect", "api-designer"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "DDD Expert",
+        "icon": "📐",
+        "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."
+      }
+    },
+
+    "hangfire-orchestrator": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Background Jobs Specialist",
+      "domains": ["backend-jobs"],
+      "keywords": ["scheduled", "job", "background", "cron", "hangfire", "recurring", "fire and forget", "delayed"],
+      "always_active": false,
+      "validators": ["architecture", "blazor-concurrency"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["ef-modeler", "azure-architect"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Background Jobs Specialist",
+        "icon": "⏰",
+        "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."
+      }
+    },
+
+    "ms-agent-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Microsoft Agent Framework Expert",
+      "domains": ["ai-agents"],
+      "keywords": ["agent", "ai", "llm", "rag", "embedding", "mcp", "a2a", "middleware", "microsoft agent framework", "ichatclient"],
+      "always_active": false,
+      "validators": ["architecture", "packages"],
+      "relationships": {
+        "reports_to": "ai-system-architect",
+        "coordinates": [],
+        "escalates_to": "ai-system-architect",
+        "collaborates_with": ["dotnet-senior", "azure-architect"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "agent-framework-setup.md", "agent-framework-workflows.md", "agent-framework-production.md", "agent-framework-blazor-ui.md"],
+      "teammate": {
+        "role": "Microsoft Agent Framework Expert",
+        "icon": "🤖",
+        "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)."
+      }
+    },
+
+    "asaas-financial": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Payment Integration Specialist (Brazil)",
+      "domains": ["integration-payment"],
+      "keywords": ["asaas", "payment", "pix", "boleto", "credit card", "subscription", "pagamento"],
+      "always_active": false,
+      "validators": ["architecture", "contract-compliance"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["blazor-builder", "nextjs-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Payment Integration Specialist",
+        "icon": "💳",
+        "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."
+      }
+    },
+
+    "clerk-auth": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Auth SaaS Integration Specialist",
+      "domains": ["integration-auth"],
+      "keywords": ["clerk", "auth", "login", "signup", "oauth", "authentication"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["blazor-builder", "nextjs-expert", "azure-identity"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Auth SaaS Integration Specialist",
+        "icon": "🔐",
+        "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."
+      }
+    },
+
+    "resend-email": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Email Integration Specialist",
+      "domains": ["integration-email"],
+      "keywords": ["resend", "email", "transactional", "notification", "template", "smtp"],
+      "always_active": false,
+      "validators": ["architecture", "contract-compliance"],
+      "relationships": {
+        "reports_to": "dotnet-senior",
+        "coordinates": [],
+        "escalates_to": "dotnet-senior",
+        "collaborates_with": ["hangfire-orchestrator"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Email Integration Specialist",
+        "icon": "📧",
+        "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."
+      }
+    },
+
+    "_comment_tier_3_frontend": "=== TIER 3: FRONTEND SPECIALISTS (3) ===",
+
+    "blazor-builder": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Blazor Development Specialist",
+      "domains": ["frontend-blazor"],
+      "keywords": ["blazor", "razor", "server-side", "component", "fluent ui", "mudblazor", "signalr"],
+      "always_active": false,
+      "validators": ["architecture", "blazor", "blazor-concurrency", "blazor-state", "css", "design-system"],
+      "relationships": {
+        "reports_to": "ui-designer",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["ef-modeler", "api-designer", "css-specialist"],
+        "team_role": "specialist",
+        "active_phases": ["uiux", "implement"]
+      },
+      "standards": ["coding.md", "blazor-lifecycle.md", "blazor-state.md", "blazor-pitfalls.md", "blazor-efcore.md", "fluent-ui-blazor.md", "mudblazor-blazor.md"],
+      "teammate": {
+        "role": "Blazor Development Specialist",
+        "icon": "⚡",
+        "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."
+      }
+    },
+
+    "nextjs-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Next.js Development Specialist",
+      "domains": ["frontend-nextjs"],
+      "keywords": ["nextjs", "next.js", "react", "api", "frontend", "shadcn", "tanstack", "server actions"],
+      "always_active": false,
+      "validators": ["packages"],
+      "relationships": {
+        "reports_to": "ui-designer",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["api-designer", "css-specialist"],
+        "team_role": "specialist",
+        "active_phases": ["uiux", "implement"]
+      },
+      "standards": ["coding.md", "dotnet10-compatibility.md"],
+      "teammate": {
+        "role": "Next.js Development Specialist",
+        "icon": "⚛️",
+        "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."
+      }
+    },
+
+    "css-specialist": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "CSS & Design System Specialist",
+      "domains": ["frontend-css"],
+      "keywords": ["css", "design system", "styling", "theme", "design tokens", "palette"],
+      "always_active": false,
+      "validators": ["css", "contrast", "design-system"],
+      "relationships": {
+        "reports_to": "ui-designer",
+        "coordinates": [],
+        "escalates_to": "ui-designer",
+        "collaborates_with": ["blazor-builder", "nextjs-expert"],
+        "team_role": "specialist",
+        "active_phases": ["implement"]
+      },
+      "standards": ["css-naming.md", "css-animations.md"],
+      "teammate": {
+        "role": "CSS & Design System Specialist",
+        "icon": "🎨",
+        "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."
+      }
+    },
+
+    "_comment_tier_3_infra": "=== TIER 3: INFRASTRUCTURE SPECIALISTS (4) ===",
+
+    "bicep-architect": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Infrastructure as Code Specialist",
+      "domains": ["infrastructure-iac"],
+      "keywords": ["bicep", "iac", "infra", "provision", "arm template", "infrastructure as code"],
+      "always_active": true,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "azure-architect",
+        "coordinates": [],
+        "escalates_to": "azure-architect",
+        "collaborates_with": ["devops-engineer", "container-specialist"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md", "azure.md"],
+      "teammate": {
+        "role": "Infrastructure as Code Specialist",
+        "icon": "📜",
+        "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."
+      }
+    },
+
+    "devops-engineer": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "CI/CD Specialist",
+      "domains": ["infrastructure-cicd"],
+      "keywords": ["pipeline", "ci/cd", "deploy", "release", "github actions", "azure pipelines", "deployment"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "azure-architect",
+        "coordinates": [],
+        "escalates_to": "azure-architect",
+        "collaborates_with": ["bicep-architect", "container-specialist"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "CI/CD Specialist",
+        "icon": "🚀",
+        "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."
+      }
+    },
+
+    "container-specialist": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Containerization Specialist",
+      "domains": ["infrastructure-containers"],
+      "keywords": ["docker", "container", "containerize", "dockerfile", "multi-stage", "container apps"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "azure-architect",
+        "coordinates": [],
+        "escalates_to": "azure-architect",
+        "collaborates_with": ["bicep-architect", "devops-engineer"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Containerization Specialist",
+        "icon": "🐳",
+        "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."
+      }
+    },
+
+    "observability-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Observability Specialist",
+      "domains": ["infrastructure-observability"],
+      "keywords": ["monitoring", "logging", "tracing", "metrics", "app insights", "serilog", "opentelemetry", "dashboards", "alerts"],
+      "always_active": false,
+      "validators": ["observability"],
+      "relationships": {
+        "reports_to": "azure-architect",
+        "coordinates": [],
+        "escalates_to": "azure-architect",
+        "collaborates_with": ["dotnet-senior", "ms-agent-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Observability Specialist",
+        "icon": "📊",
+        "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)."
+      }
+    },
+
+    "azure-identity": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Microsoft Identity Specialist",
+      "domains": ["infrastructure-identity"],
+      "keywords": ["identity", "entra", "microsoft auth", "azure ad", "b2c", "passkeys", "webauthn", "managed identity"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "azure-architect",
+        "coordinates": [],
+        "escalates_to": "azure-architect",
+        "collaborates_with": ["blazor-builder", "nextjs-expert", "clerk-auth"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Microsoft Identity Specialist",
+        "icon": "🔑",
+        "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."
+      }
+    },
+
+    "_comment_tier_3_quality": "=== TIER 3: QUALITY SPECIALISTS (6) ===",
+
+    "testing-specialist": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Testing Specialist",
+      "domains": ["quality-testing"],
+      "keywords": ["test", "testing", "unit", "integration", "e2e", "xunit", "moq", "testcontainers", "bunit"],
+      "always_active": false,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["dotnet-senior", "blazor-builder", "nextjs-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Testing Specialist",
+        "icon": "🧪",
+        "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."
+      }
+    },
+
+    "code-analyzer": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Code Quality Analyst",
+      "domains": ["quality-review"],
+      "keywords": ["analyze", "review", "refactor", "clean code", "smell", "duplicate", "solid", "architecture review"],
+      "always_active": false,
+      "validators": ["architecture", "packages"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["dotnet-senior", "troubleshooting-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Code Quality Analyst",
+        "icon": "🔍",
+        "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."
+      }
+    },
+
+    "troubleshooting-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Troubleshooting & Debug Expert",
+      "domains": ["quality-debug"],
+      "keywords": ["debug", "troubleshoot", "root cause", "analyze error", "investigate", "diagnose"],
+      "always_active": false,
+      "validators": [],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["code-analyzer", "testing-specialist"],
+        "team_role": "escalation_specialist",
+        "spawn_trigger": "escalation_after_3_failures"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Troubleshooting Expert (Escalation)",
+        "icon": "🔧",
+        "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."
+      }
+    },
+
+    "load-testing-expert": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Load Testing & Performance Specialist",
+      "domains": ["quality-performance"],
+      "keywords": ["load test", "performance test", "k6", "jmeter", "stress test", "capacity planning", "bottleneck", "scalability", "concurrent users"],
+      "always_active": false,
+      "validators": ["performance"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["azure-architect", "observability-expert"],
+        "team_role": "specialist"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Load Testing Specialist",
+        "icon": "📈",
+        "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."
+      }
+    },
+
+    "documentation-specialist": {
+      "tier": 3,
+      "role": "specialist",
+      "title": "Documentation Specialist",
+      "domains": ["developer-experience-docs"],
+      "keywords": ["readme", "documentation", "api docs", "contributing", "deployment guide", "onboarding"],
+      "always_active": false,
+      "validators": [],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "escalates_to": "standards-architect",
+        "collaborates_with": ["api-designer", "devops-engineer"],
+        "team_role": "post_implementation",
+        "spawn_trigger": "post_fase_5"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": {
+        "role": "Documentation Specialist (Post-FASE 5)",
+        "icon": "📝",
+        "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."
+      }
+    },
+
+    "_comment_tier_4": "=== TIER 4: VALIDATORS (1) ===",
+
+    "security-expert": {
+      "tier": 4,
+      "role": "validator",
+      "title": "Security Validator",
+      "domains": ["security"],
+      "keywords": ["sql injection", "xss", "secrets", "security scan", "vulnerability", "csrf", "insecure deserialization"],
+      "always_active": true,
+      "validators": ["security"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "runs_in": "hooks",
+        "hook_triggers": ["TeammateIdle", "TaskCompleted"],
+        "team_role": "validator"
+      },
+      "standards": ["coding.md", "architecture.md"],
+      "teammate": null,
+      "hook_behavior": {
+        "validates": [
+          "SQL injection (string concatenation in queries)",
+          "Hardcoded secrets (API keys, passwords, connection strings)",
+          "XSS (@Html.Raw usage in Razor/Blazor)",
+          "Insecure deserialization (BinaryFormatter)",
+          "CSRF (missing anti-forgery tokens)"
+        ],
+        "severity": "error",
+        "blocks_on_fail": true
+      }
+    }
+  },
+
+  "squads": {
+    "backend_squad": {
+      "leader": "dotnet-senior",
+      "members": ["ef-modeler", "event-architect", "api-designer", "nosql-cache-expert", "ddd-expert", "hangfire-orchestrator", "ms-agent-expert", "asaas-financial", "clerk-auth", "resend-email"],
+      "domains": ["backend", "backend-data", "backend-events", "backend-api", "backend-nosql", "backend-ddd", "backend-jobs", "ai-agents", "integration-payment", "integration-auth", "integration-email"]
+    },
+    "frontend_squad": {
+      "leader": "ui-designer",
+      "members": ["blazor-builder", "nextjs-expert", "css-specialist"],
+      "domains": ["frontend-design", "frontend-blazor", "frontend-nextjs", "frontend-css"],
+      "active_phases": {
+        "design": ["ui-designer"],
+        "implement": ["blazor-builder", "nextjs-expert", "css-specialist"]
+      }
+    },
+    "infrastructure_squad": {
+      "leader": "azure-architect",
+      "members": ["bicep-architect", "devops-engineer", "container-specialist", "observability-expert", "azure-identity"],
+      "domains": ["infrastructure", "infrastructure-iac", "infrastructure-cicd", "infrastructure-containers", "infrastructure-observability", "infrastructure-identity"]
+    },
+    "quality_squad": {
+      "leader": "standards-architect",
+      "members": ["testing-specialist", "code-analyzer", "troubleshooting-expert", "load-testing-expert", "documentation-specialist"],
+      "domains": ["quality-testing", "quality-review", "quality-debug", "quality-performance", "developer-experience-docs"],
+      "note": "No permanent leader — standards-architect coordinates directly"
+    }
+  },
+
+  "relationship_types": {
+    "reports_to": "Hierarchical manager relationship",
+    "coordinates": "Manages/leads these agents",
+    "escalates_to": "Where to escalate unresolved issues",
+    "collaborates_with": "Peer agents for cross-domain work",
+    "runs_in": "Execution context (hooks, not teammates)",
+    "team_role": "Role in Agent Teams (lead, domain_leader, specialist, validator, escalation_specialist, post_implementation, planning_only)"
+  }
+}