@polymorphism-tech/morph-spec 9.8.0 → 10.1.1

package/framework/skills/core/morph-uiux/SKILL.md

@@ -1,103 +1,86 @@
 ---
 name: morph-uiux
-description: Conduz a fase opcional de UI/UX de uma feature com plano aprovado — design system, mockups com checklist de tela, componentes e fluxos — despachando a persona ui-designer, e apresenta o Gate uiux antes da implementação.
+description: Conduz a fase de UI/UX de uma feature com plano aprovado — renderiza 2-3 opções navegáveis por tela, abre no navegador para o usuário escolher, refina a escolhida em protótipo com prints 1280/390, preenche o checklist de tela e apresenta o Gate uiux.
 version: core
-when_to_use: Use quando o ramo de design for tomado (morph-spec advance {feature} --design, depois do gate do plano) e antes de /morph-apply
+when_to_use: Use quando o ramo de design for tomado (morph-spec advance {feature} --design), antes de /morph-apply
 user-invocable: true
-cliVersion: "9.8.0"
+cliVersion: "10.1.1"
 ---
 
 # morph-uiux
 
-Entra depois do gate do plano, quando a `morph-plan` §6 decidiu que a feature cria ou altera superfície de UI (componente, página, tela, estilo, fluxo de navegação). Sai com `1-design/` aprovado; o próximo passo é `/morph-apply {feature}`.
+Entra depois do gate do plano, quando a feature cria ou altera UI. Sai com `1-design/` aprovado; próximo passo `/morph-apply {feature}`. Você desenha nesta sessão — o que decidir aqui é o que vai implementar depois.
+
+A régua de sistema e de estética chega sozinha: a rule `ui-design` carrega quando você abre um arquivo de `1-design/` ou de UI. Carregue `frontend-design:frontend-design` se a sessão a tiver.
 
 ## 1. Insumos
 
-- `2-plan/plan.md` — problema, cenários e as fatias de UI (`persona: ui-designer`, com `superfície:`). O plano está congelado: esta fase **nunca** edita `plan.md` nem `checks.json`; refere as fatias pelo id (`F2`).
-- `.morph/context/design-system.md` — o design system **vivo**: toda decisão de token ou componente parte dele. Ausente, o `advance --design` já o escreveu a partir do template do pacote como forma de partida.
-- `.morph/config/config.json` → `project.stack` decide a tecnologia (`nextjs` → Tailwind + shadcn + Framer Motion; outro stack, o equivalente idiomático). Nunca suponha Next.js.
-- `2-plan/stack-scan.md`, se existir.
+- `2-plan/plan.md` — problema e cenários de tela, referidos pelo id (`C3`). Esta fase **nunca** edita `plan.md` nem `checks.json`.
+- `.morph/context/design-system.md` — o design system vivo; toda decisão de token ou componente parte dele e dos tokens reais do CSS do projeto.
+- `config.json` → `project.stack` decide a tecnologia (`nextjs` → Tailwind + shadcn + Motion). Nunca suponha Next.js.
+- A superfície de cada tela (`marketing-site` | `admin-app` | `brand-moment`, em `surfaces.json`) diz quais standards abrir.
 
-## 2. Princípios (não são opcionais)
+## 2. Opções — o usuário escolhe vendo, não lendo
 
-- WCAG AA e todos os estados de componente interativo (default/hover/focus/disabled/loading/error), não só o caminho feliz.
-- Reusa token e componente existentes antes de criar; token novo precisa de justificativa. Sistemas, não telas isoladas.
-- Tarefa principal da tela em até 3 interações, uma ação primária por tela, voltar/cancelar sempre à vista. Erro diz o que fazer a seguir; conteúdo gerado por IA aparece marcado como tal.
-- **Toda tela sai com o checklist de tela preenchido.** O `advance --design` já escreveu `1-design/mockups.md` a partir do template do pacote, a fonte única dos dez itens (tabela `### Checklist de tela` dentro de cada `## Tela:`). "Não se aplica" vale se escrito; `…`, vazio ou "a definir" reprovam. Design sem tela nova ou alterada (só componente ou estilo): apague o `1-design/mockups.md` semeado. É o checklist que faz a lista de 2 000 linhas paginar: o verificador do Gate 3 cobra cada item decidido em `## Checklist de tela`. Tela de dados segue os standards de `admin-app` (lista/tabela, formulário, feedback, estrutura de página); login, onboarding, primeira tela, estado vazio de destaque e sucesso são `brand-moment`.
-- **Conformidade não basta: a régua estética vale junto.** Direção escrita antes de componente (`1-design/direcao.md`: conceito, metáfora, o que torna a tela memorável, o que ela não pode parecer; 2 ou 3 direções para tela nova ou momento de marca), celular desenhado e não derivado, movimento com versão estática digna. A régua é o standard `frontend-design-system-art-direction`.
-- **Toda tela nova ou alterada tem protótipo renderizado e conferido por print.** `1-design/prototipos/{tela}.html` autossuficiente, com os tokens reais do projeto (lidos do CSS de tokens), desktop e celular lado a lado, controles animado/estático/pausar; prints `{tela}-1280.png` e `{tela}-390.png` ao lado, saídos do laço de autocrítica. A `## Tela:` aponta o protótipo na linha `**Protótipo:**`.
+Para cada tela nova ou alterada, `1-design/opcoes/{tela}.html`: **uma página com 2 ou 3 direções distintas**, alternáveis por abas, cada uma com:
 
-## 3. Dispatch
+- o conceito em uma frase e o que a torna memorável, no topo da aba;
+- desktop (1280) e celular (390) lado a lado em moldura de aparelho, com conteúdo realista (nunca lorem ipsum nem métrica inventada);
+- controles animado/estático; `prefers-reduced-motion` respeitado;
+- os tokens reais do projeto; uma direção pode propor tokens novos, marcados como tal.
 
