@polymorphism-tech/morph-spec 8.45.0 → 8.47.0

package/framework/rules/csharp-standards.md

@@ -8,11 +8,13 @@ stacks:
 
 # C# and .NET VSA Standards
 
-@.morph/framework/standards/architecture/vertical-slice/vertical-slice.md
-@.morph/framework/standards/backend/dotnet/vsa-handler-patterns.md
-@.morph/framework/standards/backend/dotnet/result-pattern.md
-@.morph/framework/standards/backend/dotnet/fluent-validation-vsa.md
-@.morph/framework/standards/backend/dotnet/scrutor.md
-@.morph/framework/standards/backend/dotnet/scalar-ui.md
-@.morph/framework/standards/backend/api/validation.md
-@.morph/framework/standards/architecture/code-comments.md
+- **architecture-vertical-slice-vertical-slice** (`architecture/vertical-slice/vertical-slice.md`) — Uma slice por operação em `Features/{Entity}Feature/{Verb}{Entity}/`: Request/Response `sealed record`, Handler, Validator e Endpoint `IApiEndpoint` `internal sealed`. Decorators Scrutor: Logging → Validation → Handler. PROIBIDO: MediatR/`IRequest`, AggregateRoot, DomainEvent, CQRS formal, camada Application Service, DTO compartilhado entre features, `IRepository<T>`/`IUnitOfWork`.
+- **backend-dotnet-vsa-handler-patterns** (`backend/dotnet/vsa-handler-patterns.md`) — Handler `sealed class` com primary constructor implementando `IHandler<TRequest, TResponse>` (não MediatR): injeta `ApplicationDbContext` direto, usa `Guid.CreateVersion7()` (nunca `Guid.NewGuid()`), passa `CancellationToken` em tudo e devolve `Result<T>`. Erros em `{Feature}Errors.cs`. SQL cru ou store dedicado só com justificativa em `decisions.md`.
+- **backend-dotnet-result-pattern** (`backend/dotnet/result-pattern.md`) — Falha esperada é `Result`/`Result<T>`, nunca exceção. Endpoint: `result.Match(value => Results.Ok(value), error => error.ToHttpResult())`; nunca leia `.Value` fora do `Match`. Status pelo `ErrorType` (Validation 400, NotFound 404, Conflict 409, Unauthorized 401, Forbidden 403, Unexpected 500), nunca BadRequest para tudo. PROIBIDO: try/catch no handler, retornar null, erro string sem código.
+- **backend-dotnet-fluent-validation-vsa** (`backend/dotnet/fluent-validation-vsa.md`) — Um `sealed AbstractValidator<TRequest>` (FluentValidation 12) por request, na pasta da slice; o `ValidationDecorator` roda antes do handler e devolve `Result.Failure(ValidationError)`. `AddValidatorsFromAssembly()` ANTES de `AddHandlersFromAssembly()`. Sempre `.WithMessage()`; tempo via `TimeProvider` lido DENTRO da regra. Nunca lance `ValidationException`.
+- **backend-dotnet-scrutor** (`backend/dotnet/scrutor.md`) — `AddHandlersFromAssembly` registra cada `IHandler<,>` como Scoped (filtro `!t.ContainsGenericParameters`) e depois `Decorate` Validation e então Logging (o último registrado é o mais externo). Endpoints `IApiEndpoint` via `TryAddEnumerable` Transient + `MapApiEndpoints`. Nunca registre handler um a um.
+- **backend-dotnet-scalar-ui** (`backend/dotnet/scalar-ui.md`) — Scalar no lugar do Swagger: `Microsoft.AspNetCore.OpenApi` 10.0.0 + `Scalar.AspNetCore` 2.12.40, nunca Swashbuckle. `MapOpenApi()` só em `IsDevelopment()` e antes de `MapScalarApiReference`. Todo endpoint com `.WithTags(ApiTags.X)` (constantes), `.Produces<T>` e `.ProducesProblem(status)` por falha possível.
+- **backend-api-validation** (`backend/api/validation.md`) — O validator checa só FORMA (sem DbContext); existência, unicidade e estado ficam no handler com `{Entity}Errors` tipados. Checagem de estado valida o INVÁLIDO (enum ordenado, estados de erro em 100+). PROIBIDO: lançar exceção, validar na lambda do endpoint, misturar DataAnnotations, `if (status != Expected)`, switch exaustivo sobre estados válidos.
+- **architecture-code-comments** (`architecture/code-comments.md`) — Padrão é nenhum comentário: renomeie, extraia, tipe ou teste antes. Só o porquê que o código não mostra (invariante, ordem, quirk externo com link), até ~3 linhas. PROIBIDO: história de processo (task, UC, ADR, Gate), repetir o código, XML doc/JSDoc que repete a assinatura, banner, `#region`, código comentado, TODO solto. O hook `comment-guard` bloqueia.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/data-standards.md

@@ -2,7 +2,6 @@
 paths:
   - "**/*Cache*.cs"
   - "**/*Redis*.cs"
-  - "**/*Cosmos*.cs"
   - "**/*Vector*.cs"
   - "**/*Embedding*.cs"
   - "**/*Rag*.cs"
@@ -12,7 +11,8 @@ stacks:
 
 # Data & Cache Standards
 
