@polymorphism-tech/morph-spec 8.20.0 → 8.22.0

package/framework/schemas/tasks.schema.json

@@ -39,7 +39,7 @@
           "standards": {
             "type": "array",
             "items": { "type": "string", "minLength": 1 },
-            "description": "Standards pinned by morph-plan for this task, as paths relative to the framework root (e.g. \"standards/backend/dotnet/vsa-handler-patterns.md\"). Optional. Part of the plan contract: frozen after Gate 2."
+            "description": "Standards pinned by morph-plan for this task, as PATHS relative to the framework root (e.g. \"standards/backend/dotnet/vsa-handler-patterns.md\"). Optional. Part of the plan contract: frozen after Gate 2. NOT the same vocabulary as agents.json's top-level `standards` field, which lists IDs (e.g. \"backend-dotnet-vsa-handler-patterns\", no slashes/extension) — same field name, different shape; do not treat one as the other."
           }
         },
         "additionalProperties": false

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "8.20.0"
+cliVersion: "8.22.0"
 stacks:
   - umbraco
 ---

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when-to-invoke: ao receber instrução "use /migrate-lp-to-umbraco {projeto}" do usuário, ou quando o usuário descrever necessidade de migrar uma LP para Umbraco
 user-invokable: true
-cliVersion: "8.20.0"
+cliVersion: "8.22.0"
 stacks:
   - umbraco
 ---

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-apply
@@ -208,21 +208,12 @@ Quando `getPendingTasks(data).length === 0`:
 - Invocar `Skill(morph-review)` para gerar `.morph/features/{feature}/4-review/review-report.md`.
 - A skill morph-review chama `morph-eval` em escopo de feature inteira.
 
-### 5. Gate 3 (trust-aware)
+### 5. Gate 3
 
-Rode `morph-spec gate-check {feature} review [--json]` — lê `trust`, decide via `shouldPauseGate` e persiste `gateDecisions.review` com timestamp server-side (shape canônico em `.morph/framework/schemas/feature.schema.json`), 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 score composto real). Passe o composto do `review-report.md` (avaliador independente) e qualquer violação que ele tenha encontrado via `--signals` — as únicas chaves que este comando aceita sobrescrever:
-```
-morph-spec gate-check {feature} review --signals '{"evalScore":9.2,"standardsViolations":[]}'
-```
-
-Risco que nenhuma dessas chaves representa (julgamento do avaliador que não vira `standardsViolations`): use `gate-decision` direto em vez de `gate-check`.
-
-**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.
-
-- Pause: `AskUserQuestion` com options `["aprovado, fechar feature", "preciso ajustar", "rollback"]`.
-- Auto: exibir summary do review-report, aprovar via `morph-spec approve {feature} review --mode auto`, e prosseguir.
+Apresentado e persistido por `morph-review` §8 (invocada no passo 4 acima) — gate-check, template
+fixo nomeando a feature, aprovação registrada pós-resposta. Ao retomar o controle dela, **NÃO
+re-apresente o gate**: siga direto para o encerramento (§6) conforme a decisão já persistida em
+`gateDecisions.review`.
 
 ### 6. Pós Gate 3 — encerramento
 