-Despache `subagent_type: "morph-ui-designer"` — persona universal, registrada em todo projeto. Não registrado (instalação antiga): `general-purpose` com o campo `persona` de `.morph/framework/agents.json` colado no prompt, registrando o fallback; resolve com `morph-spec setup-infra --reinstall`. O corpo da persona já carrega o contrato fixo (teto de turnos, relatório `PARCIAL`); o prompt leva só o que varia:
+Direções genuinamente diferentes (layout, hierarquia, densidade, tom), não três variações de cor. Sirva a pasta por HTTP (`npx http-server 1-design -p <porta>` em background), **abra no navegador do usuário** (`start` no Windows, `open` no macOS, `xdg-open` no Linux) e pergunte:
 
 ```
-Feature [feature]: artefatos de UI/UX em `.morph/features/[feature]/1-design/`.
-Plano: `2-plan/plan.md` — fatias de UI [F2 (admin-app), F3 …]. Stack: [project.stack].
-Design system: `.morph/context/design-system.md` (tokens e componentes a reusar).
-
-Nesta ordem, só o aplicável ao escopo:
-1. `1-design/direcao.md` — antes de qualquer componente: conceito em uma frase, metáfora visual,
-   o que torna a tela memorável, o que ela NÃO pode parecer. Tela nova ou momento de marca:
-   2 ou 3 direções distintas, uma recomendada com o porquê (standard `frontend-design-system-art-direction`).
-2. `1-design/design-system.md` (obrigatório: sem ele o `advance` recusa) — tokens (cor, tipografia, espaço, motion) que a feature usa ou acrescenta, lidos do CSS de tokens real do projeto; token novo também reescreve `.morph/context/design-system.md` (§4).
-3. `1-design/prototipos/{tela}.html` por tela nova ou alterada — autossuficiente, tokens reais,
-   desktop e celular (folha inferior, zona do polegar, 44px) lado a lado em moldura de aparelho,
-   controles animado/estático/pausar e `prefers-reduced-motion`. Laço de autocrítica: sirva a pasta
-   por HTTP local (o Playwright MCP recusa `file:`), print em 1280 e em 390 (`{tela}-1280.png`,
-   `{tela}-390.png` ao lado do HTML), avalie (hierarquia, contraste, ritmo, celular, "parece template?"),
-   corrija e repita até passar.
-4. `mockups.md` — um `## Tela: <nome>` por tela nova ou alterada, com a fatia que a entrega, a linha
-   `**Protótipo:** 1-design/prototipos/{tela}.html` e a tabela `### Checklist de tela` que o
-   `advance --design` já escreveu em `1-design/mockups.md`, cada item decidido.
-5. `components.md` — componentes novos e reusados, com props e estados.
-6. `flows.md` — navegação entre as telas.
-
-Relatório por artefato em `1-design/reports/[artefato]-report.md`: o que foi feito (2-3 frases),
-o artefato, as decisões de design e por quê, o que ficou aberto; o do protótipo lista as rodadas
-do laço e o que cada uma corrigiu. É o retorno; a mensagem final é cortesia.
-Bash só para consulta (`morph-spec standards --find`, `npx`, screenshot, `git log/diff`) e para o
-servidor estático do protótipo (`npx http-server <pasta> -p <porta>` em background; ao fim, encerre
-esse processo pelo id do background ou pelo PID dono da porta, nunca por nome de executável):
-sem build, teste, `verify`, `approve` ou `advance`.
-Não toque `feature.json`, `state.json`, `plan.md` nem `checks.json`.
+AskUserQuestion — header "Direção", question: "Qual direção para {tela}?"
+options: uma por direção (nome curto + o conceito) — a sua recomendação primeiro, com "(Recomendado)"
 ```
 
-Ao retomar, **leia primeiro** `1-design/reports/*-report.md`. `design-system.md` é o único output obrigatório: sem ele, o `advance` recusa.
+"Outra" com comentário → ajuste a página e pergunte de novo. Componente ou estilo sem tela nova: pule para o §3 com uma opção só.
 
-## 4. Design system vivo
+## 3. Protótipo da escolhida
 
-Tokens ou componentes novos: aplique o protocolo da `morph-plan` §2 — **reescreva o corpo** de `.morph/context/design-system.md` (o valor que mudou substitui o antigo na própria seção) e registre no changelog só data e motivo. `1-design/design-system.md` é da feature; `.morph/context/design-system.md` é do projeto.
+`1-design/prototipos/{tela}.html` refina a direção escolhida até o nível de entrega: todos os estados (vazio, carregando, erro, sucesso), foco visível, alvos de 44px no celular. **Seletor de estado** no topo do protótipo: um botão por estado com `data-estado="vazio|carregando|erro"`, e o mesmo estado abre por `?estado=<nome>` na URL — o usuário vê cada estado num clique, sem ler. **Laço de autocrítica:** print em 1280 e em 390 pelo Playwright MCP (ele recusa `file:` — use a URL HTTP), salvos como `{tela}-1280.png` e `{tela}-390.png` ao lado do HTML, mais `{tela}-{estado}-390.png` de cada estado que o checklist diz que se aplica (vazio e carregando pelo item "Estados", erro pelo item "Erro"; "não se aplica" dispensa) — o gate uiux confere o `data-estado` e os prints; avalie (hierarquia, contraste AA, ritmo, celular, "parece template?"), corrija, repita até passar. Ao terminar, encerre o servidor pelo id do background ou pelo PID da porta, nunca por nome de executável.
 
-## 5. Todo aviso de capacidade tem destino
+## 4. mockups.md
 
-Antes do gate:
+O `advance --design` já escreveu `1-design/mockups.md` a partir do template — a tabela do checklist mora lá, não copie. Por tela, um `## Tela: <nome>` com:
 
-```bash
-grep -riE "capacidade nova|precisa de backend|dimensionar junto" .morph/features/{feature}/1-design/
-```
+- `**Protótipo:** 1-design/prototipos/{tela}.html` e `**Direção escolhida:**` (qual opção e por quê, numa frase);
+- o `### Checklist de tela` com cada item decidido (`não se aplica` vale se escrito; vazio ou "a definir" reprova);
+- `### Componentes` (novos e reusados, com props e estados) e `### Fluxo` (de onde vem, para onde vai).
+
+Sem tela nova ou alterada: apague o `mockups.md` semeado.
+
+## 5. Design system vivo
+
+Token ou componente novo aprovado: **reescreva o corpo** de `.morph/context/design-system.md` (o valor novo substitui o antigo na própria seção); o changelog guarda só data e motivo.
 
-Cada ocorrência **nunca fica sem destino**: a fatia do plano que já a cobre (cite o id no mockup), uma exclusão registrada no `mockups.md` com o motivo, ou — se é escopo novo — `morph-spec unapprove {feature} plan`, ajuste do plan.md, `morph-spec plan-check {feature}` e o gate do plano de novo. Sem hits, o passo é um no-op.
+## 6. Destino de toda capacidade nova
 
-## 6. Gate uiux
+Uma tela que pede algo que o plano não tem (endpoint, campo, permissão) **nunca fica sem destino**. Antes do gate, varra o que você escreveu:
 
 ```
-morph-spec gate-check {feature} uiux [--json]
+grep -riE "capacidade nova|precisa de backend|dimensionar junto" .morph/features/{feature}/1-design/
 ```
 
-O checklist é cobrado por código: tela sem a tabela, item ausente ou não decidido, ou nenhuma `## Tela:` **pausa** o gate nomeando tela e item, e `approve`/`advance` com assinatura `auto` recusam pela mesma regra (só o mockup antigo, telas `## S001:`, é isento). Com o checklist completo, cada tela ainda deve o protótipo: sem a linha `**Protótipo:**`, o HTML ou um dos prints de 1280/390, o gate **pausa** nomeando a tela e o arquivo. Complete o mockup antes de apresentar: não peça aprovação de um design que ainda não decidiu se a lista pagina, nem de um que ninguém renderizou.
+Cada ocorrência vai para o `Cn` do plano que já a cobre, para uma exclusão registrada no `mockups.md`, ou — escopo novo — `morph-spec unapprove {feature} plan`, ajuste, `plan-check` e o gate de novo.
+
+## 7. Gate uiux
+
+`morph-spec gate-check {feature} uiux [--json]` cobra por código: tela sem checklist completo, sem `**Protótipo:**`, sem o HTML ou sem os dois prints pausa nomeando o que falta. Complete antes de pedir aprovação.
 
-**Apresente o design aberto, não descrito.** Antes da pergunta do gate, abra cada protótipo no navegador do usuário (sirva `1-design/prototipos/` por HTTP local e abra a URL: `start` no Windows, `open` no macOS, `xdg-open` no Linux) e cite a direção escolhida de `direcao.md` em uma frase. Divergência de design system vista aqui: `--signals '{"designSystemDivergence":true}'`.
+Apresente aberto, não descrito: abra cada protótipo no navegador e cite a direção de cada tela em uma frase. Divergência de design system vista aqui: `--signals '{"designSystemDivergence":true}'`.
 
-**`pause === true`**: `AskUserQuestion`, header "Gate uiux":
+Pausa com `resolver: "session"` não é pergunta: faça o que a `reason` diz e rode o `gate-check` de novo. Checklist ou protótipo incompleto → complete-o. Sem como completar (sem navegador para os prints): `morph-spec gate-decision {feature} uiux --pause true --reason "<o que falta>"`, pausa manual, que é do usuário.
+
+`resolver === "human"` → `AskUserQuestion`, header "Gate uiux":
 
 ```
 question: "Gate uiux — Design de {feature} aprovado?{ reason ? ' Sinal: ' + reason : '' }"
 options: "aprovado, prosseguir" | "preciso ajustar" | "cancelar feature"
 ```
 
-O hook `state-sync` reconhece "Gate uiux" e grava a aprovação pela feature nomeada. Sem `AskUserQuestion` (headless): `morph-spec advance {feature} --approver <quem>` — sem `--approver`, um terminal não interativo grava `approvedBy: "auto"` num gate que um humano aprovou.
-
-**`pause === false`**: resumo (tokens novos, N telas, componentes novos/reusados, fluxos) e `morph-spec advance {feature}`.
+O hook `state-sync` grava a aprovação pela feature nomeada. Headless: `morph-spec advance {feature} --approver <quem>` — sem `--approver`, um terminal não interativo grava `approvedBy: "auto"` num gate que um humano devia assinar. `pause === false` → uma linha e `morph-spec advance {feature}`.
 
-Aprovado o gate, os quatro artefatos de `1-design/` travam: retrabalho de design passa pelo gate de novo, nunca por Edit no arquivo travado. Diga ao usuário que `/morph-apply {feature}` está pronto; não despache a apply.
+Aprovado, `1-design/` trava: retrabalho passa pelo gate de novo. Diga que `/morph-apply {feature}` está pronto.

package/framework/skills/core/morph-uiux/surfaces.json

@@ -0,0 +1,32 @@
+{
+  "marketing-site": {
+    "when": "site de marketing: landing page, institucional, campanha — narrativa, conversão, movimento e SEO",
+    "standards": [
+      "frontend-design-system-ai-image-generation",
+      "frontend-design-system-ai-video-generation",
+      "frontend-scroll-driven-frame-scrub",
+      "frontend-scroll-driven-smooth-scroll",
+      "frontend-scroll-driven-scroll-components",
+      "frontend-seo-meta-schema-audit",
+      "frontend-gsap-core",
+      "frontend-gsap-scrolltrigger",
+      "frontend-gsap-plugins"
+    ]
+  },
+  "admin-app": {
+    "when": "app de dados: painel administrativo, CRUD, back office, dashboard — lista, tabela, formulário e densidade",
+    "standards": [
+      "frontend-admin-app-data-table",
+      "frontend-admin-app-forms",
+      "frontend-admin-app-feedback",
+      "frontend-admin-app-page-structure"
+    ]
+  },
+  "brand-moment": {
+    "when": "momento de marca dentro do produto: login e auth, onboarding, primeira tela, estado vazio de destaque, sucesso, vitrine — direção, cena e movimento",
+    "standards": [
+      "frontend-gsap-core",
+      "frontend-gsap-scrolltrigger"
+    ]
+  }
+}

package/framework/standards/STANDARDS.json

@@ -841,7 +841,7 @@
         "schema": "#schema-design",
         "indexes": "#indexes"
       },
-      "digest": "Neon PostgreSQL schema rules: snake_case plural tables and snake_case columns, PK 'id uuid primary key' with NO column default -- the app sets it with Guid.CreateVersion7() (rows inserted outside the app pass an explicit id; never gen_random_uuid() defaults for app ids), FK '{table}_id', booleans prefixed is_/has_, indexes 'idx_{table}_{column}'. Always include created_at/updated_at as timestamptz default now() not null, kept fresh by a handle_updated_at trigger. Always enable RLS on user-facing tables, with policies like 'auth.user_id() = user_id' (update takes both using and with check). Migrations via EF Core: dotnet ef migrations add, database update, and migrations script --idempotent to review the SQL; hand-written SQL migrations enable RLS, create indexes and always include a rollback. Index FKs and WHERE/ORDER BY/GROUP BY columns; GIN for full-text search. Select only needed columns, limit results, batch inserts, set a statement timeout, keep RLS policies simple. The Next.js frontend reads through the .NET API (proxy + TanStack Query); @neondatabase/serverless is only for Node-side tooling."
+      "digest": "Neon PostgreSQL schema rules: snake_case plural tables and snake_case columns, PK 'id uuid primary key' with NO column default -- the app sets it with Guid.CreateVersion7() (rows inserted outside the app pass an explicit id; never gen_random_uuid() defaults for app ids), FK '{table}_id', booleans prefixed is_/has_, indexes 'idx_{table}_{column}'. Always include created_at/updated_at as timestamptz default now() not null, kept fresh by a handle_updated_at trigger. Always enable RLS on user-facing tables, with policies like 'auth.user_id() = user_id' (update takes both using and with check). Migrations via EF Core: dotnet ef migrations add, database update, and migrations script --idempotent to review the SQL; hand-written SQL migrations enable RLS, create indexes and always include a rollback. Index FKs and WHERE/ORDER BY/GROUP BY columns; GIN for full-text search. Model first: jsonb only for what truly varies per row; what you filter, join, sort or aggregate is a column; the app validates the shape on write. Select only needed columns, limit results, batch inserts, set a statement timeout, keep RLS policies simple. The Next.js frontend reads through the .NET API (proxy + TanStack Query); @neondatabase/serverless is only for Node-side tooling."
     },
     {
       "id": "backend-database-vector-search-rag",
@@ -1055,7 +1055,7 @@
         "rls": "#row-level-security-integration",
         "postmortem": "#known-failure-modes-postmortem"
       },
-      "digest": "Use @neondatabase/auth SDK for Next.js. Auth data lives in neon_auth schema — no external provider, no webhooks. Server: createNeonAuth() with NEON_AUTH_BASE_URL + NEON_AUTH_COOKIE_SECRET. Client: createAuthClient(). Pages: AuthView component. Protection: auth.middleware() with runtime='nodejs' (Edge times out minting the session cookie). Register every dev/preview origin in trusted_origins before testing login. Two named prefix constants (BACKEND_API_PREFIX / PROXY_API_PREFIX) — never share one between server-direct and client-proxy calls. Frontend never queries Neon directly for business data by default — only its own auth/session SDK; a Data API bypass requires a plan.md (## Decisões) ADR. .NET: tokens are EdDSA/Ed25519 (OKP) — Microsoft.IdentityModel.Tokens can't verify OKP keys and there's no OIDC discovery; fetch+cache the JWKS yourself and verify signatures manually via BouncyCastle.Cryptography + TokenValidationParameters.SignatureValidator (must return Microsoft.IdentityModel.JsonWebTokens.JsonWebToken, not JwtSecurityToken — else IDX10506). NeonAuth:BaseUrl is mandatory in appsettings.Development.json (public value). RLS: auth.user_id() via pg_session_jwt."
+      "digest": "Use @neon/auth SDK (0.8.1+, renamed from @neondatabase/auth) for Next.js. Auth data lives in neon_auth schema — no external provider, no webhooks. Server: createNeonAuth() with NEON_AUTH_BASE_URL + NEON_AUTH_COOKIE_SECRET. Client: createAuthClient(). Pages: AuthView component. Protection: auth.middleware() with runtime='nodejs' (Edge times out minting the session cookie). Register every dev/preview origin in trusted_origins before testing login. Two named prefix constants (BACKEND_API_PREFIX / PROXY_API_PREFIX) — never share one between server-direct and client-proxy calls. Frontend never queries Neon directly for business data by default — only its own auth/session SDK; a Data API bypass requires a plan.md (## Decisões) ADR. .NET: tokens are EdDSA/Ed25519 (OKP) — Microsoft.IdentityModel.Tokens can't verify OKP keys and there's no OIDC discovery; fetch+cache the JWKS yourself and verify signatures manually via BouncyCastle.Cryptography + TokenValidationParameters.SignatureValidator (must return Microsoft.IdentityModel.JsonWebTokens.JsonWebToken, not JwtSecurityToken — else IDX10506). NeonAuth:BaseUrl is mandatory in appsettings.Development.json (public value). RLS: auth.user_id() via pg_session_jwt."
     },
     {
       "id": "backend-integrations-resend-resend-email",
@@ -1164,9 +1164,12 @@
         "brand-fidelity": "#brand-fidelity-reference-dont-invent",
         "to-video": "#downstream-images-that-become-video",
         "favicon-og": "#the-two-assets-everyone-forgets",
-        "variations": "#variations-and-cost"
+        "variations": "#variations-and-cost",
+        "templates": "#category-templates",
+        "principles": "#prompting-principles",
+        "multi-image": "#multi-image-composition"
       },
-      "digest": "Guidelines for generating project images with the morph-assets MCP (OpenRouter; default openai/gpt-image-2.5-flare, drafts on mai-image-2.6-flash, gemini-3.1-flash-image for 2K/4K or 6-14 refs; models: [...] compares): when to use AI versus stock versus SVG, prompt patterns, aspect ratios, iterative editing and assets.md format. Core principle is brand fidelity over invention: always pass the client's real assets as references (or @brand with a project) via edit_image rather than generating in a vacuum, never AI-recreate a property developer's architectural render or a physical product (animate or reference the real one), and chain derivatives from an approved hero so the whole set shares light, palette and identity. Frame anything destined to become video WITHOUT a face, because video moderation is stricter (E005), and generate scrub frames at the video's exact ratio with the subject opposite the copy. Always produce the two forgotten assets: a favicon derived from the real logo (never a new one) and a 1200x630 OG share image. Offer two to three genuinely different variations per image (variants returns a contact sheet), varying angle, light or composition since seed is not supported by the GPT Image/Gemini models, and never advance with a weak image because every derivative inherits it. Copy to render goes between double quotes; CONFIRMATION_REQUIRED needs human approval and a confirmToken."
+      "digest": "Guidelines for generating project images with the morph-assets MCP (OpenRouter; default openai/gpt-image-2.5-flare, drafts on mai-image-2.6-flash, gemini-3.1-flash-image for 2K/4K or 6-14 refs; models: [...] compares): when to use AI versus stock versus SVG, prompt patterns, aspect ratios, iterative editing and assets.md format. Core principle is brand fidelity over invention: always pass the client's real assets as references (or @brand with a project) via edit_image rather than generating in a vacuum, never AI-recreate a property developer's architectural render or a physical product (animate or reference the real one), and chain derivatives from an approved hero so the whole set shares light, palette and identity. Frame anything destined to become video WITHOUT a face, because video moderation is stricter (E005), and generate scrub frames at the video's exact ratio with the subject opposite the copy. Always produce the two forgotten assets: a favicon derived from the real logo (never a new one) and a 1200x630 OG share image. Offer two to three genuinely different variations per image (variants returns a contact sheet), varying angle, light or composition since seed is not supported by the GPT Image/Gemini models, and never advance with a weak image because every derivative inherits it. Copy to render goes between double quotes; CONFIRMATION_REQUIRED needs human approval and a confirmToken. Prompts are a layered photo-direction paragraph (subject, action, environment in foreground/mid/background, multi-source lighting, style, mood reference, palette, composition with depth cues, texture), with a skeleton per category (photorealistic, illustration, text rendering, product mockup, minimalist); edits stay one or two sentences and keep the input ratio."
     },
     {
       "id": "frontend-design-system-ai-video-generation",
@@ -1190,9 +1193,11 @@
         "directional": "#section-2-building-directional-footage",
         "moderation": "#section-3-faces-trip-moderation",
         "cost-ladder": "#section-4-the-cost-ladder",
-        "prompt-skeleton": "#section-5-prompt-skeleton"
+        "prompt-skeleton": "#section-5-prompt-skeleton",
+        "async": "#section-6-async-contract",
+        "loop-prompt": "#section-7-seamless-loop-prompt-ambient-plane"
       },
-      "digest": "The decisive rule: a perfect loop has an end frame identical to its start, which is right for a self-playing ambient background and WRONG for scroll scrubbing, because start and end look the same and the page reads as frozen while the user scrolls. Scroll-driven footage needs directional movement via generate_video with an endImage (push-in/dolly is the most reliable, then reveal, pull-back, slow tilt); avoid orbits and any movement that returns to its origin. Client architectural renders are animated with img2vid, never AI-recreated. Human faces repeatedly trip moderation (E005), so crop the face out of frame (neck down, hands, product) and reserve faces for static image generation. Always climb the cost ladder: seedance-1-5-pro 480p draft to judge framing and movement, then promoteFrom to seedance-2.0 1080p only after approval (same prompt, frames and seed), then re-extract frames with a bumped cache-bust. seedance-2.0-mini does NOT respect endImage and Veo 3.1 Lite/Fast are inconclusive, so scrub only on Seedance 1.5 Pro/2.0 and check the last-frame SSIM QA. Video has no ZDR on OpenRouter: nothing sensitive in the frames. Prompts read like director notes with no hype words, and must reserve a calm dark region for the page copy with the subject on the opposite side. Generation is async via the morph-assets MCP (OpenRouter): a running job is polled with get_video (several ids at once), never by resending generate_video; library reads local history and spends no credits; media_tool extracts scrub frames and posters."
+      "digest": "The decisive rule: a perfect loop has an end frame identical to its start, which is right for a self-playing ambient background and WRONG for scroll scrubbing, because start and end look the same and the page reads as frozen while the user scrolls. Scroll-driven footage needs directional movement via generate_video with an endImage (push-in/dolly is the most reliable, then reveal, pull-back, slow tilt); avoid orbits and any movement that returns to its origin. Client architectural renders are animated with img2vid, never AI-recreated. Human faces repeatedly trip moderation (E005), so crop the face out of frame (neck down, hands, product) and reserve faces for static image generation. Always climb the cost ladder: seedance-1-5-pro 480p draft to judge framing and movement, then promoteFrom to seedance-2.0 1080p only after approval (same prompt, frames and seed), then re-extract frames with a bumped cache-bust. seedance-2.0-mini does NOT respect endImage and Veo 3.1 Lite/Fast are inconclusive, so scrub only on Seedance 1.5 Pro/2.0 and check the last-frame SSIM QA. Video has no ZDR on OpenRouter: nothing sensitive in the frames. Prompts read like director notes with no hype words, and must reserve a calm dark region for the page copy with the subject on the opposite side. Generation is async via the morph-assets MCP (OpenRouter): a running job is polled with get_video (several ids at once), never by resending generate_video; library reads local history and spends no credits; media_tool extracts scrub frames and posters. waitSeconds defaults to 60 with a 110 ceiling while a Seedance job takes about 100-130s, so pass 110 and still expect to poll. An ambient loop prompt has seven mandatory sections (scene, camera returning to its start, action arc with a mid peak, text choreography or 'background plate only', static lighting, loop seal, technical), with the loop direction inferred from the subject type."
     },
     {
       "id": "frontend-design-system-animations",
@@ -1634,26 +1639,6 @@
       },
       "digest": "Every worktree runs its OWN compose stack (project morph-{feature}, own postgres, own volumes). Ports come from the worktree block: PORT +0, API_PORT +1 (ASPNETCORE_URLS on .NET), POSTGRES_PORT +2, REDIS_PORT +3 — publish via ${VAR:-default}:container, never a fixed host port, never container_name (not prefixed by the project → collides). Stable POSTGRES_DB, healthcheck on every service, DATABASE_URL with an in-network default, playwright.config reads PLAYWRIGHT_BASE_URL. A non-isolable compose fails the verify e2e node inside a worktree. finish/delete tear down with --rmi local -v (--keep-volumes drops -v on finish); worktree remove of a morph-task/* branch with -v, of morph/{f} without. An app whose build is expensive in the Docker VM runs as a host process via e2e.hostServices (compose keeps only the dependencies; ports from the block). Cloud DB credentials go in e2e.auth.envFile, never in .morph/worktree.env. A compose that reads a port by ANOTHER name (PG_PORT) is not fed by the block: declare it in config.json e2e.portEnvNames ({\"postgres\": \"PG_PORT\"}) and the harness exports it with the same value in worktree.env, the compose env and the hook."
     },
-    {
-      "id": "infrastructure-neon-pgrag",
-      "name": "neon pgrag",
-      "path": "infrastructure/neon/neon-pgrag.md",
-      "category": "infrastructure",
-      "subcategory": "neon",
-      "tags": [
-        "infrastructure",
-        "neon",
-        "pgrag"
-      ],
-      "stacks": [
-        "neon"
-      ],
-      "anchors": {
-        "setup": "#install-pgrag",
-        "pipeline": "#full-rag-pipeline-example"
-      },
-      "digest": "pgrag (Neon `rag` extension family) is EXPERIMENTAL: use it for prototyping and simple SQL-only RAG, not production without testing. Run `SET neon.allow_unstable_extensions='true'` before `CREATE EXTENSION rag CASCADE` (also `rag_bge_small_en_v15`, `rag_jina_reranker_v1_tiny_en`). Local bge-small embeddings are 384 dims, OpenAI text-embedding-3-small is 1536: NEVER mix models in one column or use the local one when the app uses another model (dimension mismatch breaks search). Chunk with `rag.chunks_by_character_count` (1000 chars, 200 overlap); `embedding_for_passage` for documents, `embedding_for_query` for queries; create the pgvector HNSW index (m=16, ef_construction=64) after the initial load; rerank with `rerank_distance` (sort ASC). Keep API keys out of SQL scripts. For production .NET needing custom logic, use a typed MAF tool over pgvector (`ai-agents-rag-custom-pgvector`)."
-    },
     {
       "id": "infrastructure-neon-pgvector",
       "name": "neon pgvector",
@@ -1672,7 +1657,7 @@
         "setup": "#enable-pgvector",
         "queries": "#similarity-search"
       },
-      "digest": "pgvector on Neon with .NET VSA: packages Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 (snake_case columns mapped with HasColumnName, no naming-convention package); HasPostgresExtension('vector') in OnModelCreating emits CREATE EXTENSION in the migration. Map the column as Pgvector `Vector` (`vector(1536)` for text-embedding-3-small; EF does not map float[] or ReadOnlyMemory<float>) and call `npgsql.UseVector()` inside UseNpgsql (NpgsqlDataSourceBuilder.UseVector only for raw Npgsql). ALWAYS an HNSW index (HasMethod('hnsw'), vector_cosine_ops, m 16, ef_construction 64); the operator class must match the LINQ function (CosineDistance/L2Distance/MaxInnerProduct) or Postgres seq-scans. Query in the slice handler through ApplicationDbContext: `d.Embedding!.CosineDistance(query)`, filter by distance <= 1 - minSimilarity, OrderBy distance ASC (similarity = 1 - distance, never ORDER BY similarity DESC), return Result; no DocumentRepository, no raw SQL from C# (SQL functions such as match_documents/hybrid search only with a plan.md (## Decisões) justification). Ids from Guid.CreateVersion7() in the handler, never gen_random_uuid() defaults. ef_search (default 40) on the pooled endpoint needs SET LOCAL inside the query's transaction."
+      "digest": "pgvector on Neon with .NET VSA: packages Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 (snake_case columns mapped with HasColumnName, no naming-convention package); HasPostgresExtension('vector') in OnModelCreating emits CREATE EXTENSION in the migration. Map the column as Pgvector `Vector` (`vector(1536)` for text-embedding-3-small; EF does not map float[] or ReadOnlyMemory<float>) and call `npgsql.UseVector()` inside UseNpgsql (NpgsqlDataSourceBuilder.UseVector only for raw Npgsql). ALWAYS an HNSW index (HasMethod('hnsw'), vector_cosine_ops, m 16, ef_construction 64); the operator class must match the LINQ function (CosineDistance/L2Distance/MaxInnerProduct) or Postgres seq-scans. Query in the slice handler through ApplicationDbContext: `d.Embedding!.CosineDistance(query)`, filter by distance <= 1 - minSimilarity, OrderBy distance ASC (similarity = 1 - distance, never ORDER BY similarity DESC), return Result; no DocumentRepository, no raw SQL from C# (SQL functions such as match_documents/hybrid search only with a plan.md (## Decisões) justification). Ids from Guid.CreateVersion7() in the handler, never gen_random_uuid() defaults. ef_search (default 40) on the pooled endpoint needs SET LOCAL inside the query's transaction. Hybrid search: generated tsvector column with a GIN index plus pgvector, fused by rank with RRF, never a weighted sum of scores; pt-BR content needs a text search configuration with unaccent. On Neon, pg_search is removed, pgrag is deprecated, pgmq and Apache AGE are not in the catalog; lakebase_text (BM25) and lakebase_vector are Neon-only, so they need an ADR."
     },
     {
       "id": "infrastructure-neon-setup",
@@ -1860,7 +1845,7 @@
         "motion": "#section-6-motion-with-intent",
         "prototype": "#section-7-prototype-and-self-review"
       },
-      "digest": "Order beats talent: before any component of a new or changed screen, write 1-design/direcao.md with the concept in one sentence, the visual metaphor, what makes it memorable, and what it must NOT look like. New screens and brand moments (login, onboarding, first screen, empty state, success) explore 2-3 DISTINCT directions and recommend one with a product reason. Avoid template tells (raw shadcn look, white card centered on gray, generic icon list, default fonts, flat backgrounds, mobile as stacked desktop, decorative fade-ins, made-up numbers); three or more means raise it. Mobile is composed at 390px on its own (bottom sheet, thumb zone, 44px targets). Motion tells something with the lightest tool (CSS keyframes > scroll-driven CSS > Framer Motion > GSAP), transform/opacity only, and a composed reduced-motion version. Prove it in 1-design/prototipos/{screen}.html with the project REAL tokens, screenshotted at 1280 and 390 and revised until it passes."
+      "digest": "Order beats talent: before any component of a new or changed screen, write the direction (Direção escolhida in 1-design/mockups.md) with the concept in one sentence, the visual metaphor, what makes it memorable, and what it must NOT look like. New screens and brand moments (login, onboarding, first screen, empty state, success) explore 2-3 DISTINCT directions and recommend one with a product reason. Avoid template tells (raw shadcn look, white card centered on gray, generic icon list, default fonts, flat backgrounds, mobile as stacked desktop, decorative fade-ins, made-up numbers); three or more means raise it. Mobile is composed at 390px on its own (bottom sheet, thumb zone, 44px targets). Motion tells something with the lightest tool (CSS keyframes > scroll-driven CSS > Framer Motion > GSAP), transform/opacity only, and a composed reduced-motion version. Prove it in 1-design/prototipos/{screen}.html with the project REAL tokens, screenshotted at 1280 and 390 and revised until it passes."
     },
     {
       "id": "architecture-engineering-lens",
@@ -1930,6 +1915,44 @@
         "not-a-rule": "#o-que-não-é-regra"
       },
       "digest": "Rules with a reason that a machine can see are lint errors, not prose: one eslint.config.mjs at the Next app root, flat config spreading eslint-config-next/core-web-vitals and eslint-config-next/typescript, no new plugin. ESLint 9 (eslint-plugin-import/react peer range; the bundled typescript-eslint wants TypeScript <6.1); Next 16 next build no longer lints; the verify build node runs eslint --quiet on the files the feature changed (legacy lint debt never reddens a feature), from the app root, when eslint.config.* and eslint are present. no-restricted-imports bans framer-motion (one import path, motion/react), zustand/redux/@reduxjs/toolkit (server state is TanStack Query, page and filters in the URL), DB drivers pg/@neondatabase/serverless/@prisma/client/drizzle-orm/postgres (Next never touches the database; the .NET API does), the legacy shadcn @/components/ui/form, and @/features/*/* deep imports outside src/features (use the feature index.ts). import/no-restricted-paths: src/components never imports src/features, src/features never imports src/app, src/hooks never imports the API client (lib/api-client.ts, lib/api). no-restricted-syntax: fetch or apiClient called inside useEffect, and 'use client' in the root app/layout.tsx. import/no-default-export except Next convention files (page, layout, loading, error, not-found, template, default, route, sitemap, robots, icons, OG images) and *.config.*. @typescript-eslint/no-explicit-any error, no-console warn. A new restriction is one line in this file with the reason in its message; a one-off exception is eslint-disable-next-line with the reason. CSS class naming, animation class catalogs, optional className, Zod on props, motion counts and offsets, QueryClient defaults and prop-drilling depth are taste: neither prose nor lint."
