@polymorphism-tech/morph-spec 7.0.0 → 7.1.0

package/framework/agents.json

@@ -1,127 +1,132 @@
-{
-  "version": "5.0.0",
-  "schema": "domain-personas",
-  "total_agents": 7,
-  "description": "Domain personas dispatched per task by the morph-implement skill. The 3 roles (Orchestrator/Specialist/Evaluator) are assumed by Claude itself per MORPH.md — these are domain personas the Specialist consults when working in a specific area.",
-  "agents": {
-    "dotnet-senior": {
-      "title": ".NET Senior Engineer",
-      "icon": "🔷",
-      "color": "blue",
-      "domains": ["backend", "backend-api", "architecture"],
-      "keywords": [
-        "backend", "api", "dotnet", ".net", "csharp", "c#",
-        "minimal api", "vertical slice", "vsa", "result pattern",
-        "feature slice", "endpoint", "handler", "validator"
-      ],
-      "stack": ["dotnet"],
-      "standards": [
-        "architecture-vertical-slice-vertical-slice",
-        "backend-dotnet-result-pattern",
-        "backend-dotnet-vsa-handler-patterns",
-        "backend-dotnet-fluent-validation-vsa"
-      ],
-      "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Não usa Repository pattern, não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros."
-    },
-    "ef-modeler": {
-      "title": "EF Core / Database Modeler",
-      "icon": "🗄️",
-      "color": "cyan",
-      "domains": ["database", "data-modeling", "migrations"],
-      "keywords": [
-        "ef core", "entity framework", "neon", "postgres", "postgresql",
-        "migration", "dbcontext", "navigation property", "configuration"
-      ],
-      "stack": ["dotnet"],
-      "standards": [
-        "backend-database-postgresql-database",
-        "infrastructure-neon-setup",
-        "infrastructure-neon-pgvector"
-      ],
-      "persona": "Você é um especialista em EF Core sobre Neon (Postgres). Pensa em migrations explícitas, configurações fluentes, navigation properties bem nomeadas, índices intencionais. Sempre Guid.CreateVersion7() para PKs. Sealed entities. Nunca leak de DbContext fora do handler."
-    },
-    "maf-expert": {
-      "title": "Microsoft Agent Framework Expert",
-      "icon": "🤖",
-      "color": "purple",
-      "domains": ["ai-agents", "ai-orchestration"],
-      "keywords": [
-        "agent", "ai agent", "maf", "microsoft agent framework",
-        "tool", "tool calling", "rag", "vector search", "llm",
-        "orchestration", "multi-agent"
-      ],
-      "stack": ["dotnet"],
-      "standards": [
-        "ai-agents-setup",
-        "ai-agents-workflows",
-        "ai-agents-production"
-      ],
-      "persona": "Você é especialista no Microsoft Agent Framework. Pensa em agentes como serviços com responsabilidade única, ferramentas tipadas, prompts versionados, telemetria de cada chamada. RAG com vector search, MCP quando aplicável. Não inventa orquestração quando MAF já oferece."
-    },
-    "nextjs-expert": {
-      "title": "Next.js / React Expert",
-      "icon": "⚛️",
-      "color": "green",
-      "domains": ["frontend", "ui", "react", "nextjs"],
-      "keywords": [
-        "nextjs", "next.js", "react", "app router", "server component",
-        "client component", "tailwind", "framer motion", "shadcn"
-      ],
-      "stack": ["nextjs"],
-      "standards": [
-        "frontend-nextjs-app-router",
-        "frontend-nextjs-components",
-        "frontend-nextjs-data-fetching",
-        "frontend-nextjs-naming-conventions",
-        "frontend-nextjs-state-management"
-      ],
-      "persona": "Você escreve Next.js App Router idiomático. Server Components por padrão, Client Components apenas quando há interatividade real. Tailwind + Shadcn + Framer Motion. Tipos via Zod. Nada de getServerSideProps. RSC streaming quando faz sentido."
-    },
-    "ui-designer": {
-      "title": "UI/UX Designer",
-      "icon": "🎨",
-      "color": "magenta",
-      "domains": ["ui", "ux", "design-system", "accessibility"],
-      "keywords": [
-        "design", "ui", "ux", "design system", "tokens", "wcag",
-        "accessibility", "mockup", "flow", "shadcn", "tailwind"
-      ],
-      "stack": ["nextjs"],
-      "standards": [
-        "frontend-design-system-naming",
-        "frontend-design-system-animations",
-        "frontend-nextjs-motion-patterns"
-      ],
-      "persona": "Você desenha sistemas, não telas isoladas. Pensa em tokens (cor, espaço, tipografia), componentes reutilizáveis, estados (default/hover/focus/disabled/loading/error), acessibilidade WCAG AA. Mockups em Tailwind direto, sem Figma intermediário."
-    },
-    "infra-engineer": {
-      "title": "Infrastructure / Jobs Engineer",
-      "icon": "⚙️",
-      "color": "yellow",
-      "domains": ["infrastructure", "jobs", "deployment", "observability"],
-      "keywords": [
-        "hangfire", "background job", "queue", "deployment",
-        "docker", "ci/cd", "telemetry", "logging", "monitoring"
-      ],
-      "stack": ["dotnet"],
-      "standards": [
-        "backend-integrations-hangfire-hangfire-jobs",
-        "infrastructure-docker-easypanel-deploy",
-        "backend-dotnet-scrutor"
-      ],
-      "persona": "Você cuida de infra: jobs assíncronos com Hangfire (apenas quando há razão real), deployment, observabilidade. Pensa em retry, idempotência, dead-letter, métricas. Não inventa infra — usa o que o stack já oferece."
-    },
-    "evaluator": {
-      "title": "Code & Architecture Evaluator",
-      "icon": "🔍",
-      "color": "red",
-      "domains": ["evaluation", "review", "quality"],
-      "keywords": [
-        "review", "eval", "score", "rubric", "audit", "quality"
-      ],
-      "stack": ["*"],
-      "standards": [],
-      "persona": "Você aplica as rubricas em framework/evals/rubrics/. Não reescreve código — produz scores 0-10 por dimensão (architecture, contracts, code-quality, test-coverage), feedback priorizado, e ação clara (aprovado/feedback/escalar). Silêncio em scores ≥ 8 é o sinal correto."
-    }
-  }
-}
+{
+  "version": "5.0.0",
+  "schema": "domain-personas",
+  "total_agents": 7,
+  "description": "Domain personas dispatched per task by the morph-implement skill. The 3 roles (Orchestrator/Specialist/Evaluator) are assumed by Claude itself per MORPH.md — these are domain personas the Specialist consults when working in a specific area.",
+  "agents": {
+    "dotnet-senior": {
+      "title": ".NET Senior Engineer",
+      "icon": "🔷",
+      "color": "blue",
+      "domains": ["backend", "backend-api", "architecture"],
+      "keywords": [
+        "backend", "api", "dotnet", ".net", "csharp", "c#",
+        "minimal api", "vertical slice", "vsa", "result pattern",
+        "feature slice", "endpoint", "handler", "validator"
+      ],
+      "stack": ["dotnet"],
+      "standards": [
+        "architecture-vertical-slice-vertical-slice",
+        "backend-dotnet-result-pattern",
+        "backend-dotnet-vsa-handler-patterns",
+        "backend-dotnet-fluent-validation-vsa"
+      ],
+      "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Não usa Repository pattern, não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros."
+    },
+    "ef-modeler": {
+      "title": "EF Core / Database Modeler",
+      "icon": "🗄️",
+      "color": "cyan",
+      "domains": ["database", "data-modeling", "migrations"],
+      "keywords": [
+        "ef core", "entity framework", "neon", "postgres", "postgresql",
+        "migration", "dbcontext", "navigation property", "configuration"
+      ],
+      "stack": ["dotnet"],
+      "standards": [
+        "backend-database-postgresql-database",
+        "infrastructure-neon-setup",
+        "infrastructure-neon-pgvector"
+      ],
+      "persona": "Você é um especialista em EF Core sobre Neon (Postgres). Pensa em migrations explícitas, configurações fluentes, navigation properties bem nomeadas, índices intencionais. Sempre Guid.CreateVersion7() para PKs. Sealed entities. Nunca leak de DbContext fora do handler."
+    },
+    "maf-expert": {
+      "title": "Microsoft Agent Framework Expert",
+      "icon": "🤖",
+      "color": "purple",
+      "domains": ["ai-agents", "ai-orchestration"],
+      "keywords": [
+        "agent", "ai agent", "maf", "microsoft agent framework",
+        "tool", "tool calling", "rag", "vector search", "llm",
+        "orchestration", "multi-agent"
+      ],
+      "stack": ["dotnet"],
+      "standards": [
+        "ai-agents-setup",
+        "ai-agents-sweet-spot",
+        "ai-agents-providers-model-registry",
+        "ai-agents-structured-output",
+        "ai-agents-prompts-in-db",
+        "ai-agents-rag-custom-pgvector",
+        "ai-agents-middleware-patterns",
+        "ai-agents-multi-agent-patterns"
+      ],
+      "persona": "Você é especialista no Microsoft Agent Framework (MAF 1.0 GA). Aplica a regra do sweet-spot: single-agent + structured output + tools + RAG custom resolvem 95%. Refere alias do Model Registry, nunca model hardcoded. Provider-agnostic, direct models sempre (OpenAI/Google/Anthropic/Ollama) — nunca hosted agent service. Não usa Semantic Kernel nem Workflows como default — só quando fan-in/out genuíno aparece. Telemetria via AgentOpenTelemetryConsts.DefaultSourceName."
+    },
+    "nextjs-expert": {
+      "title": "Next.js / React Expert",
+      "icon": "⚛️",
+      "color": "green",
+      "domains": ["frontend", "ui", "react", "nextjs"],
+      "keywords": [
+        "nextjs", "next.js", "react", "app router", "server component",
+        "client component", "tailwind", "framer motion", "shadcn"
+      ],
+      "stack": ["nextjs"],
+      "standards": [
+        "frontend-nextjs-app-router",
+        "frontend-nextjs-components",
+        "frontend-nextjs-data-fetching",
+        "frontend-nextjs-naming-conventions",
+        "frontend-nextjs-state-management"
+      ],
+      "persona": "Você escreve Next.js App Router idiomático. Server Components por padrão, Client Components apenas quando há interatividade real. Tailwind + Shadcn + Framer Motion. Tipos via Zod. Nada de getServerSideProps. RSC streaming quando faz sentido."
+    },
+    "ui-designer": {
+      "title": "UI/UX Designer",
+      "icon": "🎨",
+      "color": "magenta",
+      "domains": ["ui", "ux", "design-system", "accessibility"],
+      "keywords": [
+        "design", "ui", "ux", "design system", "tokens", "wcag",
+        "accessibility", "mockup", "flow", "shadcn", "tailwind"
+      ],
+      "stack": ["nextjs"],
+      "standards": [
+        "frontend-design-system-naming",
+        "frontend-design-system-animations",
+        "frontend-nextjs-motion-patterns"
+      ],
+      "persona": "Você desenha sistemas, não telas isoladas. Pensa em tokens (cor, espaço, tipografia), componentes reutilizáveis, estados (default/hover/focus/disabled/loading/error), acessibilidade WCAG AA. Mockups em Tailwind direto, sem Figma intermediário."
+    },
+    "infra-engineer": {
+      "title": "Infrastructure / Jobs Engineer",
+      "icon": "⚙️",
+      "color": "yellow",
+      "domains": ["infrastructure", "jobs", "deployment", "observability"],
+      "keywords": [
+        "hangfire", "background job", "queue", "deployment",
+        "docker", "ci/cd", "telemetry", "logging", "monitoring"
+      ],
+      "stack": ["dotnet"],
+      "standards": [
+        "backend-integrations-hangfire-hangfire-jobs",
+        "infrastructure-docker-easypanel-deploy",
+        "backend-dotnet-scrutor"
+      ],
+      "persona": "Você cuida de infra: jobs assíncronos com Hangfire (apenas quando há razão real), deployment, observabilidade. Pensa em retry, idempotência, dead-letter, métricas. Não inventa infra — usa o que o stack já oferece."
+    },
+    "evaluator": {
+      "title": "Code & Architecture Evaluator",
+      "icon": "🔍",
+      "color": "red",
+      "domains": ["evaluation", "review", "quality"],
+      "keywords": [
+        "review", "eval", "score", "rubric", "audit", "quality"
+      ],
+      "stack": ["*"],
+      "standards": [],
+      "persona": "Você aplica as rubricas em framework/evals/rubrics/. Não reescreve código — produz scores 0-10 por dimensão (architecture, contracts, code-quality, test-coverage), feedback priorizado, e ação clara (aprovado/feedback/escalar). Silêncio em scores ≥ 8 é o sinal correto."
+    }
+  }
+}