@@ -255,7 +246,7 @@ Risco que nenhuma dessas chaves representa (julgamento do avaliador que não vir
 - `framework/skills/core/morph-review/SKILL.md`
 - `framework/skills/core/morph-plan/SKILL.md` §5a — resolve e carimba `task.agent`/`task.standards` no plano; fonte primária deste §3b
 - `morph-spec dag {feature}` — análise de DAG e decisão sequencial vs paralelo (ponderada por effort), incluindo recomendação de isolamento (`isolation.recommended: "worktree"`)
-- `morph-spec verify {feature} [task] --json` — cadeia determinística build+testes+validadores (código antes do juiz)
+- `morph-spec verify {feature} [task] --json` — cadeia determinística build+testes+validadores+e2e (código antes do juiz)
 - `morph-spec score {feature} {task} {score} [--dims a,c,q,t]` — grava taskScores no feature.json com timestamp server-side
 - `morph-spec gate-check {feature} {gate} [--json]` — default: coleta sinais do disco, decide via `shouldPauseGate`, persiste `gateDecisions`
 - `morph-spec gate-decision {feature} {gate} --pause {bool} [--reason ...] [--signals ...]` — escape manual: risco que o `gate-check` não vê no disco (shape em `.morph/framework/schemas/feature.schema.json`)

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-brainstorming
@@ -147,6 +147,6 @@ options:
 
 ## Referências
 - `.morph/framework/MORPH.md` — seções 1 (Papéis), 2 (Fases), 5 (Gates), Trust Mode
-- `.morph/framework/standards/STANDARDS.json` — para referência de standards relevantes à stack
+- `morph-spec standards --find "<query>"` — para referência de standards relevantes à stack (ver `morph-standards`)
 - `framework/skills/core/morph-stack-scan/SKILL.md` — invocada na Parte 0 (varredura), antes de qualquer pergunta
 - `.morph/framework/MORPH.md` §5 — regras de pausa do Gate 1 (trust mode)

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # 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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-hotfix

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-implement

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-plan
@@ -84,10 +84,31 @@ Ao iniciar a fase plan — após o `proposal.md` ser aprovado e antes de qualque
 
 4. Produza `mandate.md` em `.morph/features/{feature}/2-plan/`:
    - Stack exata do projeto (leia de `.morph/config/config.json` → `project.stack` ou do CLAUDE.md).
-   - Standards obrigatórios: liste os IDs relevantes de `.morph/framework/standards/STANDARDS.json`.
+   - Standards obrigatórios: descubra-os com `morph-spec standards --find "<domínio/tecnologia>"` (top 3 `id · path · digest` — o digest decide) por domínio tocado; liste os IDs escolhidos.
    - Patterns proibidos — **copie por extenso no mandate.md** a lista canônica de `MORPH.md` § "Stack baked-in" (`Guid.NewGuid()`→`Guid.CreateVersion7()`, classes não-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, repository genérico `IRepository<T>`/`IUnitOfWork`, SQL cru sem justificativa) mais qualquer proibição específica da feature. Copie o texto completo — o mandate.md é lido por implementadores em contexto fresco, sem `MORPH.md` carregado, então um ponteiro sozinho não basta aqui.
    - Política de acesso a dados (registre no mandate): `ApplicationDbContext` injetado direto no slice — para CRUD e para queries específicas (joins, projeção, paginação). Para concorrência ou SQL específico, store dedicado hand-written com justificativa em `decisions.md`.
-   - **Features com agentes de IA (MAF):** se a feature envolve um agente (Microsoft Agent Framework), **use a tool Read** nos standards relevantes de `framework/standards/ai-agents/*.md` (ex.: `setup`, `agent-session`, `middleware-patterns`, `mcp-server`, `mcp-tools`, `multi-agent-patterns`, `production`) — filtre pelo que a feature exige via STANDARDS.json. Esses standards carregam as **convenções de projeto** (single-agent por padrão — Workflows só para fan-in/out real; provider, caching, observability, A2A) que uma fonte externa de docs (ex.: context7) não conhece. Padrão de divisão: **superfície da API** pode vir de docs ao vivo/context7 (mais frescas para um SDK em evolução), mas **as convenções vêm dos standards** — registre ambas no mandate. Não pule os `ai-agents/*.md` só porque o STANDARDS.json index lista que eles existem.
+   - **Features com agentes de IA (MAF):** se a feature envolve um agente (Microsoft Agent Framework), **use a tool Read** nos standards relevantes de `framework/standards/ai-agents/*.md` (ex.: `setup`, `agent-session`, `middleware-patterns`, `mcp-server`, `mcp-tools`, `multi-agent-patterns`, `production`) — filtre pelo que a feature exige via `morph-spec standards --find "<tema>" --category ai-agents`. Esses standards carregam as **convenções de projeto** (single-agent por padrão — Workflows só para fan-in/out real; provider, caching, observability, A2A) que uma fonte externa de docs (ex.: context7) não conhece. Padrão de divisão: **superfície da API** pode vir de docs ao vivo/context7 (mais frescas para um SDK em evolução), mas **as convenções vêm dos standards** — registre ambas no mandate. Não pule os `ai-agents/*.md` só porque o STANDARDS.json index lista que eles existem.
+   - **Verificação de runtime** — como se PROVA que a feature funciona rodando, não só compilando.
+     Compilar não é subir: um serviço injetado sem registro em `Program.cs` passa no build e derruba
+     a aplicação no startup. Registre no mandate:
+     - **Como o stack sobe:** o `docker compose` do projeto (`morph-spec e2e up {feature}`). Se o
+       projeto containeriza mas não tem compose, **isso é uma task** — sem ele o nó `e2e` do verify
+       reprova (não dispensa).
+     - **O que precisa ser exercitado:** os fluxos desta feature que o avaliador vai navegar, em
+       linguagem de comportamento — os mesmos verbos das pós-condições dos use cases.
+     - **Quais viram spec Playwright versionada:** caminho crítico e bug corrigido merecem regressão;
+       exploração pontual não. O critério vai aqui; escrever a spec é tarefa da implementação.
+     - **Base URL vinda do ambiente:** o harness dá a cada feature um bloco de portas próprio (para
+       duas worktrees não brigarem pela porta 3000), então o `playwright.config.ts` **não pode**
+       cravar a URL — leia `process.env.PLAYWRIGHT_BASE_URL ?? \`http://localhost:${process.env.PORT ?? 3000}\``
+       e faça o compose publicar `"${PORT:-3000}:3000"`. Config cravada = suíte batendo em porta
+       vazia e `ECONNREFUSED` com cara de app quebrada. 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
+       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.
+     - **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.
 
 5. Produza `tasks.json` em `.morph/features/{feature}/2-plan/` seguindo o schema em `.morph/framework/schemas/tasks.schema.json`.
@@ -199,7 +220,7 @@ Ao registrar a aprovação do Gate 2, atualize o frontmatter de cada use case de
 ## Referências
 
 - `.morph/framework/MORPH.md` — seções 2 (Fases), 3 (Contratos de Output), 5 (Gates), Trust Mode
-- `.morph/framework/standards/STANDARDS.json` — para identificar standards relevantes ao mandate
+- `morph-spec standards --find "<query>"` — para identificar standards relevantes ao mandate (o índice inteiro só como navegação exploratória; ver `morph-standards`)
 - `.morph/framework/agents.json` — personas por domínio; lido UMA VEZ no passo 5a para carimbar `agent`/`standards` por task
 - `.morph/framework/schemas/tasks.schema.json` — schema obrigatório de tasks.json
 - `.morph/specs/usecases/` — acervo permanente de use cases do projeto (leia antes de numerar; em `bug`, é onde mora o UC a corrigir)

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.20.0"
+cliVersion: "8.22.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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-review
@@ -43,12 +43,22 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      outro propósito. Falha aqui é bloqueante — quebra silenciosa em runtime, não em build.
 
 4. **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 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`).
+   - **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.
    - Gere o **diff da implementação** (`git diff` do range da feature, ou a lista de arquivos do recap.md com seus conteúdos atuais).
-   - Despache o subagent registrado `morph-evaluator` (gerado de `agents.json` — a persona do avaliador é o system prompt dele, com Read/Glob/Grep + Bash somente para verificação, sem Write/Edit), com contexto fresco:
+   - Despache o subagent registrado `morph-evaluator` (gerado de `agents.json` — a persona do avaliador é o system prompt dele, com Read/Glob/Grep + Bash somente para verificação + Playwright para navegar, sem Write/Edit), com contexto fresco:
      ```
      dispatch Agent (subagent_type: "morph-evaluator") with prompt:
        contexto: mandate.md + spec.md + diff da implementação + saída real dos testes
+                 + nó e2e do verify (stack no ar? em qual URL?)
        instrução: |
          Você NÃO participou da implementação — avalie o que está no diff,
          contra o mandate. Você tem Bash: use `morph-spec verify`, testes/build
@@ -56,6 +66,16 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          foi reportado, em vez de confiar cegamente. Aplique as rubricas em
          .morph/framework/evals/rubrics/ (architecture 30%, contracts 25%,
          code-quality 25%, test-coverage 20%) seguindo as bandas 0-10 de cada uma.
+         Se o nó e2e subiu o stack, NAVEGUE a aplicação com Playwright e
+         percorra os fluxos desta feature como um usuário faria — ler o diff
+         prova que o código existe, usar a aplicação prova que ela funciona.
+         Confira console e network atrás de erro que teste nenhum cobriu.
+         Registre no relatório o que você navegou e o que viu. Se um fluxo que
+         você exercitou merece virar regressão, RECOMENDE a spec Playwright —
+         recomendar é seu papel, escrever a spec não é.
+         NÃO suba nem derrube o stack por conta própria (`morph-spec e2e` e o
+         nó de verify fazem isso): stack que não sobe é achado de INFRA a
+         reportar, não defeito de implementação a pontuar.
          NÃO reescreva código. NÃO toque em tasks.json, feature.json nem no board
          de sessão — Bash é só para verificação, nunca para mudar estado.
          Contrato do relatório final: GRAVE seu relatório em
@@ -71,8 +91,9 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          contracts×0.25 + quality×0.25 + tests×0.20) gravado TAMBÉM como a
          linha literal `**Composite-Score:** {n.n}` (machine-readable — o
          `morph-spec gate-check` lê o score real daí em vez do proxy de
-         taskScores), e feedback priorizado (bloqueantes primeiro) para
-         qualquer dimensão < 9. Relatório ausente, oco, ou sem esses itens,
+         taskScores), feedback priorizado (bloqueantes primeiro) para
+         qualquer dimensão < 9, e — quando o stack estava no ar — o que você
+         navegou e o que observou. Relatório ausente, oco, ou sem esses itens,
          é 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).
