@polymorphism-tech/morph-spec 8.33.0 → 8.35.0

package/framework/agents.json

@@ -8,13 +8,30 @@
       "title": ".NET Senior Engineer",
       "icon": "🔷",
       "color": "blue",
-      "domains": ["backend", "backend-api", "architecture"],
+      "domains": [
+        "backend",
+        "backend-api",
+        "architecture"
+      ],
       "keywords": [
-        "backend", "api", "dotnet", ".net", "csharp", "c#",
-        "minimal api", "vertical slice", "vsa", "result pattern",
-        "feature slice", "endpoint", "handler", "validator"
+        "backend",
+        "api",
+        "dotnet",
+        ".net",
+        "csharp",
+        "c#",
+        "minimal api",
+        "vertical slice",
+        "vsa",
+        "result pattern",
+        "feature slice",
+        "endpoint",
+        "handler",
+        "validator"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "architecture-vertical-slice-vertical-slice",
         "backend-dotnet-result-pattern",
@@ -23,7 +40,9 @@
         "backend-dotnet-testing",
         "backend-integrations-neon-auth-neon-auth"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados: ApplicationDbContext injetado direto no slice (DbSet<T> já é repository, DbContext já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em decisions.md; nunca uma camada de Service/Manager; nunca repository genérico (IRepository<T>/IUnitOfWork). Não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros. REUSO ANTES DE CRIAR: antes de declarar record/class/interface novo, rode `morph-spec graph explain <Nome>` e `graph affected <Conceito> --uses-only` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim diga por que em uma linha no relatório da task."
     },
@@ -31,18 +50,33 @@
       "title": "EF Core / Database Modeler",
       "icon": "🗄️",
       "color": "cyan",
-      "domains": ["database", "data-modeling", "migrations"],
+      "domains": [
+        "database",
+        "data-modeling",
+        "migrations"
+      ],
       "keywords": [
-        "ef core", "entity framework", "neon", "postgres", "postgresql",
-        "migration", "dbcontext", "navigation property", "configuration"
+        "ef core",
+        "entity framework",
+        "neon",
+        "postgres",
+        "postgresql",
+        "migration",
+        "dbcontext",
+        "navigation property",
+        "configuration"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "backend-database-postgresql-database",
         "infrastructure-neon-setup",
         "infrastructure-neon-pgvector"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "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. REUSO ANTES DE CRIAR: antes de declarar entidade, configuração ou value object novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`) — entidade duplicada vira migration divergente; se criar mesmo assim, justifique em uma linha no relatório da task."
     },
@@ -50,38 +84,82 @@
       "title": "Microsoft Agent Framework Expert",
       "icon": "🤖",
       "color": "purple",
-      "domains": ["ai-agents", "ai-orchestration"],
+      "domains": [
+        "ai-agents",
+        "ai-orchestration"
+      ],
       "keywords": [
-        "agent", "ai agent", "maf", "microsoft agent framework",
-        "tool", "tool calling", "rag", "vector search", "llm",
-        "orchestration", "multi-agent"
+        "agent",
+        "ai agent",
+        "maf",
+        "microsoft agent framework",
+        "tool",
+        "tool calling",
+        "rag",
+        "vector search",
+        "llm",
+        "orchestration",
+        "multi-agent",
+        "responses api",
+        "structured output",
+        "guardrail",
+        "prompt"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "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-prompt-sources",
         "ai-agents-rag-custom-pgvector",
         "ai-agents-middleware-patterns",
         "ai-agents-observability-patterns",
-        "ai-agents-multi-agent-patterns"
+        "ai-agents-multi-agent-patterns",
+        "ai-agents-evals-with-cache",
+        "ai-agents-agent-archetypes",
+        "ai-agents-agent-spec",
+        "ai-agents-llm-runtime-defaults",
+        "ai-agents-conversational-agent-with-phases",
+        "ai-agents-cost-and-budget",
+        "ai-agents-guardrails",
+        "ai-agents-testing-ai",
+        "ai-agents-context-providers",
+        "ai-agents-agent-session",
+        "ai-agents-durable-workflows-hitl"
+      ],
+      "mcp": [
+        "context7"
       ],
-      "mcp": ["context7"],
       "model": "sonnet",
-      "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. REUSO ANTES DE CRIAR: antes de escrever tool, contrato ou serviço de agente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim justifique em uma linha no relatório da task."
+      "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 UseOpenTelemetry(sourceName, configure) no builder, nos DOIS níveis (agente e chat client), com EnableSensitiveData desligado fora de dev — AgentOpenTelemetryConsts e agent.WithOpenTelemetry() NÃO existem no pin (medido por reflexão); os nomes de ActivitySource, span e métrica estão no standard ai-agents-observability-patterns, não os deduza. Para OpenAI o caminho default é a Responses API (GetResponsesClient() + AsAIAgent); no Model Registry, alias que OMITE `api` significa `responses` — Chat Completions é opt-in declarado, nunca suposição. HISTÓRICO DE CONVERSA: conversa própria como default (tabela/jsonb do projeto exposta por um ChatHistoryProvider seu, com store: false), nunca o AgentSession — o AgentSession com provider embutido só é a fonte certa quando o histórico é SÓ a lista de mensagens, sem campo de negócio e sem leitura fora do agente; retry, remontagem e auditoria exigem histórico visível e manipulável. INSTRUÇÕES E TOOLS POR FASE: compositor determinístico em C# testável (um record Instructions + Tools escolhido por switch antes de montar ChatOptions), nem context provider nem tool — AIContext.Tools ACRESCENTA tools e nunca remove, então só o código consegue tirar uma tool da mesa. DESCOBERTA DE STANDARD: a lista acima é o que se cola em todo dispatch, não o catálogo — antes de concluir que um assunto não tem standard, rode `morph-spec standards --find \"<tema>\" --category ai-agents`. REUSO ANTES DE CRIAR: antes de escrever tool, contrato ou serviço de agente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim justifique em uma linha no relatório da task."
     },
     "nextjs-expert": {
       "title": "Next.js / React Expert",
       "icon": "⚛️",
       "color": "green",
-      "domains": ["frontend", "ui", "react", "nextjs"],
+      "domains": [
+        "frontend",
+        "ui",
+        "react",
+        "nextjs"
+      ],
       "keywords": [
-        "nextjs", "next.js", "react", "app router", "server component",
-        "client component", "tailwind", "framer motion", "shadcn"
+        "nextjs",
+        "next.js",
+        "react",
+        "app router",
+        "server component",
+        "client component",
+        "tailwind",
+        "framer motion",
+        "shadcn"
+      ],
+      "stack": [
+        "nextjs"
       ],
-      "stack": ["nextjs"],
       "standards": [
         "frontend-nextjs-app-router",
         "frontend-nextjs-components",
@@ -90,7 +168,9 @@
         "frontend-nextjs-state-management",
         "backend-integrations-neon-auth-neon-auth"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "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. REUSO ANTES DE CRIAR: antes de declarar tipo, hook ou componente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`) — o tipo local redeclarado em cada arquivo é o defeito mais comum aqui; reuse ou estenda o que existe, e se criar mesmo assim justifique em uma linha no relatório da task."
     },
@@ -98,13 +178,34 @@
       "title": "UI/UX Designer",
       "icon": "🎨",
       "color": "magenta",
-      "domains": ["ui", "ux", "design-system", "accessibility"],
+      "domains": [
+        "ui",
+        "ux",
+        "design-system",
+        "accessibility"
+      ],
       "keywords": [
-        "design", "ui", "ux", "design system", "tokens", "wcag",
-        "accessibility", "mockup", "flow", "shadcn", "tailwind",
-        "motion", "scroll", "scrub", "gsap", "lenis", "seo"
+        "design",
+        "ui",
+        "ux",
+        "design system",
+        "tokens",
+        "wcag",
+        "accessibility",
+        "mockup",
+        "flow",
+        "shadcn",
+        "tailwind",
+        "motion",
+        "scroll",
+        "scrub",
+        "gsap",
+        "lenis",
+        "seo"
+      ],
+      "stack": [
+        "*"
       ],
-      "stack": ["*"],
       "standards": [
         "frontend-design-system-naming",
         "frontend-design-system-animations",
@@ -121,7 +222,13 @@
         "frontend-gsap-plugins"
       ],
       "tools": "Read, Write, Edit, Glob, Grep",
-      "mcp": ["context7", "stitch", "gemini-image", "playwright", "seedance"],
+      "mcp": [
+        "context7",
+        "stitch",
+        "gemini-image",
+        "playwright",
+        "seedance"
+      ],
       "model": "sonnet",
       "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. REUSO ANTES DE CRIAR: componente reutilizável se BUSCA antes de se escrever — rode `morph-spec graph explain <Nome>` e confira `.morph/context/design-system.md` (sem grafo: `grep -rn`); criar um novo exige justificativa em uma linha no relatório da task, a mesma regra que já vale para token de design."
     },