-@.morph/framework/standards/data/nosql/cache/redis.md
-@.morph/framework/standards/data/nosql/cosmos-db.md
-@.morph/framework/standards/data/vector-search/rag-chunking.md
-@.morph/framework/standards/backend/database/vector-search-rag.md
+- **data-nosql-cache-redis** (`data/nosql/cache/redis.md`) — Cache distribuído, nunca store primário. `Microsoft.Extensions.Caching.StackExchangeRedis` 10.0.12; `IConnectionMultiplexer` singleton LAZY (nunca conectar no registro). Cache-aside no handler com `IDistributedCache` (sem wrapper); invalide a chave exata depois do `SaveChangesAsync`. PROIBIDO: cachear segredo/PII sem criptografia, omitir TTL, engolir `RedisConnectionException`.
+- **data-vector-search-rag-chunking** (`data/vector-search/rag-chunking.md`) — Prosa: sentence-aware, 256 tokens; doc técnico: semântico por headers; Q&A inteiro; código: a função inteira. Overlap 10–20%, mínimo 50 e máximo ~512 tokens. Sempre grave metadados do chunk (DocumentId, ChunkIndex, Section, SourceUrl) e reindexe quando o hash do conteúdo mudar.
+- **backend-database-vector-search-rag** (`backend/database/vector-search-rag.md`) — Slices VSA sobre EF Core 10 + pgvector: o handler injeta `ApplicationDbContext` e `IEmbeddingGenerator` direto (sem EmbeddingService/SearchService). Busca por `d.Embedding!.CosineDistance(query)` com a distância em ordem ASC. Sem documento relevante, `NotFound` antes de chamar o LLM. Indexação em lote: um `GenerateAsync` e um `SaveChanges`.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/dotnet-templates.md

@@ -30,7 +30,7 @@ morph-spec scaffold dotnet book get-all-books
 
 Generates 7 files: endpoint, handler, request, response, validator + entity, errors (shared at feature level). Entity/errors auto-skipped if they already exist.
 
-**Only use `template render` for individual files when adding to an existing slice.**
+**Adding a single file to an existing slice:** read its `.hbs` template (table below) and write the file following it — `scaffold` generates whole slices only, and there is no single-file render command.
 
 ## VSA Feature Templates (Vertical Slice Architecture)
 

package/framework/rules/frontend-standards.md

@@ -9,5 +9,7 @@ stacks:
 
 # Frontend Standards
 
-@.morph/framework/standards/frontend/design-system/naming.md
-@.morph/framework/standards/frontend/design-system/animations.md
+- **frontend-design-system-naming** (`frontend/design-system/naming.md`) — BEM para componente reutilizável (`.card`, `.card__header`, `.card--featured`); prefixo de página para elemento específico (`.home-hero`). Custom properties em `:root` com namespace `--app-`. Estado por sufixo fixo: `--active`, `--disabled`, `--loading`, `--error`.
+- **frontend-design-system-animations** (`frontend/design-system/animations.md`) — Classes `.animate-*`, `.duration-fast/normal/slow`, `.stagger-1..10`. Lista escalonada exige `animation-delay` E `animation-fill-mode: backwards`. Sempre o bloco `prefers-reduced-motion: reduce`. Além do CSS: Motion (`motion/react`) para enter/exit/layout; GSAP só para ScrollTrigger, SVG morph e timelines.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/gsap-standards.md

@@ -1,13 +1,18 @@
 ---
 paths:
-  - "**/*.tsx"
-  - "**/*.ts"
+  - "**/animations/**"
+  - "**/*gsap*"
+  - "**/*Gsap*"
+  - "**/*scroll-trigger*"
+  - "**/*ScrollTrigger*"
 stacks:
   - nextjs
 ---
 
 # GSAP Animation Standards
 
-@.morph/framework/standards/frontend/gsap/gsap-core.md
-@.morph/framework/standards/frontend/gsap/gsap-scrolltrigger.md
-@.morph/framework/standards/frontend/gsap/gsap-plugins.md
+- **frontend-gsap-core** (`frontend/gsap/gsap-core.md`) — GSAP 3.13 + `@gsap/react` só para ScrollTrigger, SVG morph/draw, timelines complexas e SplitText; o resto é Motion, e NUNCA os dois no mesmo elemento. Código em `'use client'` dentro de `useGSAP()` com `{ scope: containerRef }` (nunca `useEffect`). Só transform/opacity; `prefers-reduced-motion` via `gsap.matchMedia()` é obrigatório; durations/easings vêm de `@/lib/design-tokens`.
+- **frontend-gsap-scrolltrigger** (`frontend/gsap/gsap-scrolltrigger.md`) — `gsap.registerPlugin(ScrollTrigger)` uma vez no init, nunca em `useEffect`/loop, e nunca `ScrollTrigger.create()` no escopo do módulo. Scrub com ease `'none'` (0.3–1 em produção). `pin: true` + `anticipatePin: 1`; nunca pin aninhado. `ScrollTrigger.batch` em grids de 20+. `ScrollTrigger.refresh()` após conteúdo dinâmico, troca de rota e `onLoad` de imagem.
+- **frontend-gsap-plugins** (`frontend/gsap/gsap-plugins.md`) — Todo plugin é gratuito no pacote público `gsap` (`npm install gsap @gsap/react`); o registry privado `@gsap/shockingly` é obsoleto. Flip: `getState()` → muda o DOM → `Flip.from(...)`. SplitText com `autoSplit: true`, animando em `onSplit`. MorphSVG exige `<path>`; DrawSVG exige stroke visível; Draggable com inércia exige InertiaPlugin.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/hangfire-standards.md

@@ -10,4 +10,6 @@ stacks:
 
 # Hangfire Background Jobs Standards
 
-@.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md
+- **backend-integrations-hangfire-hangfire-jobs** (`backend/integrations/hangfire/hangfire-jobs.md`) — Hangfire 1.8.25 só com razão real em `decisions.md`; o que cabe no request fica no handler. Storage `Hangfire.PostgreSql` 1.21.1 com `UseNpgsqlConnection` no endpoint DIRETO do Neon; referencie `Newtonsoft.Json` 13.0.4. Job é classe fina e idempotente que chama o handler; `[AutomaticRetry]`, sem try/catch nem retry manual. Dashboard exige Admin autenticado.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/infrastructure-standards.md

