@polymorphism-tech/morph-spec 8.34.2 → 8.35.1

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

@@ -4,7 +4,7 @@ description: Orquestra a execução autônoma de tasks de uma feature morph-spec
 version: core
 when-to-invoke: após Gate 2 aprovado, ao receber instrução "use /morph-apply" ou "implementar feature"
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.1"
 ---
 
 # morph-apply
@@ -96,7 +96,10 @@ while (true):
       aplicar feedback priorizado da tentativa anterior ao código já implementado
 
     // CÓDIGO ANTES DO JUIZ — barreira determinística e barata (build+testes+validadores).
-    run: morph-spec verify {feature} {task.id} --json
+    // Loop por task: --filter com os ids das suítes do stack que a task tocou
+    // (o relógio de uma task não paga a suíte inteira). Sem project.tests[]
+    // declarado há um nó só (`default`) e o --filter não tem o que escolher.
+    run: morph-spec verify {feature} {task.id} [--filter {ids-do-stack-da-task}] --json
     if verify.status == 'fail':
       // vermelho: feedback determinístico direto ao loop, SEM gastar o juiz LLM.
       feedback = verify.feedback   // usado como input do próximo attempt
@@ -125,7 +128,9 @@ while (true):
     options: [aceitar (marca done com ressalva no recap), continuar tentando (+3 tentativas), pular task (marca blocked)]
 ```
 
-> **Verify vermelho consome uma tentativa** do loop (≤3) e devolve `feedback[]` acionável (erros de build, falhas de teste, issues de validador). O `morph-eval` NUNCA é invocado sobre código que não passou no verify — o juiz julga arquitetura/contratos/qualidade, o que o código determinístico não pega sozinho. Código roda antes, grátis; o juiz gasta tokens só no que sobra.
+> **Loop por task filtra; Gate 3 e CI não.** `--filter {ids}` roda só as suítes do stack que a task tocou — os outros nós **aparecem** em `nodes.tests.runs[]` como `skip` nomeando o filtro, em vez de sumir, e um `--filter` que não casa nada é erro de uso (exit 2), nunca um verde. A verificação pós-batch e a do Gate 3 (`morph-spec verify {feature} --json`) rodam **sem filtro**: a prova que o avaliador lê tem de cobrir todos os nós, e o CI idem. Forma de `project.tests[]` e a tabela da divisão: `.morph/framework/CLI.md`, seção "Suítes de teste".
+>
+> **Verify vermelho consome uma tentativa** do loop (≤3) e devolve `feedback[]` acionável (erros de build, falhas de teste — linhas prefixadas por `[tests/{id}]`, que nomeiam a suíte —, issues de validador). O `morph-eval` NUNCA é invocado sobre código que não passou no verify — o juiz julga arquitetura/contratos/qualidade, o que o código determinístico não pega sozinho. Código roda antes, grátis; o juiz gasta tokens só no que sobra.
 
 > **Retry sem re-invoke — e a exceção que evita rodar sem a skill.** `skillLoaded` cai de volta para `false` (forçando reinvocação no próximo attempt) se houver `/compact` OU troca de sessão (nova sessão retomando via `handoff.md`) entre a última invocação e o attempt corrente — os dois eventos podem descartar o conteúdo da skill do seu contexto sem avisar. Sem essa exceção, um retry pós-compact aplicaria feedback sem o mandate/standard/persona carregados. Fora desses dois casos, reinvocar a Skill só para aplicar um feedback pontual é exatamente o custo repetido (~13KB por tentativa) que este corte existe para eliminar.
 >
@@ -178,18 +183,34 @@ dispatch Agent (subagent_type: "morph-{id}") with prompt:
          último ato antes do relatório; reporte a branch — nunca faça merge nem
          toque na árvore principal.
 
+    4. ESCOPO: no máximo 3 tasks e ~4 arquivos por dispatch. Escopo maior falha e
+       volta — fatie antes, não depois.
+    5. SOBREVIVÊNCIA: commite `wip({taskId})` ao fim de cada task. Se você parar no
+       limite de turnos, é o commit que preserva o trabalho — sem ele, a retomada
+       recomeça do zero.
+    6. PROCESSOS: NUNCA `taskkill /IM node.exe` (derruba os MCPs de todas as
+       sessões). Encerre dev server pelo PID que você mesmo subiu.
+    7. RETORNO: o relatório no arquivo canônico é o retorno. `SendMessage` não é
+       substituto do relatório e não deve ser chamado.
+
     Seu relatório final deve conter APENAS: (1) o que foi feito em 2-3
     frases, (2) arquivos modificados, (3) problemas encontrados e como foram
     resolvidos, (4) auto-score 0-10 com justificativa em uma linha. Relatório
     ausente, oco, ou sem os 4 itens, é falha de protocolo.
 ```
 