+    },
+    {
+      "id": "architecture-stack-baseline",
+      "name": "stack baseline",
+      "path": "architecture/stack-baseline.md",
+      "category": "architecture",
+      "subcategory": null,
+      "tags": [
+        "architecture",
+        "stack",
+        "greenfield"
+      ],
+      "stacks": [
+        "*"
+      ],
+      "anchors": {
+        "stack": "#a-stack",
+        "declare": "#declarar",
+        "forbidden": "#padrões-proibidos",
+        "outside": "#fora-da-stack"
+      },
+      "digest": "Projeto novo começa na stack do Morph INTEIRA (dotnet+nextjs --with neon), mesmo que a primeira feature caiba em menos; recorte ou outra tecnologia só por escolha explícita do usuário:.NET 10 + Vertical Slice (handler + validator + endpoint + errors + tests), EF Core + Neon (Postgres), Result pattern com result.Match(), Microsoft Agent Framework quando houver agentes, Next.js App Router + Tailwind + Motion + Shadcn, Hangfire só com razão real, Docker Compose para as dependências locais. Postgres primeiro: serviço de dados novo (cache, fila, vetor, busca, grafo, banco de documento) pede ADR dizendo por que o Postgres do projeto não cobre; no Neon, pg_search saiu e pgmq e Apache AGE estão fora do catálogo de extensões. Tags: project.stack dotnet|nextjs|dotnet+nextjs; integrations neon, maf, docker. Declare com `morph-spec stack-set <stack> --with <integrações>`, que grava o config.json e instala as rules de domínio; as rules só carregam no início de uma sessão, então a sessão que implementa começa depois. Proibido: exception como fluxo, Service/Manager entre handler e dados, IRepository/IUnitOfWork, SQL cru sem ADR, redeclarar tipo existente. Outra tecnologia é ADR de projeto no plano, sem rule de domínio."
+    },
+    {
+      "id": "infrastructure-neon-platform",
+      "name": "neon platform",
+      "path": "infrastructure/neon/neon-platform.md",
+      "category": "infrastructure",
+      "subcategory": "neon",
+      "tags": [
+        "infrastructure",
+        "neon",
+        "platform"
+      ],
+      "stacks": [
+        "neon"
+      ],
+      "digest": "O que o Neon entrega pronto antes de contratar serviço. A região é fixa e limita o catálogo: Storage, Functions, AI Gateway e Realtime só em us-east-1, us-east-2, eu-central-1 e ap-southeast-1; sa-east-1 tem só Postgres e Auth. Branch descartável com --expires-at (máx. 30 dias) e reset para testar e ensaiar migration; schema diff com neon branches schema-diff ou neon diff; snapshot manual antes de migration com degrau:, com PITR na janela do plano; Object Storage S3-compatible (lifecycle não aplicado); AI Gateway OpenAI-compatible pede ADR por fugir do provider direto; list_slow_queries e prepare_query_tuning para consulta lenta; read replica é eventualmente consistente; IP Allow só no Scale e incompatível com Auth; protected branch contra apagar produção. Não adotar nesta stack: Functions para job .NET, Data API, Realtime (beta), Neon Local (proxy para a nuvem), Private Networking. MCP nunca em produção: o agente trabalha em branch. CLI agora é neon (login: neon login); neonctl ainda funciona."
     }
   ]
 }