@@ -10,8 +10,10 @@ stacks:
 
 # Infrastructure Standards
 
-@.morph/framework/standards/infrastructure/docker/coolify-deploy.md
-@.morph/framework/standards/infrastructure/docker/local-compose-isolation.md
+- **infrastructure-docker-coolify-deploy** (`infrastructure/docker/coolify-deploy.md`) — Acesso só por SSH na VPS, API do Coolify em `localhost:8000/api/v1` com token server-side (nunca impresso). Env vars no Coolify, nunca no Dockerfile. Endpoint `/health`. Redeploy por `POST /api/v1/deploy?uuid=` (GET não deploya); sem `deployment_uuid` na resposta, nada foi deployado.
+- **infrastructure-docker-local-compose-isolation** (`infrastructure/docker/local-compose-isolation.md`) — Cada worktree roda o próprio stack compose; portas do bloco da worktree (`PORT`, `API_PORT`, `POSTGRES_PORT`, `REDIS_PORT`) publicadas como `${VAR:-default}:container`. PROIBIDO: porta fixa no host, `container_name`. Healthcheck em todo serviço. Compose que lê a porta por outro nome: declare em `e2e.portEnvNames`.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.
 
 ## Infrastructure Templates
 

package/framework/rules/morph-workflow.md

@@ -48,7 +48,7 @@ The full slash-command and CLI surface lives in the resident `.claude/CLAUDE.md`
 
 | Path | Notes |
 |------|-------|
-| `.morph/features/{feature}/feature.json` | **Authoritative + committed** feature state. Write it through the CLI (`create`, `score`, `gate-check`, `approve`) — a hand Edit collides with the `state-sync` hook |
+| `.morph/features/{feature}/feature.json` | **Authoritative + committed** feature state. Write it through the CLI (`create`, `gate-decision`, `gate-check`, `approve`) — a hand Edit collides with the `state-sync` hook |
 | `.morph/state.json` | **READ-ONLY** — thin, gitignored index rebuilt from `feature.json` on load; kept in sync by the `state-sync` hook |
 | `.morph/features/{feature}/{phase}/` | Feature outputs organized by phase |
 | `.morph/framework/` | **READ-ONLY** — framework files managed by morph-spec |
@@ -198,7 +198,7 @@ fix** — never a patch on the symptom. This is MANDATORY:
 1. Reproduce it and read the full error, not the first line.
 2. For a known .NET/Next.js error, run `/morph-troubleshoot <keywords>` first.
 3. One hypothesis at a time, each tested by the smallest check that could refute it.
-4. After three failed fixes, stop and question the design instead of trying a fourth.
+4. After three failed fixes, never try a fourth on your own: escalate via `AskUserQuestion` (accept / keep trying / skip), bringing the design question the failures raise — a fourth attempt with no new information repeats the error (same rule as MORPH.md §0).
 5. Confirm the fix with the same check that reproduced the bug; add a test only when no existing one covers that behavior.
 
 Everything else that a rule like this might list is owned by the flow itself, and duplicating it

package/framework/rules/neon-auth-standards.md

@@ -10,4 +10,6 @@ stacks:
 
 # Neon Auth Standards
 
-@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
+- **backend-integrations-neon-auth-neon-auth** (`backend/integrations/neon-auth/neon-auth.md`) — SDK `@neondatabase/auth`: `createNeonAuth()` no server, `createAuthClient()` no client, `auth.middleware()` com `runtime='nodejs'`. Duas constantes de prefixo (`BACKEND_API_PREFIX`/`PROXY_API_PREFIX`), nunca uma só. O front não consulta o Neon para dado de negócio. .NET: token EdDSA/Ed25519, verificado pelo JWKS com BouncyCastle + `SignatureValidator` devolvendo `JsonWebToken`.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/neon-standards.md

@@ -10,10 +10,12 @@ stacks:
 
 # Neon PostgreSQL Standards
 
-@.morph/framework/standards/infrastructure/neon/neon-setup.md
-@.morph/framework/standards/infrastructure/neon/neon-pgvector.md
-@.morph/framework/standards/infrastructure/neon/neon-pgrag.md
-@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
+- **infrastructure-neon-setup** (`infrastructure/neon/neon-setup.md`) — Duas connection strings: `DefaultConnection` (pooled `-pooler`) para a app e `MigrationConnection` (direta) para migrations e advisory locks; nunca commitadas (user-secrets / env do Coolify). Formato keyword (`Host=...;SSL Mode=Require`), não URI. `EnableRetryOnFailure(5, 10s)` por causa do scale-to-zero. Branch sempre com `--expires-at`.
+- **infrastructure-neon-pgvector** (`infrastructure/neon/neon-pgvector.md`) — `Npgsql.EntityFrameworkCore.PostgreSQL` 10.0.3 + `Pgvector.EntityFrameworkCore` 0.3.0; coluna `Vector` (`vector(1536)`) e `UseVector()` no `UseNpgsql`. SEMPRE índice HNSW com operator class casando a função LINQ (senão seq scan); distância em ordem ASC. PROIBIDO: DocumentRepository, SQL cru do C# sem `decisions.md`, default `gen_random_uuid()`.
+- **infrastructure-neon-pgrag** (`infrastructure/neon/neon-pgrag.md`) — A extensão `rag` é EXPERIMENTAL: protótipo e RAG só-SQL, não produção sem teste. Nunca misture modelos de embedding numa coluna (bge-small 384 × text-embedding-3-small 1536). Índice HNSW depois da carga inicial. Produção .NET com lógica própria: tool MAF tipada sobre pgvector.
+- **backend-integrations-neon-auth-neon-auth** (`backend/integrations/neon-auth/neon-auth.md`) — SDK `@neondatabase/auth`: `createNeonAuth()` no server, `createAuthClient()` no client, `auth.middleware()` com `runtime='nodejs'`. Duas constantes de prefixo (`BACKEND_API_PREFIX`/`PROXY_API_PREFIX`), nunca uma só. O front não consulta o Neon para dado de negócio. .NET: token EdDSA/Ed25519, verificado pelo JWKS com BouncyCastle + `SignatureValidator` devolvendo `JsonWebToken`.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.
 
 ## SQL Templates
 