@@ -129,19 +236,37 @@
       "title": "Infrastructure / Jobs Engineer",
       "icon": "⚙️",
       "color": "yellow",
-      "domains": ["infrastructure", "jobs", "deployment", "observability"],
+      "domains": [
+        "infrastructure",
+        "jobs",
+        "deployment",
+        "observability"
+      ],
       "keywords": [
-        "hangfire", "background job", "queue", "deployment",
-        "docker", "ci/cd", "telemetry", "logging", "monitoring"
+        "hangfire",
+        "background job",
+        "queue",
+        "deployment",
+        "docker",
+        "ci/cd",
+        "telemetry",
+        "logging",
+        "monitoring"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "backend-integrations-hangfire-hangfire-jobs",
         "infrastructure-docker-coolify-deploy",
+        "infrastructure-docker-local-compose-isolation",
         "backend-dotnet-scrutor",
-        "ai-agents-observability-patterns"
+        "ai-agents-observability-patterns",
+        "ai-agents-cost-and-budget"
+      ],
+      "mcp": [
+        "context7"
       ],
-      "mcp": ["context7"],
       "model": "sonnet",
       "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. Operações no GitHub (issues, PRs, releases, Actions) sempre via `gh` CLI no Bash — o morph-spec não usa MCP do GitHub. Coolify sempre via SSH + curl na API local — não há MCP nem CLI."
     },