@@ -87,6 +108,10 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      uma regra de negócio, e ainda dizendo `976/976` quando eram 982).
    - Scores por dimensão (arquitetura, contratos, qualidade, cobertura)
    - Score composto final
+   - **Verificação de runtime** — o resultado do nó `e2e` (`pass`/`fail`/`skip` + razão), e o que o
+     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.
    - 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
@@ -98,7 +123,8 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 
 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.
+8. Apresente o Gate 3 segundo trust mode — **única apresentação do gate**: `morph-apply` §5 aponta
+   para cá em vez de duplicar; ao devolver o controle a ela, o gate já está decidido.
 
    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.
 
@@ -109,7 +135,7 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 
    Julgamento do revisor que nenhuma dessas chaves representa: use `gate-decision` direto em vez de `gate-check`.
 
-   **Nunca edite `feature.json` à mão** (colide com o hook state-sync). Os caminhos acima gravam no mesmo lugar; o hook `gate-guard.js` confere depois se a ação bateu com a decisão persistida.
+   **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.
 
    **Se `pause === true`**, use `AskUserQuestion`:
 
@@ -129,6 +155,7 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 
    **Composite score:** {score}/10
    **Dimensões:** arquitetura={X} contratos={Y} qualidade={Z} cobertura={W}
+   **Runtime:** e2e={pass|skip} {razão, quando skip}
    **Bloqueantes:** {N (zero esperado em auto-aprovação)}
    **Recomendação:** Aprovado
    ```
@@ -146,7 +173,7 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 - Gate 3 registrado aprovado em `.morph/features/{feature}/feature.json` (autoritativo), na forma canônica `{ approved, timestamp, approvedBy }` — via `morph-spec approve` em auto, ou pelo hook state-sync no caminho manual
 
 ## Referências
-- `morph-spec verify {feature} [task] --json` — cadeia determinística build+testes+validadores anexada ao prompt do avaliador (passo 4)
+- `morph-spec verify {feature} [task] --json` — cadeia determinística build+testes+validadores+e2e anexada ao prompt do avaliador (passo 4)
 - `.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
 - `framework/skills/core/morph-eval/SKILL.md` — rubricas e bandas que o avaliador aplica

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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-stack-scan

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