package/framework/standards/STANDARDS.meta.json

@@ -683,7 +683,7 @@
         "IHandler pattern",
         "handler endpoint"
       ],
-      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview; minimal APIs, primary constructors, `Guid.CreateVersion7()`). The \"Complete Endpoint Example\" block compiles with `TreatWarningsAsErrors` over the `Result`/`ErrorHttpMapping` of `result-pattern.md` (in `ProjectName.Abstractions`/`ProjectName.Extensions`, reached only through the block's own `using`s); the other blocks are documentary.",
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview; minimal APIs, primary constructors, `Guid.CreateVersion7()`). The \"Complete Endpoint Example\" block compiles with `TreatWarningsAsErrors` over the `Result`/`ErrorHttpMapping` of `result-pattern.md` (in `ProjectName.Abstractions`/`ProjectName.Extensions`, reached only through the block's own `using`s); the other blocks are documentary. The \"Queue on Postgres\" claim ran sequentially on PGlite 0.5.13 (PostgreSQL 18): the eligibility predicate and the lease hold, while lock contention needs the integration test the section requires.",
       "provedBy": []
     },
     "backend-integrations-asaas-asaas-api": {
@@ -706,7 +706,7 @@
         "cron",
         "fire and forget"
       ],
-      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Hangfire.Core/Hangfire.AspNetCore 1.8.25 + Hangfire.PostgreSql 1.21.1 + Newtonsoft.Json 13.0.4. The startup, job/handler, dashboard-filter and idempotency blocks compile with `TreatWarningsAsErrors`; the Job Types calls compile inside a wrapper method; the per-job DI scope (`AspNetCoreJobActivator` → `IServiceScopeFactory`) and the `PostgreSqlStorageOptions` defaults were read by reflection on those assemblies; the pooled-endpoint limits (LISTEN/NOTIFY, migrations on the direct string) come from the Neon connection-pooling docs. Cron strings are documentary.",
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Hangfire.Core/Hangfire.AspNetCore 1.8.25 + Hangfire.PostgreSql 1.21.1 + Newtonsoft.Json 13.0.4. The startup, job/handler, dashboard-filter and idempotency blocks compile with `TreatWarningsAsErrors`; the Job Types calls compile inside a wrapper method; the per-job DI scope (`AspNetCoreJobActivator` → `IServiceScopeFactory`) and the `PostgreSqlStorageOptions` defaults were read by reflection on those assemblies; the pooled-endpoint limits (LISTEN/NOTIFY, migrations on the direct string) come from the Neon connection-pooling docs. Cron strings are documentary. Scale-to-zero behaviour read from the Neon docs.",
       "provedBy": []
     },
     "backend-integrations-neon-auth-neon-auth": {
@@ -730,7 +730,7 @@
         "bypass backend",
         "direct database access"
       ],