package/framework/rules/nextjs-standards.md

@@ -8,14 +8,16 @@ stacks:
 
 # Next.js Standards
 
-@.morph/framework/standards/frontend/nextjs/naming-conventions.md
-@.morph/framework/standards/frontend/nextjs/project-structure.md
-@.morph/framework/standards/frontend/nextjs/app-router.md
-@.morph/framework/standards/frontend/nextjs/components.md
-@.morph/framework/standards/frontend/nextjs/data-fetching.md
-@.morph/framework/standards/frontend/nextjs/forms.md
-@.morph/framework/standards/frontend/nextjs/state-management.md
-@.morph/framework/standards/frontend/nextjs/testing.md
-@.morph/framework/standards/frontend/nextjs/nextjs-patterns.md
-@.morph/framework/standards/frontend/nextjs/motion-patterns.md
-@.morph/framework/standards/architecture/code-comments.md
+- **frontend-nextjs-naming-conventions** (`frontend/nextjs/naming-conventions.md`) — Arquivo SEMPRE kebab-case (`user-card.tsx`); export PascalCase para componente e `useX` para hook. Zod em `.schemas.ts`, tipos em `.types.ts` via `z.infer`. Named export (só `page.tsx` usa `default`). Nunca misture casos na mesma categoria.
+- **frontend-nextjs-project-structure** (`frontend/nextjs/project-structure.md`) — `src/app/` só roteia e importa de `features/`. Cada `src/features/{f}/` tem `components/`, `hooks/`, `types/` e `index.ts` como API pública (import de `@/features/users`, nunca deep path). NUNCA uma feature importa outra; `components/ui/` é shadcn e não se edita.
+- **frontend-nextjs-app-router** (`frontend/nextjs/app-router.md`) — Server Component por padrão; `'use client'` só para interação, browser API ou TanStack Query. Nunca fetch em `useEffect`. `loading.tsx`/`error.tsx` ao lado do `page.tsx` (`error.tsx` é client). Server Component chama o .NET com `BACKEND_API_PREFIX`; evite `route.ts`.
+- **frontend-nextjs-components** (`frontend/nextjs/components.md`) — `components/ui/` é saída do shadcn CLI (nunca editar; envolva em `components/`); `components/` sem regra de negócio e sem importar `features/`; `features/*/components/` conhece o domínio. Props tipadas e validadas com Zod, sempre com `className` opcional.
+- **frontend-nextjs-data-fetching** (`frontend/nextjs/data-fetching.md`) — Server Component com `BACKEND_API_PREFIX`; Client Component só pelo proxy same-origin com `PROXY_API_PREFIX`. TanStack Query 5 com key factory por feature e `invalidateQueries({ queryKey })`; toda resposta passa por Zod. PROIBIDO: `useEffect(() => fetch…)` e paginar/filtrar a coleção inteira no browser.
+- **frontend-nextjs-forms** (`frontend/nextjs/forms.md`) — react-hook-form + Zod (`zodResolver`) + Field do shadcn via `Controller`; tipo por `z.infer`; nunca `useState` por campo. Submit por `useMutation`, erro em `root`. Edição reusa o schema de criação (`.partial()`). Zod 4: `z.email()`.
+- **frontend-nextjs-state-management** (`frontend/nextjs/state-management.md`) — Estado de servidor no TanStack Query, nunca copiado para `useState`. Página, ordenação, filtros e aba ativa na URL (`searchParams`). Context só para tema, usuário ou locale. NUNCA Zustand/Redux antes de esgotar Server Components + TanStack Query.
+- **frontend-nextjs-testing** (`frontend/nextjs/testing.md`) — Vitest + Testing Library; MSW para API; Playwright para e2e. Teste comportamento, não implementação. Orçamento: um teste por pós-condição + um de regressão por bug; cenários do mesmo comportamento em `it.each`; nada de teste que só confere string de copy.
+- **frontend-nextjs-nextjs-patterns** (`frontend/nextjs/nextjs-patterns.md`) — Route Handler é BFF: `auth.getSession()` (401 sem sessão) e delega ao .NET; banco NUNCA em route handler. Zod no client e no server (`safeParse`, 400). `strict: true` + `noUncheckedIndexedAccess`; sem `any` em resposta de API. shadcn via `npx shadcn@latest add`.
+- **frontend-nextjs-motion-patterns** (`frontend/nextjs/motion-patterns.md`) — Motion via `motion/react` (nunca `framer-motion` junto). Variants em `motion/variants.ts` com durations/easings de `@/lib/design-tokens`. `useReducedMotion()` obrigatório; o `layout.tsx` raiz segue Server Component. 3–5 momentos de motion por página; cena guiada por scroll é do GSAP, nunca no mesmo elemento.
+- **architecture-code-comments** (`architecture/code-comments.md`) — Padrão é nenhum comentário: renomeie, extraia, tipe ou teste antes. Só o porquê que o código não mostra (invariante, ordem, quirk externo com link), até ~3 linhas. PROIBIDO: história de processo (task, UC, ADR, Gate), repetir o código, XML doc/JSDoc que repete a assinatura, banner, `#region`, código comentado, TODO solto. O hook `comment-guard` bloqueia.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/rules/nextjs-templates.md

@@ -27,7 +27,7 @@ morph-spec scaffold nextjs user-profile
 
 Generates 4 files: page (Server Component), list component, form component, TanStack Query hook.
 