@@ -149,14 +274,27 @@
       "title": "Code & Architecture Evaluator",
       "icon": "🔍",
       "color": "red",
-      "domains": ["evaluation", "review", "quality"],
+      "domains": [
+        "evaluation",
+        "review",
+        "quality"
+      ],
       "keywords": [
-        "review", "eval", "score", "rubric", "audit", "quality"
+        "review",
+        "eval",
+        "score",
+        "rubric",
+        "audit",
+        "quality"
+      ],
+      "stack": [
+        "*"
       ],
-      "stack": ["*"],
       "standards": [],
       "tools": "Read, Glob, Grep, Bash",
-      "mcp": ["playwright"],
+      "mcp": [
+        "playwright"
+      ],
       "model": "opus",
       "persona": "Você aplica as rubricas em .morph/framework/evals/rubrics/. Você não participou da implementação — avalia o mandate, o diff e a saída real dos testes, com contexto fresco. O orquestrador anexa o resultado do `morph-spec verify`, mas você tem Bash para conferir por conta própria: rode `morph-spec verify {feature} [task]`, testes/build do stack, `git log/diff/show` — nunca confie cegamente no que foi reportado. Bash é só para verificação: NUNCA para modificar código-fonte, tasks.json, feature.json ou o board de sessão — quem faz isso é o loop de correção, não você. Você também tem Playwright: quando o nó `e2e` do verify subiu o stack, NAVEGUE a aplicação como um usuário faria e percorra os fluxos da feature — ler o diff prova que o código existe, usar a aplicação prova que ela funciona. Confira console e network atrás de erro que nenhum teste cobre. Quem sobe e derruba o stack é o `morph-spec verify`/`morph-spec e2e`, não você: se ele não subiu, isso é um achado de infra a reportar, não um defeito de implementação a pontuar. Se um fluxo que você exercitou merece virar regressão, recomende a spec Playwright no relatório — recomendar é seu papel, escrever não. Quando o que você avalia é uma CORREÇÃO (rodada do loop, fix de achado seu ou de outrem), pergunte sempre O QUE ESSA CORREÇÃO ABRIU: que comportamento antes correto pode ter regredido, e se há teste que pegaria isso. Um fix que fecha um defeito e abre outro pontua alto em toda dimensão e mesmo assim piorou o produto — e re-execute os seus próprios probes da rodada anterior em vez de aceitar 'agora tem teste' como fechamento. Não reescreve código — produz scores 0-10 por dimensão (architecture, contracts, code-quality, test-coverage), feedback priorizado acionável, e ação clara (aprovado em >=9 / feedback para o loop de correção em <9). Silêncio em scores ≥ 9 é o sinal correto."
     },
@@ -164,9 +302,25 @@
       "title": "Codebase Scout",
       "icon": "🔦",
       "color": "gray",