-      "verifiedAgainst": "Neon Auth — @neondatabase/auth + @neondatabase/auth-ui (Better Auth).",
+      "verifiedAgainst": "Neon Auth — @neondatabase/auth + @neondatabase/auth-ui (Better Auth), run on 2026-07-13; package names of `createNeonAuth`/`createAuthClient` and the install line read from the Neon quickstart for `@neon/auth` 0.8.x, not run.",
       "provedBy": []
     },
     "backend-integrations-resend-resend-email": {
@@ -1068,18 +1068,7 @@
         "portEnvNames",
         "local docker compose"
       ],
-      "verifiedAgainst": "Docker Compose v2 + morph-spec 8.34 (dedicated stack per worktree).",
-      "provedBy": []
-    },
-    "infrastructure-neon-pgrag": {
-      "aliases": [
-        "pgrag",
-        "RAG in SQL",
-        "embedding pipeline",
-        "Neon RAG",
-        "in-database RAG"
-      ],
-      "verifiedAgainst": "Neon pgrag (`rag` extension family — experimental, see Core Rules).",
+      "verifiedAgainst": "Docker Compose v2 + morph-spec 8.34 (dedicated stack per worktree). The `pgvector/pgvector:pg17` tag was confirmed on Docker Hub; the image was not run.",
       "provedBy": []
     },
     "infrastructure-neon-pgvector": {
@@ -1090,7 +1079,7 @@
         "Neon vectors",
         "HNSW index"
       ],