-**Only use `template render` for individual files when modifying an existing feature.**
+**Adding a single file to an existing feature:** read its `.hbs` template (table below) and write the file following it — `scaffold` generates whole features only, and there is no single-file render command.
 
 | Template | Path | Purpose |
 |----------|------|---------|

package/framework/rules/resend-standards.md

@@ -9,4 +9,6 @@ stacks:
 
 # Resend Email Standards
 
-@.morph/framework/standards/backend/integrations/resend/resend-email.md
+- **backend-integrations-resend-resend-email** (`backend/integrations/resend/resend-email.md`) — REST API, não SMTP. Next: `resend` + React Email, um cliente em `lib/resend.ts`; .NET: pacote `Resend` com `AddHttpClient<ResendClient>()`. Envio sempre assíncrono (Hangfire), retry com Polly. Webhook Svix: verifique o corpo CRU com `resend.webhooks.verify()`, nunca HMAC na mão. Domínio verificado (SPF, DKIM, DMARC) antes do primeiro envio.
+
+> Resumo injetado quando você lê ou edita um arquivo casado por `paths:`. Texto completo: `morph-spec standards --find "<id>"` e leia só a seção necessária de `.morph/framework/standards/<path>`.

package/framework/schemas/config.schema.json

@@ -9,6 +9,10 @@
       "type": "object",
       "additionalProperties": true,
       "properties": {
+        "ci": {
+          "type": "boolean",
+          "description": "false turns `verify {f} --ci` into the local verify (with the reason printed). Absent or true: the Gate 3 proof comes from the GitHub Actions workflow that runs `morph-spec verify` (created on first use), whenever origin is GitHub and gh is authenticated."
+        },
         "tests": {
           "type": "array",
           "description": "One entry per test suite. Absent (not empty) means the four-step fallback of resolveTestPlan() decides — every project created before this key existed keeps working. An empty array is an explicit declaration of 'no test suites'.",

package/framework/schemas/feature.schema.json

@@ -90,7 +90,6 @@
             },
             "additionalProperties": false
           },
-          "score": { "type": ["number", "null"], "minimum": 0, "maximum": 10 },
           "attempts": { "type": "integer", "minimum": 1 },
           "updatedAt": { "type": "string", "format": "date-time" }
         },
@@ -118,7 +117,6 @@
               },
               "additionalProperties": false
             },
-            "score": { "type": ["number", "null"], "minimum": 0, "maximum": 10 },
             "attempts": { "type": "integer", "minimum": 1 },
             "updatedAt": { "type": "string", "format": "date-time" }
           },
@@ -152,7 +150,9 @@
         "e2eReason": { "type": ["string", "null"], "description": "The LITERAL reason the e2e node skipped (e2e-check.js's own wording), or null when it did not skip. risk-detector.js's classifyE2eSkip() reads it: 'project does not containerize' / 'does not touch runtime' are legitimate dispensations and pass; 'docker is not available' / 'requested' (--skip-e2e) / anything unclassifiable — null included — are an absence of proof and pause Gate 3. A skip recorded WITHOUT a reason is refused on purpose: a nameless dispensation is a silent no-op." },
         "sha": { "type": ["string", "null"], "description": "HEAD commit SHA at verify time (git rev-parse HEAD); null when not in a git repo or no commits yet." },
         "ts": { "type": "string", "format": "date-time", "description": "Server-side timestamp, same instant as the corresponding verifications/taskVerifications entry's updatedAt." },
-        "scope": { "type": "string", "description": "'feature', or 'task:<id>' for a task-scoped verify. READ BY THE GATE, not just audit: this stamp is singular and any verify overwrites it, so a 'task:<id>' value at ship time means the last verify was NOT the feature's. risk-detector.js therefore accepts an e2e dispensation ('project'/'scope' in e2eReason) only from scope === 'feature' — a `morph-spec verify {f} {task}` of a task whose group does not touch runtime stamps exactly the legitimate-sounding reason that would otherwise buy Gate 3 for the whole feature (the last task of a feature is typically group: docs). Absent/unknown falls on the safe side, like an unclassifiable reason." }
+        "scope": { "type": "string", "description": "'feature', or 'task:<id>' for a task-scoped verify. READ BY THE GATE, not just audit: this stamp is singular and any verify overwrites it, so a 'task:<id>' value at ship time means the last verify was NOT the feature's. risk-detector.js therefore accepts an e2e dispensation ('project'/'scope' in e2eReason) only from scope === 'feature' — a `morph-spec verify {f} {task}` of a task whose group does not touch runtime stamps exactly the legitimate-sounding reason that would otherwise buy Gate 3 for the whole feature (the last task of a feature is typically group: docs). Absent/unknown falls on the safe side, like an unclassifiable reason." },
+        "source": { "type": "string", "enum": ["ci"], "description": "Present only when the stamp came from `verify --ci`: the verify --json the project CI uploaded for the pushed commit, judged by the same rules as a local run. Absent = local run." },
+        "ciRun": { "type": "string", "description": "URL of the CI run whose artifact wrote this stamp (with source: ci). `sha` is that run's headSha, so verificationStale compares the code CI saw with HEAD." }
       },
       "additionalProperties": false
     },
@@ -234,7 +234,7 @@
         "approved": { "type": "boolean" },
         "timestamp": { "type": ["string", "null"], "description": "ISO timestamp of the approval/revocation, null while never evaluated." },
         "approvedBy": { "type": ["string", "null"], "description": "\"auto\" (approve/advance --mode auto), \"manual\" (human in the loop), \"policy:{workType}\" (gate stamped at birth by `morph-spec create` per the work type's skippedGates — see src/core/work-types.js; the gate-guard hook only special-cases \"auto\", so policy-stamped gates stay silent to it), a --approver name, or null while never evaluated." },