package/framework/rubrics/backend.json

@@ -1,36 +1,41 @@
-{
-  "id": "backend",
-  "version": "1.0.0",
-  "description": "Backend-focused rubric. Higher weight on architecture, security, and package health.",
-  "categories": {
-    "functionality": {
-      "weight": 0.30,
-      "validators": ["contract-compliance"],
-      "description": "Core feature correctness and contract compliance"
-    },
-    "code_quality": {
-      "weight": 0.30,
-      "validators": ["architecture"],
-      "description": "Architecture patterns, dependency direction, and code structure"
-    },
-    "design_ui": {
-      "weight": 0.05,
-      "validators": ["design-system", "css", "contrast", "nextjs-component"],
-      "description": "Design system compliance (minimal weight for backend projects)"
-    },
-    "security": {
-      "weight": 0.15,
-      "validators": [],
-      "description": "Security posture (agent-evaluated, no automated validator)"
-    },
-    "packages": {
-      "weight": 0.20,
-      "validators": ["packages"],
-      "description": "Dependency health, version compatibility, and deprecated packages"
-    }
-  },
-  "thresholds": {
-    "approve": 8.0,
-    "retry": 6.0
-  }
-}
+{
+  "id": "backend",
+  "version": "1.0.0",
+  "description": "Backend-focused rubric. Higher weight on architecture, security, and package health.",
+  "categories": {
+    "functionality": {
+      "weight": 0.25,
+      "validators": ["contract-compliance"],
+      "description": "Core feature correctness and contract compliance"
+    },
+    "code_quality": {
+      "weight": 0.25,
+      "validators": ["architecture"],
+      "description": "Architecture patterns, dependency direction, and code structure"
+    },
+    "design_ui": {
+      "weight": 0.05,
+      "validators": ["design-system", "css", "contrast", "nextjs-component"],
+      "description": "Design system compliance (minimal weight for backend projects)"
+    },
+    "security": {
+      "weight": 0.15,
+      "validators": [],
+      "description": "Security posture (agent-evaluated, no automated validator)"
+    },
+    "packages": {
+      "weight": 0.20,
+      "validators": ["packages"],
+      "description": "Dependency health, version compatibility, and deprecated packages"
+    },
+    "maf_compliance": {
+      "weight": 0.10,
+      "validators": [],
+      "description": "MAF agent compliance (agent-evaluated, applies only when the feature touches AI agents): Microsoft.Agents.AI GA packages used; Model Registry alias referenced not hardcoded models; structured output for pipelined agents; prompts from DB not hardcoded; no Semantic Kernel; no hosted agent services."
+    }
+  },
+  "thresholds": {
+    "approve": 8.0,
+    "retry": 6.0
+  }
+}