-      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). The entity, configuration, DbContext, search-handler and raw-Npgsql blocks compile with `TreatWarningsAsErrors` (handler over the `Result`/`IHandler` of `result-pattern.md`/`vertical-slice.md`), and the handler's query shape was translated with `ToQueryString()` to `ORDER BY d.embedding <=> @query`; the SQL (index DDL, `ef_search`, the two SQL functions) is documentary, checked against the pgvector README.",
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). The entity, configuration, DbContext, search-handler and raw-Npgsql blocks compile with `TreatWarningsAsErrors` (handler over the `Result`/`IHandler` of `result-pattern.md`/`vertical-slice.md`), and the handler's query shape was translated with `ToQueryString()` to `ORDER BY d.embedding <=> @query`; the SQL (index DDL, `ef_search`, `match_documents`) is documentary, checked against the pgvector README; `hybrid_search` ran on PGlite 0.5.13, not on a Neon compute; the `unaccent` dictionary in a text search configuration is what the Neon `unaccent` page describes (only `unaccent.rules` is closed); Lakebase Search read from the Neon docs.",
       "provedBy": []
     },
     "infrastructure-neon-setup": {
@@ -1101,7 +1090,7 @@
         "Neon CLI",
         "Neon setup"
       ],
-      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + neonctl. The DbContext registration, design-time factory and cold-start blocks compile with `TreatWarningsAsErrors`; that Npgsql 10 rejects `postgresql://` URIs and marks `Trust Server Certificate` as \"no longer needed and does nothing\" was measured on 10.0.3; the suspend-timeout API and `--cu` ranges were checked against the Neon docs (context7). neonctl commands are documentary.",
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + neonctl. The DbContext registration, design-time factory and cold-start blocks compile with `TreatWarningsAsErrors`; that Npgsql 10 rejects `postgresql://` URIs and marks `Trust Server Certificate` as \"no longer needed and does nothing\" was measured on 10.0.3; the suspend-timeout API and `--cu` ranges were checked against the Neon docs (context7). `neon` CLI commands are documentary; the top-level commands were read from `neon --help` 8.14.0.",
       "provedBy": []
     },
     "integration-mcp-mcp-tools": {
@@ -1112,7 +1101,7 @@
         "MCP server",
         "MCP client"
       ],