@@ -1,17 +1,18 @@
 ---
 name: morph-standards
-description: Localiza e carrega um standard específico do STANDARDS.json sob demanda
+description: Localiza um standard específico via busca server-side (morph-spec standards --find) e carrega só o necessário
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "8.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-standards
 
 ## Objetivo
-Encontrar o standard certo para a situação atual e carregar apenas esse arquivo no contexto.
-Nunca carregue todos os standards — o custo de token não compensa.
+Encontrar o standard certo para a situação atual e carregar apenas o necessário no contexto.
+Nunca abra o `STANDARDS.json` inteiro (65 KB) — a busca server-side já devolve o suficiente
+para aplicar o standard na maioria dos casos.
 
 ## Quando invocar
 Quando durante a implementação surgir uma dúvida de padrão arquitetural, de contrato, de qualidade
@@ -19,21 +20,33 @@ ou de teste — e o mandate.md não for suficiente para resolver.
 
 ## O que fazer
 
-1. Abra `framework/standards/STANDARDS.json`.
+1. Rode a busca server-side — é O caminho, não uma opção entre várias:
+   ```
+   morph-spec standards --find "<domínio/tecnologia da task>" [--category <cat>] [--tags <a,b>] [--json]
+   ```
+   Devolve o **top 3** como `id · path · digest` — o `digest` é o texto completo do standard;
+   na maioria dos casos ele já basta para aplicar o padrão, sem abrir o `.md`.
 