-        "selfAssessed": { "type": "boolean", "description": "Gate `review` SOMENTE. `true` quando o Gate 3 foi aprovado sem `4-review/evaluator-report.md`, via `morph-spec approve <f> review --self-assessed`. O score composto deveria vir do avaliador independente; esta flag registra a degradação em vez de deixá-la silenciosa, e aparece no `morph-spec list`." }
+        "selfAssessed": { "type": "boolean", "description": "Gate `review` SOMENTE. `true` quando o Gate 3 foi aprovado sem `4-review/evaluator-report.md`, via `morph-spec approve <f> review --self-assessed`. O veredito deveria vir do avaliador independente; esta flag registra a degradação em vez de deixá-la silenciosa, e aparece no `morph-spec list`." }
       },
       "additionalProperties": true
     }

package/framework/skills/README.md

@@ -16,7 +16,7 @@ These are the only skills the harness needs. MORPH.md references them by path.
 | `morph-stack-scan`    | Detect stack drift in existing projects, report in stack-scan.md     | yes            |
 | `morph-plan`          | Produce use cases + spec.md + tasks.json (Gate 2)                   | yes            |
 | `morph-implement`     | Execute each task with standard + persona, auto-advance between tasks| no             |
-| `morph-review`        | Final review report with scores + recommendation (Gate 3)            | yes            |
+| `morph-review`        | Final review report with SHIP/FIX verdict (Gate 3)                   | yes            |
 | `morph-standards`     | Locate and load a specific standard on demand                        | no             |
 
 The legacy `level-0-meta/` and `level-1-workflows/` skill trees were removed

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

@@ -2,9 +2,9 @@
 name: create-umbraco-lp
 description: Guia a criação de uma landing page nova ponta-a-ponta a partir do template MORPH_Umbraco_LP_Template (Umbraco 17 + Next.js): coleta decisões, scaffolda, sobe e valida, customiza branding e módulos, e entrega checklist final.
 version: core
-when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
-user-invokable: true
-cliVersion: "8.45.0"
+when_to_use: Use quando for iniciar um novo projeto de LP com o template Umbraco genérico
+user-invocable: true
+cliVersion: "8.47.0"
 stacks:
   - umbraco
 ---

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

@@ -2,9 +2,9 @@
 name: migrate-lp-to-umbraco
 description: Migra uma landing page existente (React/Vite, Next.js estático ou HTML) para o template Umbraco-headless MORPH_Umbraco_LP_Template entregando a LP EXATAMENTE igual à origem (mesmo CSS, imagens, fontes e comportamento) + Umbraco por cima — obtenção automática do template, inventário de seções, lift-and-rewire verbatim de cada seção para módulo editável, conexão do formulário ao backend de leads e gate de paridade determinístico. Repo-agnóstica: roda em qualquer lugar, sem template nem origem pré-baixados.
 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.45.0"
+when_to_use: Use quando o usuário pedir "use /migrate-lp-to-umbraco {projeto}" ou descrever a necessidade de migrar uma LP para Umbraco
+user-invocable: true
+cliVersion: "8.47.0"
 stacks:
   - umbraco
 ---

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

@@ -2,9 +2,9 @@
 name: morph-apply
 description: Orquestra a execução autônoma de tasks de uma feature morph-spec. Analisa DAG de dependências em tasks.json e decide adaptativamente entre execução sequencial (auto-advance) ou paralela (Agent dispatch). Termina com morph-review e Gate 3.
 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.45.0"
+when_to_use: Use quando chegar a instrução "use /morph-apply" ou "implementar feature" com o Gate 2 aprovado
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-apply

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

@@ -2,9 +2,9 @@
 name: morph-brainstorming
 description: Entende o negócio, os usuários e a arquitetura antes de qualquer planejamento técnico. Varre o ambiente primeiro, monta a árvore de decisões abertas e abre com a escolha de modo de descoberta (entrevista uma-pergunta-por-vez ou automático). Para projetos existentes, detecta desvios de stack e propõe plano de compliance.
 version: core
-when-to-invoke: ao receber um novo request de feature, antes de morph-plan
-user-invokable: true
-cliVersion: "8.45.0"
+when_to_use: Use quando chegar um novo request de feature, antes de morph-plan
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-brainstorming

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

@@ -2,9 +2,9 @@
 name: morph-hotfix
 description: ADW cirúrgico de hotfix — resolve uma queda/bug crítico de produção com prioridade máxima em velocidade, com aprovação humana obrigatória antes do ship.
 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.45.0"
+when_to_use: Use quando chegar "/morph-hotfix {feature}", quando a morph-proposal classificar o pedido como workType hotfix (Passo 0), ou quando o usuário disser "produção caiu / hotfix / urgente" a respeito de um incidente
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # 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 8 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`; nunca mutar código de produção para ver teste falhar.
+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 cole as 8 cláusulas do contrato de implementador (`morph-implement` §4 / `morph-apply` §3b) — commit `wip`, orçamento de teste e limite de tasks não se aplicam a quem não escreve. O prompt dele diz só: não escreve nem reverte nada, e o mapa é a mensagem final (Observado/Inferido, no contrato de citação que a persona já carrega). Você grava o mapa.
 
 **Audite o mapa antes do brief.** Grave a resposta do scout em `.morph/features/{feature}/2-plan/scout-map.md` e rode `morph-spec scout-check .morph/features/{feature}/2-plan/scout-map.md --json`. Exit ≠ 0 → descarte o mapa e re-despache o scout **uma** vez com as `failures` no prompt (o mapa novo abre com o motivo); na segunda reprovação, faça você o grep do root cause e siga. Root cause e blast radius que entram no brief se conferem com grep próprio mesmo com o mapa aprovado: sob pressão de hotfix, citação inventada vira um segundo incidente.
 

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