-> Este template é deliberadamente paritário com o template sequencial em `morph-implement` §4: ambos despacham o **subagent registrado do domínio (`morph-{id}`)** com standard escopado e as **mesmas 3 cláusulas curtas** do contrato do relatório final e os mesmos 4 itens de relatório — racional completo em `MORPH.md` §6. A única diferença é que aqui múltiplos agentes rodam ao mesmo tempo, um por fluxo independente.
+> **Passo pós-dispatch (do orquestrador, antes de avaliar qualquer relatório):** ao retomar o
+> controle, rode `git status --porcelain src/` e `grep -rn "MUTACAO" src/`. Um sub-agent morto no
+> meio deixa o disco a meio caminho — e um relatório lido sobre uma árvore que ninguém conferiu
+> avalia um estado que ninguém quis. Árvore inesperadamente suja é falha de protocolo: registre no
+> recap antes de pontuar.
+
+> Este template é deliberadamente paritário com o template sequencial em `morph-implement` §4: ambos despacham o **subagent registrado do domínio (`morph-{id}`)** com standard escopado e as **mesmas 7 cláusulas** do contrato do relatório final (as 3 do relatório + escopo, sobrevivência, processos e retorno) e os mesmos 4 itens de relatório — racional completo em `MORPH.md` §6. A única diferença é que aqui múltiplos agentes rodam ao mesmo tempo, um por fluxo independente.
 
 > **Alternativa quando os fluxos tocam os mesmos projetos/arquivos** (ex.: o mesmo csproj de testes compartilhado): siga a §3b-w abaixo em vez desta seção — despache com `isolation: "worktree"`, cada agente trabalha numa working tree própria e o orquestrador integra ao final.
 
 Aguardar todos os agentes terminarem, depois **auditar os relatórios contra o trabalho** com `morph-spec report-check {feature} --json` — determinístico e independente da palavra dos agentes; é o passo que pega tanto o relatório ausente quanto o `report-stale` (completo, porém gravado antes do fim do trabalho: o agente relatou cedo e continuou escrevendo). Em `report-stale`, **não re-despache** — leia o campo `observed` (writes reais do `events.jsonl`) e atualize o relatório a partir dele. Vereditos e ações: `MORPH.md` §6. Em seguida **ler** `.morph/features/{feature}/3-implement/reports/{taskId}.md` de cada task — é o valor de retorno autoritativo; a mensagem de texto do dispatch, se chegou inteira, é só um atalho que economiza essa leitura. Depois, sequencialmente:
-- **Rodar `morph-spec verify {feature} --json` uma única vez, pós-batch** (escopo feature) — os agentes não a rodaram (cláusula 3). Vermelho: use `verify.feedback` para corrigir/redespachar ANTES de qualquer morph-eval. (Com isolamento por worktree, cada agente já rodou o verify dentro do seu worktree; o orquestrador roda o verify compartilhado UMA vez após o merge — ver §3b-w.)
+- **Rodar `morph-spec verify {feature} --json` uma única vez, pós-batch** (escopo feature, **sem `--filter`**) — os agentes não a rodaram (cláusula 3). Vermelho: use `verify.feedback` para corrigir/redespachar ANTES de qualquer morph-eval. (Com isolamento por worktree, cada agente já rodou o verify dentro do seu worktree; o orquestrador roda o verify compartilhado UMA vez após o merge — ver §3b-w.)
 - Para cada relatório retornado:
   - Aplicar `Skill(morph-eval)`.
   - Gravar o score: `morph-spec score {feature} {taskId} {score} --dims {a},{c},{q},{t}`.

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

@@ -4,7 +4,7 @@ description: Entende o negócio, os usuários e a arquitetura antes de qualquer
 version: core
 when-to-invoke: ao receber um novo request de feature, antes de morph-plan
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.1"
 ---
 
 # morph-brainstorming

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

@@ -4,7 +4,7 @@ description: Avalia a qualidade de uma tarefa ou fase com rubricas graduadas 0-1
 version: core
 when-to-invoke: ao completar uma tarefa ou ao finalizar uma fase de implementação
 user-invokable: false
-cliVersion: "8.34.2"
+cliVersion: "8.35.1"
 ---
 
 # morph-eval

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

@@ -4,7 +4,7 @@ description: ADW cirúrgico de hotfix — resolve uma queda/bug crítico de prod
 version: core
 when-to-invoke: ao receber "/morph-hotfix {feature}", quando a morph-proposal classifica o pedido como workType hotfix (Passo 0), ou o usuário diz "produção caiu / hotfix / urgente"
 user-invokable: true
-cliVersion: "8.34.2"
+cliVersion: "8.35.1"
 ---
 
 # morph-hotfix
@@ -43,7 +43,7 @@ subagent_type: "morph-scout"
 
 **Fallback** (se `morph-scout` não estiver registrado nos subagent types deste projeto): `general-purpose` com o campo `persona` do agente `scout` colado no prompt, **registrando o fallback nas notes da task**.
 
-Peça ao scout: localizar o root cause provável, os arquivos afetados e o blast radius (o que mais pode quebrar). Ele é read-only (Read/Glob/Grep/Bash somente-leitura) — não escreve código. Inclua as 3 cláusulas do contrato do relatório final no prompt (template literal em `morph-implement` §4 / `morph-apply` §3b): ato final = o relatório é a última mensagem de texto, sem `SendMessage`; não tocar `tasks.json`/`feature.json`/`state.json` nem o board de sessão; sem build/test da suíte compartilhada em batch paralelo.
+Peça ao scout: localizar o root cause provável, os arquivos afetados e o blast radius (o que mais pode quebrar). Ele é read-only (Read/Glob/Grep/Bash somente-leitura) — não escreve código. Inclua as 7 cláusulas do contrato do relatório final no prompt (template literal em `morph-implement` §4 / `morph-apply` §3b): relatório no arquivo canônico como retorno, sem `SendMessage`; não tocar `tasks.json`/`feature.json`/`state.json` nem o board de sessão; sem build/test da suíte compartilhada em batch paralelo; no máximo 3 tasks por dispatch; commit `wip({taskId})` ao fim de cada task; nunca `taskkill /IM node.exe`.
 
 ### 3. Hotfix brief (`0-proposal/proposal.md`)
 

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

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "8.34.2"
+cliVersion: "8.35.1"
 ---
 
 # morph-implement
@@ -87,12 +87,28 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
       Worktree não commitado NÃO é removido pelo hook e vira pendência do
       `doctor`; o commit é o que torna o seu trabalho integrável.
 
