@polymorphism-tech/morph-spec 8.34.2 → 8.35.0

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

@@ -0,0 +1,215 @@
+---
+name: morph-media
+description: Conduz a AUTORIA de mídia gerada por IA — escolher o modelo pelo trabalho, montar o prompt como spec versionada, encadear derivadas a partir de um herói aprovado, subir a escada de custo e conduzir o gate humano de escolha entre N candidatas. É o lado processo; o conhecimento de API, custo e conformidade vive nos standards de mídia.
+version: core
+when-to-invoke: quando a tarefa é PRODUZIR imagem ou vídeo por IA (catálogo, marketing, asset de LP) e alguém precisa decidir modelo, prompt e aprovação
+user-invokable: true
+cliVersion: "8.35.0"
+stacks:
+  - dotnet
+  - nextjs
+---
+
+# morph-media
+
+## Objetivo
+
+Conduzir a **autoria** de mídia gerada: a sequência de decisões humanas que vai de "precisamos de
+uma foto do sofá em verde" até um arquivo aprovado, com o menor gasto possível e sem claim visual
+falso.
+
+**Esta skill não ensina API.** O que é `IImageGenerator`, quanto custa cada modelo, que alias está
+desligado e o que a lei exige está escrito, com fonte datada, em:
+
+| Standard | O que carrega |
+|---|---|
+| `.morph/framework/standards/ai-agents/modalities-image-gen.md` | Imagem em runtime: a API, os aliases pinados, custo por chamada, deprecações |
+| `.morph/framework/standards/ai-agents/media-video.md` | Vídeo em runtime: Veo por SDK, provedores só-HTTP, custo por segundo, o arquivo que expira |
+| `.morph/framework/standards/ai-agents/media-pipeline.md` | O job, os estados, a revisão humana, a proveniência e a marcação |
+| `.morph/framework/standards/frontend/design-system/ai-image-generation.md` | Autoria de asset de LP via MCP: fidelidade de marca, `assets.md`, `next/image` |
+| `.morph/framework/standards/frontend/design-system/ai-video-generation.md` | Footage direcional para scroll scrub: loop × direcional, `endImage`, moderação E005 |
+
+Abra o que a tarefa pede. Esta skill diz **o que fazer com eles**.
+
+## Quando invocar
+
+Quando alguém disser "gerar imagem do produto", "fazer o vídeo do reel", "criar o hero da LP",
+"variação de cor do móvel", "mockup para a campanha" — ou mencionar `/morph-media`.
+
+**Quando NÃO invocar:** 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/` acima.
+
+## A regra que atravessa tudo
+
+> **Nunca gere mídia dentro de um turno de conversa.** O turno enfileira e confirma; a mídia volta
+> depois, revisada.
+
+Ela vale na autoria também, e por outro motivo: dentro de um turno ninguém compara candidatas. A
+escolha entre N opções **é** o gate humano — ver §5.
+
+---
+
+## Passo 1 — Escolher o modelo pelo TRABALHO, não pelo hábito
+
+Uma pergunta decide quase tudo: **existe um produto real a preservar?**
+
+| Trabalho | Caminho | Por quê |
+|---|---|---|
+| Variação sobre foto real de produto | **Edição com referência**, nunca geração do zero | Gerar do zero inventa material, medida e cor que o produto não tem — claim visual falso |
+| Muitas referências do mesmo objeto | Modelo com maior teto de referências | O limite por modelo está no standard de imagem, §Referências de produto |
+| Lote grande e barato (thumbnails, variantes) | O alias de piso da família, com Batch | Batch é −50 %; é a maior alavanca isolada |
+| Texto legível dentro da imagem | Modelo com texto multilíngue, em `medium`/`high` | Texto pequeno em `low` sai errado, e re-render custa mais que ter começado certo |
+| Asset de LP com movimento de scroll | Footage **direcional**, nunca loop | Um loop perfeito parece congelado sob scrub — `ai-video-generation.md` §Section 1 |
+| Vídeo curto de produto em runtime | O caminho com SDK do `media-video.md` | É o único com SDK .NET oficial |
+
+**Antes de pinar qualquer alias, abra a tabela de deprecações** do standard da modalidade. Um alias
+desligado não é preferência de estilo: é uma chamada que devolve erro depois de você ter escrito o
+código inteiro em cima dela.
+
+## Passo 2 — Montar o prompt como spec versionada
+
+Prompt de produção é **template versionado**, nunca string concatenada. A ordem importa, e as duas
+famílias de modelo concordam nela:
+
+```
+cena/fundo → sujeito → detalhes-chave → restrições
+```
+
+Seis regras que mudam o resultado mais do que qualquer outra coisa:
+
+1. **Descreva em prosa, não em lista de keywords.** "beautiful, stunning, 4k, masterpiece" adiciona
+   ruído, não qualidade. Briefe como se briefasse um fotógrafo.
+2. **Seja hiper-específico no sujeito.** "armadura de fantasia" produz genérico; "armadura élfica de
+   placas prateadas, gravada com folhas, gola alta, ombreiras em asa de falcão" produz uma imagem.
+3. **Descreva em camadas** — primeiro plano, plano médio, fundo. Descrição plana produz imagem
+   plana; camadas produzem profundidade.
+4. **Iluminação é a maior alavanca isolada de qualidade.** Sempre declare, com termos de fotografia,
+   e prefira **múltiplas fontes** com direções e temperaturas diferentes. Luz única e frontal é o
+   que faz uma imagem parecer amadora.
+5. **Enquadre positivamente.** "rua deserta, completamente parada" funciona; "rua sem carros" não —
+   o modelo lida mal com negação.
+6. **Contexto e finalidade entram no prompt.** "logo para uma marca de skincare minimalista premium"
+   decide melhor que "faça um logo".
+
+**Texto na imagem:** cite literalmente entre aspas e soletre marcas. Erro de grafia é o defeito mais
+comum dessa categoria — **confira lendo a imagem gerada** e corrija com uma edição pontual ("corrija
+a grafia para 'X' exatamente; mantenha o resto"). Duas ou três iterações são normais.
+
+**Aspect ratio é decisão, não default.** Escolha pelo destino final (feed, story, banner, impressão).
+
+## Passo 3 — Editar é o oposto de gerar
+
+| | Gerar | Editar |
+|---|---|---|
+| Estratégia | **Profundidade** — composição em camadas, texturas, luz dramática | **Contenção** — 1 a 2 frases, exatamente o que muda |
+| Erro típico | Prompt raso → imagem plana e genérica | Prompt longo → o modelo "re-imagina" tudo e o resultado fica artificial |
+
+Padrões de edição que funcionam:
+
+- **Acrescentar/remover:** uma frase. Não explique como integrar — o modelo faz isso bem quando você
+  não o sufoca.
+- **Trocar o fundo:** diga o fundo novo e pare. Ele casa a iluminação sozinho.
+- **Inpaint:** nomeie o que muda e o que fica. *"Troque o sofá azul por um chesterfield de couro
+  marrom. Mantenha o resto."*
+- **"Preserve list" repetida em CADA iteração.** É o que impede o drift de acumular.
+- **Uma mudança por vez.** Refinamentos em série, nunca em bloco.
+- **Ao driftar, recomece** com a descrição completa em vez de empilhar correções.
+
+## Passo 4 — Encadear a partir de um herói aprovado
+
+A consistência não vem do prompt; vem da **referência**.
+
+1. Gere e **aprove** o herói primeiro — a imagem que define paleta, luz e enquadramento.
+2. Use o herói aprovado como **referência** das derivadas. Nunca gere as derivadas em paralelo com o
+   herói: elas herdam o erro que ainda não foi visto.
+3. Indexe cada referência no prompt ("image 1 = o sofá; image 2 = o tecido") e diga como interagem.
+4. Imagens que vão virar vídeo são enquadradas **sem rosto** — rosto derruba moderação, e o contorno
+   está em `ai-video-generation.md` §Section 3.
+
+**O que a IA nunca recria:** render arquitetônico do cliente e foto real de produto. Esses são
+animados ou editados a partir do arquivo real — recriá-los é inventar o que o cliente já tem.
+
+## Passo 5 — A escada de custo, e o gate humano que mora nela
+
+Os dois são **o mesmo passo**, e é isso que faz a escada ser cumprida em vez de pulada.
+
+```
+1. N candidatas na qualidade MAIS BAIXA / menor duração
+        ↓
+2. GATE: humano escolhe entre as N (ou manda regenerar)
+        ↓
+3. a VENCEDORA, e só ela, é regerada em alta
+        ↓
+4. GATE: aprovação final, com marcação e destino
+```
+
+Mecânica do gate, herdada de um fluxo que já rodou em produção:
+
+- **Mostre as N lado a lado.** Uma página local simples com as opções basta; o humano responde "opção 2".
+- **Registre a escolha** (passo, opção, arquivo) num arquivo de decisão. Sem registro, ninguém
+  reconstrói por que aquela imagem venceu.
+- **Rejeição volta ao MESMO passo.** Regenere com o feedback e reabra o gate. Nunca avance com "a
+  menos ruim".
+- **Para vídeo, mostre MOVIMENTO, nunca um still.** Um frame parado não prova que o scrub funciona —
+  o canvas pode estar quebrado e a foto parecer ótima. Apresente o preview navegável ou uma tira de
+  frames em posições diferentes.
+- **Juiz LLM é pré-filtro**, para derrubar as obviamente ruins e economizar o tempo do humano. Ele
+  não assume a responsabilidade por um claim visual.
+
+Sem a escada, a conta de gerar tudo em alta é dezenas de vezes maior — os números estão em
+`modalities-image-gen.md` §Custo por chamada e `media-video.md` §Custo por segundo.
+
+## Passo 6 — Fechar: nomear, marcar, registrar
+
+- **Nome em kebab-case sem acento**, dizendo o que é: `hero-sofa-verde-01.png`.
+- **Grave os bytes** no repositório do projeto ou no blob próprio. URL de provedor expira — e no
+  vídeo, o arquivo do provedor some em dois dias.
+- **Registre a proveniência**: modelo, prompt final, referências, opções, custo estimado. É o que
+  responde "de onde veio esta imagem" seis meses depois.
+- **Marque como gerada por IA** quando a imagem puder parecer autêntica sobre produto, pessoa ou
+  lugar, registrando **o texto e a superfície** — legenda, sobreposição, texto alternativo, ficha do
+  produto. "Marcado" sem dizer ONDE não responde se alguém consegue ver. A obrigação, com a ressalva
+  de fonte, está em `media-pipeline.md` §Marcação; quando a mídia nasce em runtime, o ponto de
+  publicação **recusa** sem esse par (§Como esta obrigação é presa).
+- **Nunca publique claim visual falso:** material, medida ou cor que o produto não tem. Produto real
+  sobre cena gerada é declarado como tal.
+
+---
+
+## Mapa rápido: imagem por fase de um trabalho de marca
+
+Quando o trabalho é identidade visual e não catálogo, a lista do que gerar é esta — e o **nível
+mínimo** diz o que não pode faltar:
+
+| Fase | Imagens | Nível |
+|---|---|---|
+| Estratégia | moodboard estratégico (1) | opcional |
+| Naming / conceito | moodboard de conceito (1) | quando a fase roda |
+| Identidade visual | 2-3 conceitos de logo + 1 swatch de paleta + 1 moodboard fotográfico | **core** |
+| Templates sociais | 1-2 mockups (feed + story) | opcional |
+| Impressos / aplicação | 1-2 mockups (cartão, fachada, tela) | opcional |
+| Brand book | capa (1) | quando o book roda |
+
+**Regra de ouro desta trilha:** o modelo gera **conceito e mockup**, nunca o vetor final do logo.
+Diga isso ao usuário com todas as letras — "são conceitos para direção; o logo vetorial final é
+trabalho de design". Tratar a saída como entregável vetorial é o erro clássico aqui.
+
+## Anti-patterns
+
+| Anti-pattern | Por quê é errado |
+|---|---|
+| Gerar tudo em alta qualidade "para já sair pronto" | Multiplica a conta por dezenas e ainda assim exige escolha |
+| Gerar as derivadas antes de aprovar o herói | Elas herdam o erro que ninguém viu ainda |
+| Prompt de edição longo | O modelo re-imagina a cena e o resultado fica artificial |
+| Aprovar vídeo por um frame parado | Um still não prova movimento |
+| Empilhar correções depois do drift | Recomeçar com descrição completa custa menos |
+| Pinar um alias sem abrir a tabela de deprecações | Código inteiro escrito sobre um endpoint com data de morte |
+| Guardar a URL do provedor | Ela expira; guarde os bytes |
+| Recriar por IA o render ou a foto real do cliente | Inventa o que já existe, e vira claim falso |
+| Tratar conceito de logo como arte final | O vetor é trabalho de design, não de modelo |
+
+## Referências
+
+- Os cinco standards da tabela do topo — a fonte de API, custo, prazo e conformidade.
+- Proveniência do conhecimento absorvido: `.morph/framework/standards/PROVENANCE.json`
+  (`gemini-image`, `cinematic-lp`, `brand-design`).

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

@@ -4,7 +4,7 @@ description: Guia a produção dos artefatos de planejamento de uma feature (use
 version: core
 when-to-invoke: ao iniciar a fase plan de uma feature, após o Gate 1 (proposal aprovado)
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-plan
@@ -24,6 +24,13 @@ Ao iniciar a fase plan — após o `proposal.md` ser aprovado e antes de qualque
 
 1. **Garanta que `proposal.md` e `stack-scan.md` estão no seu contexto antes de planejar.** Se não tem o conteúdo atual em contexto (sessão fresca, ou conteúdo possivelmente desatualizado), **use a tool Read para carregá-los** — não confie em cache de turnos anteriores. Na dúvida, Read. `.morph/features/{feature}/0-proposal/proposal.md` (problema, escopo, riscos — o comportamento é destilado aqui no passo 2, não vem pronto do proposal) e `.morph/features/{feature}/0-proposal/stack-scan.md` (contexto técnico detectado: greenfield vs brownfield, stack atual, drift). Em brownfield, o stack-scan informa decisões de spec/mandate — não invente padrões que conflitam com o detectado.
 
+   **E `.morph/features/{feature}/1-design/*.md`, quando o diretório existe** — os artefatos da fase
+   uiux (wireframes, decisões de layout, componentes propostos). Leia TODOS os `.md` de lá: eles
+   descrevem comportamento de interface que o `proposal.md` não carrega, e um plano que os ignora
+   dimensiona a feature pela metade. **Diretório ausente NÃO é erro** — a fase uiux é opcional
+   (MORPH.md §2.1) e a maioria das features não a toma; nesse caso não há passo nenhum a rodar e o
+   plano segue idêntico ao de hoje.
+
 1b. **Scout — mapa do território antes de planejar (opcional, mas o default em feature grande ou brownfield).** É o call-site do "scout opcional antes do plan" que a MORPH.md promete. Dispare quando a feature toca área que você não tem em contexto, ou quando o `stack-scan.md` acusou brownfield com desvios.
 
    ```
@@ -145,9 +152,19 @@ Ao iniciar a fase plan — após o `proposal.md` ser aprovado e antes de qualque
        dentro de um worktree. Se estiver cravado, **isso é uma task**.
      - **Setup de autenticação**, se a aplicação tem login: `e2e.auth` em `config.json`
        (`mode: seed|storageState|bypass|none`, `seedCommand`, `storageStatePath`, `envFile`), com as
-       credenciais num `.env.e2e` **gitignored** — nunca no config commitado. **Se a app tem login e
+       credenciais num `.env.e2e` **gitignored** — nunca no config commitado. **`mode` é obrigatório
+       sempre que houver `seedCommand`**: com `mode` ausente (ou `"none"`) o seed fica **inerte** — o
+       comando está configurado e nunca roda, e o autor acredita que a base é semeada. O `verify`
+       avisa (`[e2e] warning: …` nomeando `e2e.auth.seedCommand` e `e2e.auth.mode`), mas um aviso não
+       repara um plano: escreva o `mode` no config que a task de setup entrega. **Se a app tem login e
        isso não existe, crie a task de setup**: sem ela a navegação para na tela de login e a
        verificação de runtime vira teatro. É gap de Gate 2, não dispensa de Gate 3.
+     - **Baseline de contagem de testes é um COMANDO aqui também:** se o projeto declara
+       `project.tests[]`, o `expectedCount` de cada suíte é gravado por `morph-spec verify {feature}
+       --record-baseline` a partir de uma execução verde — **nunca digitado no config**. Um número
+       inventado **alto demais** deixa o verify vermelho por `count-drop` e trava o próprio comando que
+       o consertaria (só sai rebaixando/apagando o número à mão). Forma de `project.tests[]`:
+       `.morph/framework/CLI.md`, seção "Suítes de teste".
      - **Quando não se aplica** (biblioteca pura, chore sem runtime), registre a dispensa e o porquê.
    - Checklist de done com critérios verificáveis por tarefa.
    - **Baseline é um COMANDO, nunca um número.** O mandate congela no Gate 2 e é lido por
@@ -221,6 +238,19 @@ Ao iniciar a fase plan — após o `proposal.md` ser aprovado e antes de qualque
 
    **Preencha `outputs` (paths planejados) em cada task** — o `morph-spec dag` usa os outputs para detectar colisão de arquivos entre fluxos paralelos e recomendar `isolation: "worktree"`. Task sem `outputs` entra como footprint desconhecido (não força isolamento, mas o dag não consegue protegê-la de colisão).
 
+   **5c. Cross-check do `1-design/` — todo aviso de capacidade tem destino.** Se o diretório existe,
+   rode antes de fechar o array `tasks`:
+
+   ```bash
+   grep -riE "capacidade nova|precisa de backend|dimensionar junto" .morph/features/{feature}/1-design/
+   ```
+
+   Cada ocorrência é o designer dizendo que a tela pede algo que ainda não existe. Ela vira **task
+   irmã** no `tasks.json` **ou** exclusão registrada em `decisions.md` com o motivo — **nunca fica
+   sem destino**. Medido em campo: duas ocorrências dessas passaram batidas em features reais e
+   viraram trabalho descoberto na fase implement, quando o escopo já estava aprovado no Gate 2.
+   Sem hits, ou sem `1-design/`, o passo é um no-op silencioso.
+
    Antes de retornar, valide rodando `morph-spec dag {feature}` — o comando parseia e valida o schema do tasks.json (ids únicos `T\d+`, enums de `status`/`effort`, `dependencies` válidas) e já imprime a análise de DAG que a `/morph-apply` vai usar. Erros de schema abortam com a lista do que corrigir.
 
 6. Apresente o Gate 2 segundo trust mode.
@@ -283,6 +313,7 @@ Ao registrar a aprovação do Gate 2, atualize o frontmatter de cada use case de
 - `morph-spec graph explain|affected --uses-only` — "isto já existe?" e "quem usa de verdade" (passo 1c); **sem grafo, o fallback é `grep -rn`**
 - `.morph/context/README.md` — inventário do projeto (entidades, endpoints, componentes com path); insumo declarado do passo 1c, atualizado por `morph-spec context refresh`
 - `.morph/specs/usecases/` — acervo permanente de use cases do projeto (`usecase reserve` já lê antes de numerar; em `bug`, é onde mora o UC a corrigir)
+- `.morph/features/{feature}/1-design/` — artefatos da fase uiux, insumo do passo 1 e do cross-check do passo 5c (ausente não é erro)
 - `.morph/features/{feature}/0-proposal/proposal.md` — escopo da feature
 - `.morph/features/{feature}/0-proposal/stack-scan.md` — contexto técnico detectado
 - `.morph/framework/schemas/tasks.schema.json` — schema e enums de tasks.json

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

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-proposal

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

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-review
@@ -59,16 +59,21 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      que este passo trata — prossiga com o dispatch abaixo.
 
    **Despache o avaliador independente** — o score do Gate 3 nunca é auto-atribuído por quem implementou:
-   - Rode `morph-spec verify {feature} --json` (escopo feature) e capture o JSON — é a saída real de build+testes+validadores+e2e que você anexa ao prompt do avaliador independente (`morph-evaluator`).
+   - Rode `morph-spec verify {feature} --json` (escopo feature) e capture o JSON — é a saída real de build+testes+validadores+e2e que você anexa ao prompt do avaliador independente (`morph-evaluator`). **Sem `--filter`, sempre:** o `--filter` é do loop por task, onde o relógio de uma task não paga a suíte inteira; a prova que o avaliador lê tem de cobrir **todos** os nós de `nodes.tests.runs[]` (uma suíte filtrada aparece como `skip` nomeando o filtro — Gate 3 aberto sobre isso é verde sobre código não testado). Se a suíte inteira não couber numa chamada, rode-a em background; não a encolha com `--filter`.
    - **Confira o nó `e2e` do verify antes de despachar.** Ele carrega o estado do stack:
      - `pass` → a aplicação subiu e está saudável; o avaliador pode navegá-la. **Passe a URL no prompt**
        — cada feature roda no seu bloco de portas, não em `localhost:3000`; pegue de
        `morph-spec e2e status {feature} --json` (`baseUrl`) e não deixe o avaliador adivinhar.
      - `fail` → **não abra o Gate 3.** Volte ao loop de correção: a app não sobe, ou as specs quebraram.
-     - `skip` → leia a razão e decida se a dispensa é legítima. "não containeriza" num projeto sem UI é
-       legítimo; "docker indisponível no ambiente" numa feature de UI **não** é — registre você mesmo
-       `morph-spec gate-decision {feature} review --pause true --reason "e2e não verificado: {razão}"`.
-       O disco não distingue dispensa legítima de verificação que faltou; esse julgamento é seu.
+     - `skip` → **a classificação já é do `gate-check`, não sua.** A razão literal do skip viaja no
+       stamp `verification` (`e2eReason`) e `classifyE2eSkip` — em `risk-detector.js`, fonte única —
+       decide: `project` ("não containeriza") e `scope` ("o grupo de tasks não toca runtime") são
+       **dispensa legítima** e passam com o motivo gravado em `gateDecisions.review.signals`;
+       `environment` ("docker indisponível"), `requested` (`--skip-e2e`) e `unknown` (qualquer outra
+       razão, **inclusive razão nenhuma**) **pausam o Gate 3 sozinhos**. Não registre `gate-decision`
+       à mão para esses casos — deixou de ser necessário. O que continua sendo seu: dizer ao avaliador
+       que a app **não** foi exercida, e atacar a causa (rodar o e2e onde ele possa rodar) em vez de
+       despachar como se ela tivesse sido.
    - **Confira também `traceability.warnings`** (advisory, nunca faz `verify` falhar): cada entrada é
      um arquivo citado no `recap.md` sem task dona em `outputs` — repasse ao avaliador como sinal de
      rastreabilidade para a dimensão de qualidade, não como bloqueio automático do gate.
@@ -118,6 +123,89 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          dimensão e ainda assim piorou o produto — e essa pergunta é a única
          que o score não faz sozinho. Não aceite "agora tem teste" como
          fechamento: RE-EXECUTE os probes da rodada anterior.
+         PROCURE O QUE ESTÁ ERRADO — não confirme o que já foi dito.
+         Um relatório que só concorda com o recap não avaliou nada. A
+         pergunta que orienta a sua sessão inteira é: O QUE O IMPLEMENTADOR
+         NÃO VIU? O que ele não podia ver do lugar onde estava, o que ele
+         viu e não mediu, e o que ele mediu com a régua errada.
+         PROVE, não confie: um teste verde prova que o código RODA, nunca
+         que o teste MORDE. Aplique as cinco rubricas de PROVA e pontue-as
+         0-10 (elas NÃO são dimensões do composto; impõem teto em
+         test-coverage):
+           .morph/framework/evals/proof-rubrics/mutation-proof.md
+           .morph/framework/evals/proof-rubrics/verde-nao-e-coberto.md
+           .morph/framework/evals/proof-rubrics/fiacao.md
+           .morph/framework/evals/proof-rubrics/guard-cego.md
+           .morph/framework/evals/proof-rubrics/eval-de-modelo.md
+         E, SÓ quando a feature chama LLM, mais uma — que impõe teto em
+         code-quality, não em test-coverage:
+           .morph/framework/evals/proof-rubrics/observabilidade-genai.md
+         A aplicabilidade dela NÃO é determinística, e isso é deliberado:
+         nenhuma leitura de tasks.json ou do mandate mede "esta feature
+         chama um modelo". São DUAS etapas. (1) FILTRO mecânico, de alta
+         recall: o mandate.md cita ao menos um standard ai-agents — falso
+         ⇒ `not_evaluated`, sem mais discussão. (2) DETERMINAÇÃO sua, por
+         escrito: a feature entrega código que CHAMA um modelo? Registre a
+         resposta COM O MOTIVO (o símbolo/arquivo que chama, ou por que o
+         diff não chama nada). Task com group em {docs, tests} é INDÍCIO
+         contra, nunca veredito — um harness de agente vive inteiro em
+         `tests`. `not_evaluated` NÃO aplica teto, e um not_evaluated MUDO
+         não é dispensa: é o escape que o standard ai-agents-guardrails
+         proíbe (standard, não rubrica — não existe rubrica de guardrails).
+         Ela pergunta a PROPRIEDADE ("dá para reconstruir o que foi
+         ao provedor, e o que ele respondeu, neste turno?"), nunca "tem span
+         OpenTelemetry?": telemetria própria COM teste de fidelidade alcança
+         9-10 igual, e wiring sem evidência capturada não passa de 8.
+         MUTAÇÃO — o método, e a ordem dele importa:
+           - COMMITE O FIX ANTES DE MUTAR. Se a sessão morrer no meio, o
+             que sobrevive é a mutação, não a correção.
+           - Ancore no CALL SITE que carrega a decisão, não no `if`
+             refatorado. Uma rodada POR CLÁUSULA de um predicado composto.
+           - Rode a suíte INTEIRA (sem filtro): só ela autoriza a frase
+             "derruba N de M". Filtro estreito é prova vácua.
+           - LEIA O MOTIVO da falha, não só o md5: md5 prova que ALGO
+             mudou, jamais O QUÊ.
+           - REVERTA por snapshot/restore de BYTES (cópia feita ANTES) +
+             `os.utime` para devolver o mtime, e confirme por md5. NUNCA
+             `git checkout --`: ele descarta trabalho não commitado de
+             outra pessoa — aconteceu de verdade num Gate 3 desta epic.
+           - TERMINE com `git status --porcelain src/` VAZIO. Mutação
+             esquecida em produção é o pior desfecho deste método.
+         Grave no relatório a seção `## Mutações`, uma linha por mutação,
+         com os CINCO campos: arquivo:linha | diff | md5 antes/depois |
+         quantos testes derrubou (sobre o total da suíte) | o MOTIVO
+         literal da falha. Feature sem código de produção declara a seção
+         com a linha `não aplicável — feature sem código de produção`. A
+         seção é OBRIGATÓRIA: sem ela o `morph-spec gate-check` PAUSA o
+         Gate 3 sozinho, e nenhum score alto compra a passagem.
+         MÍDIA GERADA — rubrica CONDICIONAL, aplique SÓ se a feature gera
+         mídia (alguma task de tasks.json cita, em standards[], um destes:
+         standards/ai-agents/modalities-image-gen.md,
+         standards/ai-agents/media-video.md,
+         standards/ai-agents/media-pipeline.md). Nesse caso aplique também
+         e pontue 0-10:
+           .morph/framework/evals/proof-rubrics/media-claims.md
+         Ela cobra QUATRO afirmações — custo, revisão humana, marcação e
+         hot path não bloqueado — cada uma com o código que a prende e o
+         teste que a prova. Grave a seção `## Mídia gerada` com uma linha
+         por afirmação. A seção é OBRIGATÓRIA nessa condição: sem ela o
+         `morph-spec gate-check` PAUSA o Gate 3. Feature que NÃO gera mídia
+         não declara a seção nem a chave — a isenção é automática, e
+         escrever a seção "por precaução" é cerimônia vazia.
+         Grave também a linha literal, machine-readable:
+         `**Proof-Scores:** mutation={n} verde={n} fiacao={n} guard={n} eval={n}`
+         — os cinco 0-10, na ordem das rubricas acima. O MENOR deles
+         impõe o teto em test-coverage (tabela em
+         .morph/framework/evals/rubrics/test-coverage.md).
+         Se a feature gera mídia, acrescente ` media={n}` à MESMA linha.
+         Se a rubrica de observabilidade GenAI se aplicar, acrescente
+         ` obs={n}` (ou ` obs=not_evaluated`) à MESMA linha.
+         As duas são lidas À PARTE: NÃO entram no mínimo acima (um media ou
+         um obs baixo não pode derrubar o teto de teste por um motivo que
+         não é de teste). `media` impõe teto em ARQUITETURA (tabela em
+         .morph/framework/evals/rubrics/architecture.md) e `obs` impõe teto
+         em CODE-QUALITY (tabela em
+         .morph/framework/evals/rubrics/code-quality.md).
          Contrato do relatório final: GRAVE seu relatório em
          `.morph/features/{feature}/4-review/evaluator-report.md` ANTES de
          encerrar — esse arquivo é o valor de retorno autoritativo desta
@@ -137,6 +225,33 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          é falha de protocolo.
      ```
    - **Fallback (tipo não registrado):** se `morph-evaluator` não estiver na sua lista de subagent types, despache `general-purpose` colando o campo `persona` do agente `evaluator` (Read em `.morph/framework/agents.json`) no topo do prompt — e **registre o fallback no review-report** (seção de método).
+   - **Ao retomar o controle, HIGIENE DA ÁRVORE antes de qualquer leitura de score.** Rode, nesta
+     ordem e ANTES de abrir o relatório:
+     ```bash
+     git status --porcelain src/      # vazio = o avaliador reverteu o que mutou
+     grep -rn "MUTACAO" src/          # nenhum hit = nenhum marcador esquecido
+     ```
+     (No PowerShell, `Select-String -Path src -Pattern MUTACAO -Recurse` faz o mesmo; o shell do
+     harness é Git Bash, então a forma POSIX acima é a canônica.) **Por que antes:** o avaliador
+     muta código de produção de propósito, e um avaliador que morreu no meio da rodada deixa a
+     mutação NO DISCO. Ler o score primeiro e só depois descobrir a árvore suja significa ter
+     avaliado — e possivelmente aprovado — um estado que ninguém quis. E **não rode build/teste
+     enquanto o agente ainda está `running`**: ele muta o disco a meio, e o vermelho que você veria
+     seria da mutação dele, não do produto.
+
+     Árvore suja aqui é **falha de protocolo**. Reverta **pela mesma disciplina que o prompt exige
+     do avaliador** — nunca por git: peça o snapshot que ele diz ter feito (`cp` ANTES de mutar) e
+     restaure por cópia, conferindo `md5sum` de cada arquivo. Sem snapshot recuperável, o caminho é
+     desfazer a edição **linha a linha**, a partir do `diff` que a seção `## Mutações` obriga a
+     registrar. Registre o que fez na seção de método do review-report.
+
+     > **NUNCA `git checkout -- src/` aqui**, nem com ressalva. Na árvore típica de uma feature em
+     > review **não existe nenhum commit da feature** — o trabalho inteiro está não commitado, e o
+     > `checkout` o apaga junto com a mutação. Numa árvore desta epic havia 23 arquivos modificados
+     > e zero commits próprios; nesta mesma epic um avaliador rodou esse comando e destruiu
+     > alterações não commitadas de outro agente (só não houve perda porque ele tinha capturado o
+     > diff antes). É a mesma proibição que o prompt do passo 4 já dá ao avaliador: aqui ela vale
+     > para VOCÊ.
    - **Leia primeiro** `.morph/features/{feature}/4-review/evaluator-report.md` — é o valor de retorno autoritativo, não a mensagem de texto do dispatch (que é cortesia, útil só quando chega inteira). Os scores por dimensão e o composto do review-report vêm **desse arquivo**, não da sua auto-avaliação. Se o arquivo vier ausente, oco, ou sem os scores por dimensão, registre a falha de protocolo na seção de método do review-report e re-despache.
 
 5. Produza `review-report.md` em `.morph/features/{feature}/4-review/` com:
@@ -152,6 +267,24 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      avaliador navegou. Dispensa (`skip`) entra aqui **por extenso**: o valor de um gate está tanto
      no que ele provou quanto no que ele deixou de provar, e uma dispensa silenciosa se lê como
      aprovação. Se houver spec Playwright recomendada pelo avaliador, liste-a como melhoria.
+   - **Prova de mutação** — a seção `## Mutações` do `evaluator-report.md`, repassada aqui em
+     resumo (quantas mutações, quantas derrubaram teste, e a linha `**Proof-Scores:**`). O formato
+     que o avaliador grava, e que o `morph-spec gate-check` cobra:
+
+     ```markdown
+     ## Mutações
+
+     | # | Arquivo:linha | Mutação (diff) | md5 antes | md5 depois | Testes derrubados | Motivo da falha |
+     |---|---|---|---|---|---|---|
+     | M1 | src/lib/x.js:42 | `- if (a && b)` / `+ if (a)` | abc… | def… | 3 de 2684 | `expected 3 got 0` em x.test.js:88 |
+
+     **Reversão:** snapshot/restore de bytes + `os.utime`; `git status --porcelain src/` vazio.
+     **Proof-Scores:** mutation=9 verde=8 fiacao=9 guard=7
+     ```
+
+     Feature sem código de produção declara a seção com `não aplicável — feature sem código de
+     produção`. **Sem a seção, o `gate-check review` PAUSA** — a regra vive em código
+     (`risk-detector.js`), não na boa vontade do prompt.
    - Lista de itens bloqueantes (se houver) — com descrição e critério de resolução
    - Lista de melhorias recomendadas (não bloqueantes)
    - Recomendação final: Aprovado / Rejeitar com condições / Reprovar
@@ -161,6 +294,20 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
    (A barra de avanço por task é 9; uma dimensão individual abaixo de 8 no review da feature
    inteira é um bloqueante crítico que o loop de correção deveria ter pego.)
 
+   **Para CONFIRMAR uma correção, retome o MESMO avaliador — não despache um frio.** Use
+   `SendMessage` com o id do agente que já avaliou, colando no recado o `git status --porcelain` e o
+   `git log --oneline` do que mudou desde o relatório dele. Ele já tem em contexto o que apontou e
+   os probes que rodou; um avaliador novo re-descobre o produto inteiro para checar um item, e
+   re-executa do zero os probes da rodada anterior.
+
+   > Isto **não** contradiz a cláusula que proíbe o **sub-agent** de chamar `SendMessage`. As
+   > direções são opostas: o sub-agent não chama `SendMessage` porque o retorno dele é o ARQUIVO, e
+   > uma mensagem a mais custa um turno inútil ao orquestrador. Aqui quem fala é o ORQUESTRADOR,
+   > para dentro de uma sessão que ele mesmo abriu — a única forma de continuar uma avaliação em vez
+   > de recomeçá-la. Se o agente já encerrou e o id não retoma, aí sim despache um novo, e diga a
+   > ele no prompt que é uma REAVALIAÇÃO (o relatório é append-only: ele acrescenta ao fim, e o
+   > `gate-check` lê o token do FIM, o vigente).
+
 7. **NÃO finalize o trace manualmente.** O hook `trace-autogen` gera e finaliza `.morph/traces/YYYY-MM-DD-{feature}-implement.json` automaticamente (incl. `phase_summary` e `completed_at`) no último write de `tasks.json` — quando a última task sai de `pending`/`in_progress`. Se o trace parecer desatualizado, a causa é um `morph-spec score` faltante ou um recap sem o bloco da task — corrija a fonte, não o trace.
 
 8. Apresente o Gate 3 segundo trust mode — **única apresentação do gate**: `morph-apply` §5 aponta
@@ -168,12 +315,14 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 
    Rode `morph-spec gate-check {feature} review [--json]` — lê `trust` de `.morph/config/config.json`, decide via `shouldPauseGate` e persiste `gateDecisions.review` com timestamp server-side, imprimindo `pause`/`reason`/`signals`. É o default — não recompute a tabela do MORPH.md §5 em linguagem natural.
 
-   **`evalScore` sem override é uma PROXY** (média das `taskScores`, não o composto real). Passe o composto retornado pelo **avaliador independente** (passo 4) e qualquer item bloqueante encontrado nas **verificações mecânicas sempre-rodar** do passo 3 via `--signals` — as únicas chaves que este comando aceita sobrescrever:
+   **NÃO passe `evalScore` por `--signals` aqui.** O composto do avaliador é lido do disco sozinho: o `gate-check` procura o token `**Composite-Score:**` em `4-review/evaluator-report.md` (passo 4) e carimba `evalScoreSource: evaluator-report` — a **única** procedência que o Gate 3 aceita. Um `evalScore` vindo por override troca o valor mas rebaixa a procedência para `signals-override`, e o Gate 3 **pausa** por "sem score do avaliador independente" sem sequer olhar o número — inclusive quando é o mesmo número do relatório. Sem o token (relatório ausente ou oco), o `evalScore` cai na **PROXY** das `taskScores` — auto-avaliação de quem implementou — e o gate pausa igual. A correção, nos dois casos, é produzir o relatório íntegro do passo 4; nunca o override.
+
+   Os itens bloqueantes das **verificações mecânicas sempre-rodar** do passo 3 continuam entrando por `--signals` — é para isso que a flag serve aqui:
    ```
-   morph-spec gate-check {feature} review --signals '{"evalScore":9.2,"standardsViolations":[]}'
+   morph-spec gate-check {feature} review --signals '{"standardsViolations":[]}'
    ```
 
-   Julgamento do revisor que nenhuma dessas chaves representa: use `gate-decision` direto em vez de `gate-check`.
+   Julgamento do revisor que nenhuma dessas chaves representa — e forçar a passagem apesar da pausa: use `gate-decision` direto em vez de `gate-check` (`morph-spec gate-decision {feature} review --pause false --reason "..."`), que é explícito e fica registrado.
 
    **Nunca edite `feature.json` à mão** (colide com o hook state-sync — erro "file modified since read"). Os caminhos acima gravam no mesmo lugar; o hook `gate-guard.js` confere depois se a ação bateu com a decisão persistida.
 
@@ -218,6 +367,14 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 - `.morph/framework/MORPH.md` — seção 5 (Gate 3 + regras de pausa), seção 1 (papel Evaluator), Trust Mode
 - `.claude/agents/morph-evaluator.md` — subagent do avaliador (gerado de `.morph/framework/agents.json`), despachado no passo 4
 - `.claude/skills/morph-eval/SKILL.md` — rubricas e bandas que o avaliador aplica
+- `.morph/framework/evals/proof-rubrics/` — as sete rubricas de PROVA citadas no prompt do passo 4
+  (`mutation-proof.md`, `verde-nao-e-coberto.md`, `fiacao.md`, `guard-cego.md`, `eval-de-modelo.md`, `media-claims.md`, `observabilidade-genai.md`):
+  não são dimensões do composto. **Cinco** impõem teto em `test-coverage` pelo MENOR delas — as quatro
+  universais mais `eval-de-modelo`, que perguntam a mesma coisa: *a evidência é real?*. As outras
+  duas são condicionais e entram FORA do menor-das-cinco: `media-claims.md`, em feature que gera
+  mídia, impõe teto em `architecture`; `observabilidade-genai.md`, em feature que chama LLM, impõe
+  teto em `code-quality`. Somá-las faria um `media=4` ou um `obs=4` derrubar o teto de TESTE por um
+  motivo que não tem nada a ver com teste.
 - `.morph/framework/evals/trace-schema.md` — formato canônico do trace
 - `.morph/features/{feature}/2-plan/mandate.md` — critérios de done da feature
 - `.morph/features/{feature}/2-plan/spec.md` — arquitetura e contratos

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-stack-scan

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

@@ -4,7 +4,7 @@ description: Localiza um standard específico via busca server-side (morph-spec
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-standards

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

@@ -4,7 +4,7 @@ description: Conduz a fase opcional de UI/UX — design system, mockups, compone
 version: core
 when-to-invoke: ao tomar o ramo uiux (morph-spec advance --design), depois do Gate 1 e antes do morph-plan
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.0"
 ---
 
 # morph-uiux