@@ -2,9 +2,9 @@
 name: morph-implement
 description: Guia a execução de cada tarefa de implementação com standard e persona adequados
 version: core
-when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
-user-invokable: false
-cliVersion: "8.45.0"
+when_to_use: Use quando for iniciar cada task de implementação listada em tasks.json
+user-invocable: false
+cliVersion: "8.47.0"
 ---
 
 # morph-implement

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

@@ -2,9 +2,9 @@
 name: morph-machine
 description: Cuida da RAM e da CPU da máquina enquanto o morph-spec trabalha — fila de builds e testes pesados (heavy), processos órfãos, worktrees de sub-agent que sobram. Invoque quando a máquina ou o editor estiver lento ou sem RAM, quando um comando voltar "⏳ não rodou" ou sair com exit 3 (fila cheia), quando sobrar agent-* em worktrees/, ou antes de despachar vários sub-agents que compilam ou testam em paralelo.
 version: core
-when-to-invoke: quando a máquina está lenta ou sem RAM, um comando pesado esperou ou foi recusado pela fila, sobrou worktree de sub-agent, ou vários sub-agents pesados vão rodar em paralelo
-user-invokable: false
-cliVersion: "8.45.0"
+when_to_use: Use quando a máquina estiver lenta ou sem RAM, um comando pesado esperou ou foi recusado pela fila, sobrou worktree de sub-agent, ou vários sub-agents pesados vão rodar em paralelo
+user-invocable: false
+cliVersion: "8.47.0"
 ---
 
 # morph-machine

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

@@ -2,9 +2,9 @@
 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.45.0"
+when_to_use: Use quando a tarefa for PRODUZIR imagem ou vídeo por IA (catálogo, marketing, asset de LP) e alguém precisar decidir modelo, prompt e aprovação
+user-invocable: true
+cliVersion: "8.47.0"
 stacks:
   - dotnet
   - nextjs

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

@@ -2,9 +2,9 @@
 name: morph-plan
 description: Guia a produção dos artefatos de planejamento de uma feature (use cases, spec.md, tasks.json) e apresenta o Gate 2 trust-aware.
 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.45.0"
+when_to_use: Use quando a fase plan de uma feature começar, após o Gate 1 (proposal aprovado)
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-plan

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

@@ -2,9 +2,9 @@
 name: morph-proposal
 description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encadeia morph-brainstorming (Gate 1) e morph-plan (Gate 2). Em trust:auto pula gates sem sinais de risco.
 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.45.0"
+when_to_use: Use quando o usuário pedir "use /morph-proposal" ou ao iniciar uma nova feature
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-proposal

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

@@ -2,9 +2,9 @@
 name: morph-review
 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.45.0"
+when_to_use: Use quando a fase review começar, depois que todas as tasks de tasks.json estiverem com status `done`
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-review
@@ -37,16 +37,28 @@ Fase review, com todas as tasks `done` e o `recap.md` em dia. Normalmente chamad
    - `evaluator.partial: true` (`PARCIAL` na 1ª linha): ver "PARCIAL" no passo 4.
    - Ausente ou sem veredito: siga para o passo 3.
 
-3. **Prova da suíte — uma rodada, sua.** Rode `morph-spec verify {feature} --json` **depois da
-   última task** (o `gate-check` pausa o ship se o último stamp é de escopo `task:{id}`).
-   **Sem `--filter`, sempre**: `verify {feature}` **nunca recorta**, e um verify filtrado não persiste o
+3. **Prova da suíte — uma rodada, no CI.** Depois da última task, commite o trabalho da feature na
+   branch (`git add <paths>` + `git commit`: o CI só vê commits) e rode
+   `morph-spec verify {feature} --ci --json` com `run_in_background`. Ele empurra `morph/{feature}`,
+   cria o workflow `morph-verify.yml` se o projeto não tem um, espera o run e grava o stamp do JSON que
+   o run publicou. Sem CI (sem GitHub, sem `gh`, `project.ci: false`) ele mesmo roda o verify local e
+   diz por quê. **Quando a saída mostrar `CI rodando`, despache o avaliador (passo 4) sem esperar o
+   fim**: o workflow e o push já estão commitados, então a foto `--before-eval` não os acusa como
+   mutação, e a suíte corre no CI em paralelo. Saiu `verify local`: espere o fim antes do passo 4 —
+   suíte local e `mutate` disputam a máquina. Exit 2 = trabalho fora de commit; exit 3 (`pending`/`busy`)
+   não é vermelho (ver Ritmo). Rode-a só depois da última task: o `gate-check` pausa o ship se o
+   último stamp é de escopo `task:{id}`. **Sem `--filter`, sempre**: `verify {feature}` **nunca recorta**, e um verify filtrado não persiste o
    stamp. Se o JSON vier com `repeatOf`, nada mudou desde a rodada anterior — use aquela. Esta é a
    única execução de testes do Gate 3: o avaliador não roda a suíte de novo.
-   - Nó `e2e`: `pass` → passe a URL ao avaliador (`morph-spec e2e status {feature} --json` →
-     `baseUrl`). `fail` → volte à correção. `skip` → quem classifica é o `gate-check`
-     (`classifyE2eSkip`, em `risk-detector.js`): dispensa de projeto/escopo passa; ambiente,
-     `--skip-e2e` ou razão desconhecida pausam sozinhos. Diga ao avaliador que a app não foi exercida.
-   - `traceability.warnings`: repasse ao avaliador como sinal, não bloqueio.
+   - Nó `e2e`: `pass` local → passe a URL ao avaliador (`morph-spec e2e status {feature} --json` →
+     `baseUrl`); `pass` no CI → a app foi exercida lá, não há stack local para navegar. `fail` →
+     correção (vermelho no CI: `gh run view <id> --log-failed`, impresso pelo verify). Vermelho por
+     config que só existe na máquina (`.env`, appsettings, connection string, secret) não é defeito do
+     código: pergunte ao usuário entre declarar o secret + `env:` no `morph-verify.yml` ou `project.ci: false`. `skip` → quem
+     classifica é o `gate-check` (`classifyE2eSkip`, em `risk-detector.js`): dispensa de projeto/escopo
+     passa; ambiente, `--skip-e2e` ou razão desconhecida pausam sozinhos.
+   - Vermelho com o avaliador ainda rodando: não mexa na árvore até ele voltar (passo 4); corrija junto
+     com os bloqueadores dele. `traceability.warnings` entram no review-report como sinal, não bloqueio.
 
 4. **Despache o avaliador independente** (`morph-evaluator`, contexto fresco, sem Write/Edit).
    - Tire a foto da árvore e escolha o modelo: `morph-spec report-check {feature} --before-eval --json`.