-      "domains": ["scouting", "diagnosis", "code-search"],
-      "keywords": ["scout", "diagnose", "root cause", "blast radius", "search", "map", "investigate", "locate", "trace"],
-      "stack": ["*"],
+      "domains": [
+        "scouting",
+        "diagnosis",
+        "code-search"
+      ],
+      "keywords": [
+        "scout",
+        "diagnose",
+        "root cause",
+        "blast radius",
+        "search",
+        "map",
+        "investigate",
+        "locate",
+        "trace"
+      ],
+      "stack": [
+        "*"
+      ],
       "standards": [],
       "tools": "Read, Glob, Grep, Bash",
       "model": "haiku",

package/framework/ai-pin.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "./schemas/ai-pin.schema.json",
+  "pinnedAt": "2026-09-08",
+  "source": "https://api.nuget.org/v3/registration5-semver1/{id}/index.json",
+  "targetFramework": "net10.0",
+  "sdk": "10.0.100",
+  "packages": {
+    "Microsoft.Agents.AI": { "version": "1.20.0", "published": "2026-08-31", "role": "maf-core" },
+    "Microsoft.Extensions.AI": { "version": "10.9.0", "published": "2026-08-11", "role": "chat-abstractions" },
+    "OpenAI": { "version": "2.13.0", "published": "2026-08-10", "role": "provider" },
+    "Google.GenAI": { "version": "1.21.0", "published": "2026-08-31", "role": "provider" },
+    "ModelContextProtocol": { "version": "2.2.0", "published": "2026-08-13", "role": "mcp" },
+    "Microsoft.Extensions.AI.Evaluation": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" },
+    "Microsoft.Extensions.AI.Evaluation.Quality": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" },
+    "Microsoft.Extensions.AI.Evaluation.Reporting": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" }
+  },
+  "toolchain": {
+    "Microsoft.NET.Test.Sdk": { "version": "18.9.0" },
+    "xunit.v3": { "version": "4.0.0" },
+    "xunit.runner.visualstudio": { "version": "4.0.0" }
+  }
+}

package/framework/commands/morph-media.md

@@ -0,0 +1,45 @@
+---
+description: Conduz a autoria de mídia gerada por IA — escolher o modelo pelo trabalho, montar o prompt como spec versionada, encadear a partir de um herói aprovado, subir a escada de custo e conduzir o gate humano de escolha entre N candidatas.
+argument-hint: [o que gerar]
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Skill
+---
+
+# /morph-media — Autoria de mídia gerada
+
+Conduz a produção de uma imagem ou vídeo por IA, do "precisamos de uma foto do sofá em verde" até um
+arquivo aprovado, com o menor gasto possível e sem claim visual falso.
+
+**Implementação:** este slash command é um atalho. O agente deve invocar `Skill(morph-media)` com o
+pedido (se fornecido). A skill escolhe o modelo pelo trabalho, monta o prompt pela estrutura fixa,
+sobe a escada de custo (N candidatas em qualidade baixa → gate humano → a vencedora em alta) e fecha
+com nome, marcação e proveniência.
+
+## Argumentos
+
+`[o que gerar]` — descrição do pedido (opcional; sem ela, a skill pergunta).
+
+## Quando NÃO usar
+
+Quando o pedido é **implementar** o subsistema de mídia num projeto .NET. Isso é uma feature normal,
+e o insumo são os três standards de `ai-agents/` abaixo — não esta skill.
+
+## Anti-padrões
+
+- Gerar tudo em alta qualidade "para já sair pronto" — multiplica a conta e ainda exige escolha.
+- Gerar as derivadas antes de aprovar o herói — elas herdam o erro que ninguém viu ainda.
+- Aprovar vídeo por um frame parado: um still não prova movimento.
+- Pinar um alias sem abrir a tabela de deprecações do standard da modalidade.
+- Recriar por IA o render ou a foto real do cliente — inventa o que já existe e vira claim falso.
+- **Gerar mídia dentro de um turno de conversa.** O turno enfileira e confirma; a mídia volta depois,
+  revisada.
+
+## Referências
+
+- `.claude/skills/morph-media/SKILL.md`
+- `.morph/framework/standards/ai-agents/modalities-image-gen.md`
+- `.morph/framework/standards/ai-agents/media-video.md`
+- `.morph/framework/standards/ai-agents/media-pipeline.md`
+- `.morph/framework/standards/frontend/design-system/ai-image-generation.md`
+- `.morph/framework/standards/frontend/design-system/ai-video-generation.md`
+
+**Pedido:** $ARGUMENTS