package/framework/rules/ai-agents-standards.md

@@ -1,15 +1,45 @@
----
-paths:
-  - "**/Agents/**"
-  - "**/agents/**"
-  - "**/*Agent*.cs"
-stacks:
-  - dotnet
----
-
-# Microsoft Agent Framework Standards
-
-@.morph/framework/standards/ai-agents/setup.md
-@.morph/framework/standards/ai-agents/workflows.md
-@.morph/framework/standards/ai-agents/production.md
-@.morph/framework/standards/integration/mcp/mcp-tools.md
+---
+paths:
+  - "**/Agents/**"
+  - "**/agents/**"
+  - "**/*Agent*.cs"
+stacks:
+  - dotnet
+---
+
+# Microsoft Agent Framework Standards
+
+> **Layer 0/1 — auto-carregados.** São os standards core: aplicam-se a praticamente todo
+> agente MAF. Carregue-os sempre que tocar código de agentes.
+
+@.morph/framework/standards/ai-agents/setup.md
+@.morph/framework/standards/ai-agents/sweet-spot.md
+@.morph/framework/standards/ai-agents/providers/model-registry.md
+@.morph/framework/standards/ai-agents/structured-output.md
+@.morph/framework/standards/ai-agents/multi-agent-patterns.md
+@.morph/framework/standards/ai-agents/prompts-in-db.md
+@.morph/framework/standards/ai-agents/rag-custom-pgvector.md
+@.morph/framework/standards/ai-agents/middleware-patterns.md
+@.morph/framework/standards/ai-agents/workflows.md
+@.morph/framework/standards/ai-agents/production.md
+
+---
+
+> **Layer 2 — sob demanda (NÃO auto-carregados).** São standards de modalidade, otimização e
+> MCP: relevantes apenas quando a feature usa especificamente esse recurso. Carregue via
+> `morph-standards` quando uma keyword corresponder — manter fora do auto-load preserva o
+> context window para o trabalho que importa.
+
+| Standard | Carregue quando a feature envolve |
+|----------|-----------------------------------|
+| `ai-agents/modalities-vision.md` | imagem → texto (OCR, análise de documento, visão) |
+| `ai-agents/modalities-image-gen.md` | texto → imagem (geração de mockups, posts, assets) |
+| `ai-agents/modalities-speech-to-text.md` | áudio → texto (transcrição, legendagem) |
+| `ai-agents/modalities-text-to-speech.md` | texto → áudio (síntese de voz) |
+| `ai-agents/batching.md` | processar N prompts independentes em lote (Batch API) |
+| `ai-agents/service-tier-flex.md` | otimização de custo em jobs assíncronos (tier flex) |
+| `ai-agents/agent-session.md` | agentes conversacionais com histórico/reducers |
+| `ai-agents/context-providers.md` | injeção dinâmica de contexto (`AIContextProvider`) |
+| `ai-agents/mcp-tools.md` | agente MAF consome um MCP server externo |
+| `ai-agents/mcp-server.md` | projeto expõe capacidades como MCP server |
+| `integration/mcp/mcp-tools.md` | integração MCP cross-domain (fora do escopo MAF) |