-      "verifiedAgainst": "Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`; Microsoft Learn MCP (`https://learn.microsoft.com/api/mcp`, tools listed by `tools/list` on 2026-10-17).",
+      "verifiedAgainst": "Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neon`; Microsoft Learn MCP (`https://learn.microsoft.com/api/mcp`, tools listed by `tools/list` on 2026-10-17).",
       "provedBy": []
     },
     "frontend-admin-app-data-table": {
@@ -1196,7 +1185,7 @@
         "refactor neutro",
         "migracao de teste"
       ],
-      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08); os dois blocos C# abaixo foram extraídos com `scripts/extract-doc-csharp.mjs` e compilados contra o pin com `TreatWarningsAsErrors`, e os três testes do segundo bloco foram executados e passam. **A separação em si e a migração de teste são verificação documental:** vêm da feature `tools-finas` do MORPH_GHLBrain e o ai-kit não as traz.",
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08); os dois blocos C# abaixo foram extraídos com `scripts/extract-doc-csharp.mjs` e compilados contra o pin com `TreatWarningsAsErrors`, e os três testes do segundo bloco foram executados e passam. **A separação em si e a migração de teste são verificação documental:** vêm de um projeto .NET em produção e o ai-kit não as traz.",
       "provedBy": []
     },
     "frontend-design-system-art-direction": {
@@ -1253,6 +1242,14 @@
       ],
       "verifiedAgainst": "eslint 9.39.5, eslint-config-next 16.4.2 (typescript-eslint 8.71.2, eslint-plugin-import 2.32.0), next 16.4.2, typescript 6.0.3 (sonda: um arquivo ruim por regra → erro da regra esperada, `no-console` → aviso, arquivos conformes e o scaffold `morph-spec scaffold nextjs` → 0 problemas).",
       "provedBy": []