@@ -57,14 +69,14 @@ Fase review, com todas as tasks `done` e o `recap.md` em dia. Normalmente chamad
      review-report. Numa worktree com grafo stale, `morph-spec graph refresh` antes.
    ```
    dispatch Agent (subagent_type: "morph-evaluator", model: {evaluatorModel.model}) with prompt:
-     contexto: use cases + spec.md + diff da feature + JSON do verify (nós, e2e, URL)
+     contexto: use cases + spec.md + diff da feature + JSON do verify se já terminou (nós, e2e, URL)
                + blast radius + 1-design/mockups.md (se existir) + 3-implement/evidencias/*.md (se existir)
      instrução: |
        Siga .morph/framework/evals/review-checklist.md e grave
        .morph/features/{feature}/4-review/evaluator-report.md ANTES de encerrar — o arquivo é o
        retorno; não chame SendMessage. Se o arquivo já existir quando você começar, é resíduo de
        outra tentativa: não o leia antes de escrever o seu (ancoragem no veredito alheio).
-       A suíte já rodou (JSON acima): você NÃO roda verify, build nem testes. Bash é para ler
+       A suíte roda fora de você (JSON acima, ou o CI em curso): você NÃO roda verify, build nem testes. Bash é para ler
        (git diff/log/show, grep, morph-spec graph) e para no máximo UMA rodada de
        `morph-spec mutate {feature}` (até 3 mutantes com `expect`), só quando o checklist pede.
        Nada em segundo plano, nada de laço de espera. NUNCA `git checkout --`: descarta trabalho
@@ -80,8 +92,9 @@ Fase review, com todas as tasks `done` e o `recap.md` em dia. Normalmente chamad
    - `tree.sinceBeforeEval.changed` vazio e `tree.markers` vazio = árvore como antes do dispatch.
      Arquivo listado = mutação que ficou no disco: `morph-spec mutate --restore` devolve os bytes do
      snapshot conferindo md5; fora de uma rodada de mutação, desfaça linha a linha pelo diff.
-     **NUNCA `git checkout -- src/` aqui**: na árvore de
-     uma feature em review não existe nenhum commit da feature, e o checkout apaga o trabalho junto.
+     **NUNCA `git checkout -- src/` aqui**: o checkout apaga junto tudo o que não foi commitado depois
+     da prova (correção de bloqueador, trabalho de outra sessão), e no verify local a feature pode nem
+     ter commit.
    - `tree.sinceBeforeEval` `null` = sem foto; `tree` `null` = git não respondeu, nada foi conferido.
    - Não rode build/teste enquanto o agente está `running`.
 
@@ -91,8 +104,8 @@ Fase review, com todas as tasks `done` e o `recap.md` em dia. Normalmente chamad
    MESMO avaliador por `SendMessage`, colando `tree.dirty` e `tree.commits` no recado. Só se o id não
    retomar, despache um novo.
 
-5. **Bloqueadores.** `**Verdict:** FIX` ou bloqueador aberto: corrija (loop da `morph-apply`), rode o
-   verify de novo e **confirme só os bloqueadores** retomando o MESMO avaliador por `SendMessage`
+5. **Bloqueadores.** `**Verdict:** FIX` ou bloqueador aberto: corrija (loop da `morph-apply`), commite, rode o
+   `verify {feature} --ci` de novo e **confirme só os bloqueadores** retomando o MESMO avaliador por `SendMessage`
    (com `tree.dirty`/`tree.commits` e uma foto `--before-eval` nova). Ele não reavalia a feature
    inteira, e **nota nunca motiva nova rodada**. Avaliador encerrado: despache um novo dizendo que
    é uma confirmação dos bloqueadores Bn — o relatório é append-only e vale o último `**Verdict:**`.

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

@@ -2,9 +2,9 @@
 name: morph-stack-scan
 description: Varre o codebase existente, detecta stack atual, compara com o stack padrão e registra desvios em stack-scan.md
 version: core
-when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
-user-invokable: true
-cliVersion: "8.45.0"
+when_to_use: Use quando uma feature começar em projeto brownfield (codebase já existente)
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-stack-scan

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

@@ -2,16 +2,16 @@
 name: morph-standards
 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.45.0"
+when_to_use: Use quando precisar consultar um standard específico durante a implementação
+user-invocable: true
+cliVersion: "8.47.0"
 ---
 
 # morph-standards
 
 ## Objetivo
 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
+Nunca abra o `STANDARDS.json` inteiro (mais de 150 KB) — a busca server-side já devolve o suficiente
 para aplicar o standard na maioria dos casos.
 
 ## Quando invocar
@@ -24,8 +24,8 @@ ou de teste — e o `spec.md` e os standards da task não bastarem para resolver
    ```
    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`.
+   Devolve o **top 3** como `id · path · digest` — o `digest` é um resumo do standard (~700 chars),
+   não o texto completo; na maioria dos casos ele já basta para aplicar o padrão, sem abrir o `.md`.
 
 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.