-2. Filtre por `category` primeiro (valores típicos: "architecture", "contracts", "testing", "frontend", "backend").
+2. Se dois resultados parecerem relevantes e houver conflito, adote o mais específico ao stack
+   do projeto. Registre o conflito no `decisions.md` da feature.
 
-3. Dentro da categoria, filtre por `tags` que correspondam ao stack do projeto
-   (ex: "dotnet", "nextjs", "blazor", "typescript").
+3. Abra o arquivo `.md` do standard (campo `path`) só quando o `digest` não bastar para resolver
+   a dúvida — ex.: precisa de um exemplo de código completo ou de uma seção que o resumo não cobre.
 
-4. Se dois standards parecerem relevantes e houver conflito, adote o mais específico ao stack.
-   Registre o conflito no `decisions.md` da feature.
+4. Aplique o standard na tarefa atual.
 
-5. Leia o arquivo `.md` do standard selecionado — o path está no campo `path` do JSON.
+5. Registre no `recap.md`: qual standard foi consultado (via `--find`, ou navegação — item abaixo)
+   e como foi aplicado.
 
-6. Aplique o standard na tarefa atual.
+## Fallback — navegação exploratória
 
-7. Registre no `recap.md`: qual standard foi consultado e como foi aplicado.
+`--find` exige uma query. Quando a necessidade é genuinamente exploratória (ex.: "o que existe
+pra categoria X?", sem um termo de busca claro), nesta ordem:
+
+1. `morph-spec standards` sem `--find` — lista categorias + contagem, custo mínimo, o suficiente
+   pra decidir qual `--category` usar num `--find` em seguida.
+2. Só se isso não bastar, abra `framework/standards/STANDARDS.json` inteiro — último recurso,
+   nunca o primeiro passo.
 
 ## Quando não há standard adequado
 Registre no `decisions.md` que nenhum standard cobre o caso.
@@ -41,10 +54,11 @@ Descreva o critério adotado e sinalize para revisão futura.
 Não invente um standard — padrões não documentados são dívida técnica.
 
 ## Output esperado
-- Standard identificado e lido no contexto
+- Standard identificado (via `--find`/digest, ou `.md` completo quando necessário) no contexto
 - Critério de implementação claro para a tarefa atual
 - Entrada no recap.md registrando o standard consultado
 
 ## Referências
-- `framework/standards/STANDARDS.json` — índice completo com id, name, path, category, tags
+- `morph-spec standards --find "<query>" [--category] [--tags] [--json]` — busca server-side, top 3 `id · path · digest`
+- `framework/standards/STANDARDS.json` — índice completo; abrir só como fallback exploratório (ver acima)
 - `framework/MORPH.md` — seção 4 (Como consultar 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.20.0"
+cliVersion: "8.22.0"
 ---
 
 # morph-uiux
@@ -33,7 +33,7 @@ Ao tomar o ramo opcional uiux: feature/bug cuja mudança cria ou altera superfí
 
 3. **Despache `morph-ui-designer`** para o trabalho visual — dispatch é o default aqui (domínio diferente do Orchestrator, MORPH.md §6). `morph-ui-designer` tem `Read/Write/Edit/Glob/Grep` + MCPs `stitch`/`gemini-image`/`playwright`/`context7`, mas **não tem Bash** — não peça build, testes nem `morph-spec` a ele; isso é do orquestrador.
 
-   **Fallback — caminho normal fora de stack Next.js** (`ui-designer.stack = ["nextjs"]` em `agents.json`, então em qualquer outro stack o subagent não está registrado): `general-purpose` colando o campo `persona` (Read em `.morph/framework/agents.json`) no prompt, registrando o fallback no relatório. Isto não é uma exceção rara — é o caminho normal para projetos não-Next.js.
+   **Persona universal** (`ui-designer.stack = ["*"]` em `agents.json`, mesmo mecanismo de `evaluator`/`scout`): UI/UX importa sempre que há superfície de UI, então o subagent está registrado em **todo** projeto — .NET/Blazor incluído, não só Next.js. **Fallback** (caso raro: instalação anterior a essa mudança, `.claude/agents/morph-ui-designer.md` ainda não regenerado): `general-purpose` colando o campo `persona` (Read em `.morph/framework/agents.json`) no prompt, registrando o fallback no relatório — resolvido rodando `morph-spec setup-infra --reinstall`.
 
    Template do prompt (contrato do relatório em forma curta — copia o padrão de `morph-implement` §4, sem a cláusula de build/isolamento, que não se aplica a um agente sem Bash):
    ```
@@ -93,7 +93,7 @@ Ao tomar o ramo opcional uiux: feature/bug cuja mudança cria ou altera superfí
 
    Aguardar resposta. Se "preciso ajustar", aplicar e reapresentar.
 
-   **Divergência do hook state-sync — só neste gate:** ao contrário de Gate 1/2/3, o hook `state-sync.js` (`gateFromQuestion`) não reconhece o texto "Gate uiux" — uma resposta "aprovado" aqui **não** grava o gate sozinha. Depois do "aprovado", grave explicitamente:
+   **Hook state-sync reconhece este gate, como os demais.** Igual a Gate 1/2/3, o hook `state-sync.js` (`gateFromQuestion`) reconhece o texto "Gate uiux" — uma resposta "aprovado" ao template acima grava sozinha `approvalGates.uiux = { approved: true, timestamp, approvedBy: "manual" }` no `feature.json` autoritativo, atribuído pelo nome da feature que a pergunta cita (MORPH.md §5). Sem nome na pergunta, ou fora de `AskUserQuestion` (headless/CI): aprove explicitamente:
    ```
    morph-spec approve {feature} uiux --approver <quem respondeu>
    # ou, para já aprovar e criar 2-plan/ num passo só:

package/framework/templates/infrastructure/docker/docker-compose.template.yml

@@ -1,7 +1,19 @@
 # Docker Compose for Local Development
 # Next.js + Neon Stack
-
-version: '3.8'
+#
+# Ports come from variables with sane defaults so `morph-spec e2e up` can hand
+# each feature worktree its own port block (see env-allocator.js). Hardcode
+# "3000:3000" here and two features running side by side collide on the host,
+# no matter what the harness injects — the container names would be distinct
+# and the ports would not.
+#
+# Healthchecks are what make `up --wait` meaningful: without them Compose
+# reports "started" the moment the process launches, and the e2e node would
+# navigate an application that is not serving yet.
+#
+# The harness also exports PLAYWRIGHT_BASE_URL for the same allocated port, so
+# `playwright.config.ts` must read it instead of hardcoding a URL:
+#   baseURL: process.env.PLAYWRIGHT_BASE_URL ?? `http://localhost:${process.env.PORT ?? 3000}`
 
 services:
   # Next.js Application
@@ -11,7 +23,7 @@ services:
       dockerfile: Dockerfile.dev
     container_name: {{kebabCase FEATURE_NAME}}-app
     ports:
-      - "3000:3000"
+      - "${PORT:-3000}:3000"
     environment:
       - NODE_ENV=development
       - DATABASE_URL=${DATABASE_URL}
@@ -20,7 +32,14 @@ services:
       - /app/node_modules
       - /app/.next
     depends_on:
-      - postgres
+      postgres:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "node -e \"fetch('http://localhost:3000/').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))\""]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+      start_period: 20s
     networks:
       - app-network
 
@@ -30,7 +49,7 @@ services:
     container_name: {{kebabCase FEATURE_NAME}}-postgres
     restart: unless-stopped
     ports:
-      - "5432:5432"
+      - "${POSTGRES_PORT:-5432}:5432"
     environment:
       POSTGRES_USER: postgres
       POSTGRES_PASSWORD: postgres
@@ -38,6 +57,11 @@ services:
     volumes:
       - postgres-data:/var/lib/postgresql/data
       - ./migrations:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres -d {{snakeCase FEATURE_NAME}}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
     networks:
       - app-network
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "8.20.0",
+  "version": "8.22.0",
   "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",