@polymorphism-tech/morph-spec 3.1.0 → 4.2.0

package/stacks/blazor-azure/.morph/config/agents.json

@@ -1,764 +1,879 @@
-{
-  "$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", "page", "dashboard", "form", "UI", "settings", "interface", "screen", "panel", "portal", "view"],
-      "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", "real-time", "realtime", "websocket", "live updates"],
-      "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", "clerk auth", "add auth", "implement auth", "login", "signup", "oauth"],
-      "negativeKeywords": ["existing auth", "current auth", "integrate with auth", "already have auth"],
-      "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 email", "email notification", "send email", "email template", "smtp"],
-      "negativeKeywords": ["push notification", "in-app notification", "notification preference", "notification settings"],
-      "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", "page", "view", "form"],
-      "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)"
-  }
-}
+{
+  "$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": ["core/coding.md", "core/architecture.md", "backend/dotnet/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": ["core/coding.md", "core/architecture.md", "ai-agents/setup.md", "ai-agents/workflows.md", "ai-agents/production.md", "ai-agents/blazor-ui.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": ["core/coding.md", "core/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": ["core/coding.md", "core/architecture.md", "backend/dotnet/core.md", "backend/dotnet/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": ["infrastructure/azure/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": ["core/coding.md", "core/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", "page", "dashboard", "form", "UI", "settings", "interface", "screen", "panel", "portal", "view"],
+      "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": ["frontend/blazor/fluent-ui.md", "mudblazor-blazor.md", "frontend/design-system/naming.md", "frontend/design-system/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": ["core/coding.md", "backend/database/ef-core.md", "backend/dotnet/core.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", "real-time", "realtime", "websocket", "live updates"],
+      "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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "ai-agents/setup.md", "ai-agents/workflows.md", "ai-agents/production.md", "ai-agents/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": ["core/coding.md", "core/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", "clerk auth", "add auth", "implement auth", "login", "signup", "oauth"],
+      "negativeKeywords": ["existing auth", "current auth", "integrate with auth", "already have auth"],
+      "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": ["core/coding.md", "core/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 email", "email notification", "send email", "email template", "smtp"],
+      "negativeKeywords": ["push notification", "in-app notification", "notification preference", "notification settings"],
+      "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": ["core/coding.md", "core/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", "page", "view", "form"],
+      "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": ["core/coding.md", "frontend/blazor/lifecycle.md", "frontend/blazor/state.md", "frontend/blazor/pitfalls.md", "backend/database/ef-core.md", "frontend/blazor/fluent-ui.md", "mudblazor-blazor.md"],
+      "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": ["core/coding.md", "backend/dotnet/core.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": ["frontend/design-system/naming.md", "frontend/design-system/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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": ["core/coding.md", "core/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 (5) ===",
+
+    "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": ["core/coding.md", "core/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
+      }
+    },
+
+    "architecture-expert": {
+      "tier": 4,
+      "role": "validator",
+      "title": "Architecture Validator",
+      "domains": ["architecture"],
+      "keywords": ["architecture", "clean code", "solid", "dependency injection"],
+      "always_active": true,
+      "validators": ["architecture"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "runs_in": "hooks",
+        "hook_triggers": ["TeammateIdle", "TaskCompleted"],
+        "team_role": "validator"
+      },
+      "standards": ["core/coding.md", "core/architecture.md"],
+      "teammate": null,
+      "hook_behavior": {
+        "validates": [
+          "DbContext injection (IDbContextFactory required)",
+          "Async/await patterns (no .Result or .Wait)",
+          "DI registration order (services before middleware)",
+          "Blazor render mode compatibility"
+        ],
+        "severity": "error",
+        "blocks_on_fail": true
+      }
+    },
+
+    "packages-validator": {
+      "tier": 4,
+      "role": "validator",
+      "title": "Packages Validator",
+      "domains": ["packages"],
+      "keywords": ["nuget", "packages", "dependencies", "version conflict"],
+      "always_active": true,
+      "validators": ["packages"],
+      "relationships": {
+        "reports_to": "standards-architect",
+        "coordinates": [],
+        "runs_in": "hooks",
+        "hook_triggers": ["TaskCompleted"],
+        "team_role": "validator"
+      },
+      "standards": ["core/coding.md"],
+      "teammate": null,
+      "hook_behavior": {
+        "validates": [
+          "NuGet version conflicts (same package, different versions)",
+          "Incompatible .NET 10 packages",
+          "Security vulnerabilities (outdated packages)"
+        ],
+        "severity": "error",
+        "blocks_on_fail": true
+      }
+    },
+
+    "design-system-validator": {
+      "tier": 4,
+      "role": "validator",
+      "title": "Design System Validator",
+      "domains": ["design-system"],
+      "keywords": ["design system", "css", "color palette", "spacing"],
+      "always_active": true,
+      "validators": ["design-system"],
+      "relationships": {
+        "reports_to": "ui-designer",
+        "coordinates": [],
+        "runs_in": "hooks",
+        "hook_triggers": ["TeammateIdle"],
+        "team_role": "validator"
+      },
+      "standards": ["frontend/design-system/naming.md", "frontend/design-system/animations.md"],
+      "teammate": null,
+      "hook_behavior": {
+        "validates": [
+          "CSS color palette compliance (primary, secondary, accent)",
+          "Spacing values (use var(--spacing-*))",
+          "Typography scale (use var(--font-*))",
+          "Component naming (PascalCase for Blazor, kebab-case for CSS)"
+        ],
+        "severity": "warning",
+        "blocks_on_fail": false
+      }
+    },
+
+    "blazor-concurrency-validator": {
+      "tier": 4,
+      "role": "validator",
+      "title": "Blazor Concurrency Validator",
+      "domains": ["blazor-concurrency"],
+      "keywords": ["blazor", "dbcontext", "lifecycle", "async", "concurrency"],
+      "always_active": true,
+      "validators": ["blazor-concurrency"],
+      "relationships": {
+        "reports_to": "blazor-builder",
+        "coordinates": [],
+        "runs_in": "hooks",
+        "hook_triggers": ["TaskCompleted"],
+        "team_role": "validator"
+      },
+      "standards": ["frontend/blazor/lifecycle.md", "frontend/blazor/pitfalls.md", "frontend/blazor/state.md"],
+      "teammate": null,
+      "hook_behavior": {
+        "validates": [
+          "DbContext lifecycle violations (dispose, scope issues)",
+          "Async void methods (use async Task instead)",
+          "JSInterop in OnInitialized (move to OnAfterRender)",
+          "State mutation without StateHasChanged"
+        ],
+        "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)"
+  }
+}