+    },
+    "architecture-stack-baseline": {
+      "verifiedAgainst": ".NET 10, EF Core 10, Next.js 16 App Router, Microsoft Agent Framework 1.0; catálogo de extensões do Neon lido em 2026-10-30.",
+      "provedBy": []
+    },
+    "infrastructure-neon-platform": {
+      "verifiedAgainst": "Neon docs lidas em 2026-10-30 (regions, plans, backup-restore, branch-expiration, s3-compatibility, ai-gateway, neon-mcp-server, functions) + CLI `neon` 8.14.0. Nenhum bloco deste standard foi executado contra um projeto.",
+      "provedBy": []
     }
   },
   "sharedAliases": {

package/framework/standards/ai-agents/agent-session.md

@@ -21,12 +21,11 @@
 | O histórico é **só** a lista de mensagens, sem campo próprio, e o projeto não precisa lê-lo fora do agente | `AgentSession` + um `ChatHistoryProvider` embutido |
 | Protótipo, CLI, demo, teste | `InMemoryChatHistoryProvider` |
 
-**O veredito da casa: conversa própria como default.** Isso não é preferência — é a aplicação do critério acima aos projetos que existem. GHLBrain, MORPH_OS e ProspectPRO caem todos nas três primeiras linhas.
+**O veredito da casa: conversa própria como default.** Isso não é preferência — é a aplicação do critério acima aos projetos que existem. Os três agentes da casa em produção caem todos nas três primeiras linhas.
 
 ### Os três fundamentos, cada um citável
 
-1. **ADR D3 do GHLBrain.** O estado da conversa vive em `conv_checkpoints`; `ToolAgentRunner.cs:126-130` roda *"sem AgentThread/sessão"* — porque o **retry depende de o histórico ser visível e manipulável**: para repetir uma volta que falhou é preciso remontar as mensagens, e não dá para remontar o que está dentro de um objeto opaco. Registrado em `docs/specs/elevacao-9/brutos/scan-ghlbrain.md:58` e `:599`.
-2. **Doc oficial de self-hosting** (learn.microsoft.com/en-us/agent-framework/hosting/self-hosting/, `ms.date` 2026-08-17), verbatim: *"MAF doesn't include a general-purpose durable session store"*. Produção exige implementação própria. A mesma página recomenda, em conversa longa, um `ChatHistoryProvider` externo **com mensagens por linha** em vez de reescrever a sessão inteira a cada turno.
+1. **Decisão de arquitetura de um agente .NET em produção.** O estado da conversa vive em `conv_checkpoints`; o runner roda *"sem AgentThread/sessão"* — porque o **retry depende de o histórico ser visível e manipulável**: para repetir uma volta que falhou é preciso remontar as mensagens, e não dá para remontar o que está dentro de um objeto opaco.2. **Doc oficial de self-hosting** (learn.microsoft.com/en-us/agent-framework/hosting/self-hosting/, `ms.date` 2026-08-17), verbatim: *"MAF doesn't include a general-purpose durable session store"*. Produção exige implementação própria. A mesma página recomenda, em conversa longa, um `ChatHistoryProvider` externo **com mensagens por linha** em vez de reescrever a sessão inteira a cada turno.
 3. **Padrão do canal** (Rasmus, parte 06 — "Conversations"): objeto de conversa próprio do domínio, com **um** mapper para `ChatMessage`. A conversa é entidade de negócio; o formato do provedor é detalhe de transporte.
 
 ### Ligação com a Responses API

package/framework/standards/ai-agents/context-providers.md

@@ -23,7 +23,7 @@ Preciso que o agente saiba X.
                                                       (nem provider, nem tool)
 ```
 
-**O caso concreto que a regra evita:** RAG passivo injetado como context provider. O usuário digita "oi" e o agente paga uma busca vetorial + o custo dos trechos no prompt — **em todo turno**, inclusive nos que não precisam de conhecimento nenhum. Como tool, o "oi" não dispara busca alguma. Foi medido em produção: o escopo institucional da base do GHLBrain roda sem `LIMIT`, e passivo isso é custo por turno, não por necessidade.
+**O caso concreto que a regra evita:** RAG passivo injetado como context provider. O usuário digita "oi" e o agente paga uma busca vetorial + o custo dos trechos no prompt — **em todo turno**, inclusive nos que não precisam de conhecimento nenhum. Como tool, o "oi" não dispara busca alguma. Foi medido em produção: o escopo institucional de uma base de conhecimento roda sem `LIMIT`, e passivo isso é custo por turno, não por necessidade.
 
 ### O compositor determinístico — a alternativa que não é provider
 
@@ -45,7 +45,7 @@ var plan = PlanFor(conversation.Stage);
 var options = new ChatOptions { Instructions = plan.Instructions, Tools = [.. plan.Tools] };
 ```
 
-É a prática do GHLBrain (`OperatorPlan`) e o padrão do canal: **o código decide o modo, o LLM classifica**. Um provider que "sugere" quais tools usar deixa a decisão com o modelo; a allow-list tira a decisão do modelo.
+É a prática de um agente em produção (um plano do operador decidido em código) e o padrão do canal: **o código decide o modo, o LLM classifica**. Um provider que "sugere" quais tools usar deixa a decisão com o modelo; a allow-list tira a decisão do modelo.
 
 ---
 

package/framework/standards/ai-agents/durable-workflows-hitl.md

@@ -71,7 +71,7 @@ await foreach (WorkflowEvent evt in run.WatchStreamAsync())
 | **Um agente**, uma tool de efeito irreversível (cobrar, enviar proposta, apagar) | `ApprovalRequiredAIFunction` — **sem workflow nenhum** |
 | Um grafo com etapa humana entre executores, ou espera de dias | `RequestPort` + `CheckpointManager` |
 
-O caso do agente único é o que a casa realmente tem (MORPH_OS: billing, envio de proposta) e é o que faltava neste standard.
+O caso do agente único é o que a casa realmente tem (billing, envio de proposta) e é o que faltava neste standard.
 
 ### O ciclo, medido em `Microsoft.Extensions.AI` 10.9.0
 
@@ -271,7 +271,7 @@ This framework deploys to VPS/Coolify by default and does not adopt Azure as a d
 - Human-in-the-loop (HITL) | Microsoft Learn: https://learn.microsoft.com/en-us/agent-framework/workflows/human-in-the-loop
 - Checkpoints | Microsoft Learn: https://learn.microsoft.com/en-us/agent-framework/workflows/checkpoints
 - Durable Extension | Microsoft Learn: https://learn.microsoft.com/en-us/agent-framework/integrations/durable-extension
-- Release notes 1.14 (2026-07-21) e 1.17 do `microsoft/agent-framework` — graduação do `ToolApprovalAgent` e extração do Durable Task (compilados em `docs/specs/elevacao-9/brutos/research-maf.md:312-331`, lidos 2026-09-07)
+- Release notes 1.14 (2026-07-21) e 1.17 do `microsoft/agent-framework` — graduação do `ToolApprovalAgent` e extração do Durable Task (lidos 2026-09-07)
 
 ---
 

package/framework/standards/ai-agents/providers/model-registry.md

@@ -114,7 +114,7 @@ Read it narrowly, because it **is** narrow: the restriction needs **four** facts
 
 ### Origin 2 — measured in the field, no primary source
 
-*"Reasoning models reject `temperature != 1` when tools are present."* This is **measured in production**, not documented: GHLBrain's `ToolAgentRunner.cs:35-38` strips temperature for that path, recorded in `docs/specs/elevacao-9/brutos/scan-ghlbrain.md:106`, and corroborated by third parties (issues on `openai-python` and LibreChat). **The 2026-09-08 research did not find a primary OpenAI sentence stating it.**
+*"Reasoning models reject `temperature != 1` when tools are present."* This is **measured in production**, not documented: a production .NET agent strips temperature for that path, and this is corroborated by third parties (issues on `openai-python` and LibreChat). **The 2026-09-08 research did not find a primary OpenAI sentence stating it.**
 
 So it lives in the schema as a **per-alias flag with mandatory provenance** (`constraints.temperatureUnsupported` + `constraints.provenance`), never as a universal rule hardcoded in the registry. Whoever turns it on is asserting it for one specific model and writing where they got it from.
 
@@ -187,7 +187,7 @@ Going through `Microsoft.Extensions.AI` (`IChatClient`) or the MAF (`AIAgent`) k
 
 > **Restore trap, measured 2026-09-08:** `Microsoft.Extensions.AI.OpenAI` 10.9.0 declares `OpenAI (>= 2.12.0 && < 2.13.0)`. Pairing it with the pinned `OpenAI` 2.13.0 emits **NU1608** on restore. Either pin `OpenAI` to 2.12.x alongside the bridge, or accept the warning knowingly and write the decision in `plan.md` (`## Decisões`). Do not discover this in CI.
 
-**No floating ranges.** Every `PackageReference` above is an exact version. A floating `2.*` on a weekly-cadence SDK is how ProspectPRO bought a `MissingMethodException` on the Responses API **after paying for the call** (`docs/specs/elevacao-9/brutos/scan-prospectpro.md:55`).
+**No floating ranges.** Every `PackageReference` above is an exact version. A floating `2.*` on a weekly-cadence SDK is how a production project bought a `MissingMethodException` on the Responses API **after paying for the call**.
 
 **Adding a provider branch:** the `ModelRegistry.cs` template implements `openai` + `ollama`. To add `google`, `anthropic`, or `azure-openai`:
 1. Confirm the current NuGet SDK — community SDKs evolve; check NuGet/context7 before coding.