+   4. ESCOPO: no máximo 3 tasks e ~4 arquivos por dispatch. Escopo maior falha e
+      volta — fatie antes, não depois.
+   5. SOBREVIVÊNCIA: commite `wip({taskId})` ao fim de cada task. Se você parar no
+      limite de turnos, é o commit que preserva o trabalho — sem ele, a retomada
+      recomeça do zero.
+   6. PROCESSOS: NUNCA `taskkill /IM node.exe` (derruba os MCPs de todas as
+      sessões). Encerre dev server pelo PID que você mesmo subiu.
+   7. RETORNO: o relatório no arquivo canônico é o retorno. `SendMessage` não é
+      substituto do relatório e não deve ser chamado.
+
    Seu relatório (no arquivo, e na mensagem final quando ela chega) deve conter
    APENAS: (1) o que foi feito em 2-3 frases, (2) arquivos modificados,
    (3) problemas encontrados e como foram resolvidos, (4) auto-score 0-10 com
    justificativa em uma linha. Relatório ausente, oco, ou sem os 4 itens, é
    falha de protocolo.
    ```
+   **Passo pós-dispatch (seu, antes de avaliar o relatório):** rode `git status --porcelain src/`
+   e `grep -rn "MUTACAO" src/` ao retomar o controle. Um sub-agent morto no meio deixa o disco a
+   meio caminho — e um relatório lido sobre uma árvore que ninguém conferiu avalia um estado que
+   ninguém quis. Árvore inesperadamente suja é falha de protocolo: registre no recap antes de
+   pontuar.
+
    Após o retorno do dispatch: **leia primeiro** `.morph/features/{feature}/3-implement/reports/[ID].md`
    — é o valor de retorno autoritativo. Trate a mensagem de texto do sub-agent, se chegou inteira,
    como um atalho que economiza essa leitura — nunca como a única fonte. Arquivo ausente é falha de
@@ -181,7 +197,7 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
    > tasks.json + recap.md + `taskScores` do feature.json. **NÃO escreva o trace
    > manualmente** — a escrita manual foi removida da cerimônia por task.
 
-9. Quando invocada por `morph-apply`, retornar o controle à skill orquestradora — ela decide qual task vem em seguida via `getReadyTasks(data)`. Não rode a suíte de testes inteira do projeto por conta própria ao fim da task quando invocada pela `morph-apply` — a verificação determinística (`morph-spec verify {feature} {task}`) é do orquestrador, logo após seu retorno (ver morph-apply §3a). Quando invocada manualmente, verificar se há próxima task ready e iniciá-la imediatamente aplicando esta skill desde o passo 1 (auto-advance). Pause apenas se encontrar ambiguidade bloqueante não coberta pelo mandate.
+9. Quando invocada por `morph-apply`, retornar o controle à skill orquestradora — ela decide qual task vem em seguida via `getReadyTasks(data)`. Não rode a suíte de testes inteira do projeto por conta própria ao fim da task quando invocada pela `morph-apply` — a verificação determinística (`morph-spec verify {feature} {task} [--filter {ids-do-stack-da-task}]`) é do orquestrador, logo após seu retorno (ver morph-apply §3a). **A divisão:** no loop por task o `--filter` escolhe as suítes do stack que a task tocou (o relógio de uma task não paga a suíte inteira; um nó não casado aparece como `skip` nomeando o filtro, e um filtro que não casa nada é erro de uso, exit 2); a suíte **inteira** roda no Gate 3 e no CI, sem filtro. A suíte completa de um projeto grande não cabe numa invocação de Bash do harness — rode em background ou por partes, nunca "suba o limite" (não há constante de timeout global no CLI). Detalhe e forma de `project.tests[]`: `.morph/framework/CLI.md`, seção "Suítes de teste". Quando invocada manualmente, verificar se há próxima task ready e iniciá-la imediatamente aplicando esta skill desde o passo 1 (auto-advance). Pause apenas se encontrar ambiguidade bloqueante não coberta pelo mandate.
 
 ## Output esperado
 - Código implementado conforme o standard consultado (direto ou via sub-agent)

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.1"
+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.1"
 ---
 
 # 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.1"
 ---
 
 # morph-proposal