package/framework/rules/neon-standards.md

@@ -1,26 +1,25 @@
----
-paths:
-  - "**/neon/**"
-  - "**/database/**"
-  - "**/*Migration*.sql"
-  - "**/*migration*.sql"
-stacks:
-  - neon
----
-
-# Neon PostgreSQL Standards
-
-@.morph/framework/standards/infrastructure/neon/neon-setup.md
-@.morph/framework/standards/infrastructure/neon/neon-pgvector.md
-@.morph/framework/standards/infrastructure/neon/neon-pgrag.md
-@.morph/framework/standards/infrastructure/neon/neon-semantic-kernel.md
-@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
-
-## SQL Templates
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| PostgreSQL Migration | `.morph/framework/templates/code/sql/postgresql-migration.sql` | Database migration |
-| PostgreSQL RLS Policy | `.morph/framework/templates/code/sql/postgresql-rls-policy.sql` | Row-level security |
-
-Read the template and adapt to your project structure.
+---
+paths:
+  - "**/neon/**"
+  - "**/database/**"
+  - "**/*Migration*.sql"
+  - "**/*migration*.sql"
+stacks:
+  - neon
+---
+
+# Neon PostgreSQL Standards
+
+@.morph/framework/standards/infrastructure/neon/neon-setup.md
+@.morph/framework/standards/infrastructure/neon/neon-pgvector.md
+@.morph/framework/standards/infrastructure/neon/neon-pgrag.md
+@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
+
+## SQL Templates
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| PostgreSQL Migration | `.morph/framework/templates/code/sql/postgresql-migration.sql` | Database migration |
+| PostgreSQL RLS Policy | `.morph/framework/templates/code/sql/postgresql-rls-policy.sql` | Row-level security |
+
+Read the template and adapt to your project structure.