@polymorphism-tech/morph-spec 8.47.0 → 9.0.0

package/framework/standards/ai-agents/evals-with-cache.md

@@ -228,8 +228,7 @@ Declare-o como um nó a mais em `project.tests[]` — não como uma estrutura pa
 
 | Quando | O que acontece |
 |---|---|
-| `verify {feature} {task}` (loop de task) | **pulado**, com motivo registrado — o relógio de uma task não paga uma suíte de eval |
-| `verify {feature}` (escopo de feature) | **roda**, offline, contra a cache commitada |
+| `verify {feature}` | **roda**, offline, contra a cache commitada |
 | miss de cache sem credencial | **reprova** nomeando o cenário, o caminho, o comando de regravação e o arquivo de credencial |
 | `--refresh-cache` | regrava a árvore contra o provider real. **Nunca implícito**: é uma chamada paga |
 

package/framework/standards/ai-agents/setup.md

@@ -3,7 +3,7 @@
 > **Scope:** stacks=["dotnet"]
 > **Layer:** 0 (lista da persona `maf-expert`; resumo injetado pela rule `ai-agents-standards` em `**/Agents/**`, `**/agents/**`, `**/*Agent*.cs`; texto completo sob demanda via `morph-spec standards --find`)
 > **Keywords:** maf setup, microsoft agents ai, chatclient, ai agent, agent framework, agent dotnet, AsAIAgent, responses api, chat completions, store false
-> **Read by Claude in:** plan (pra citar pacote em tasks.json) + implement (pra escrever .csproj e Program.cs)
+> **Read by Claude in:** plan (pra citar pacote no plan.md) + implement (pra escrever .csproj e Program.cs)
 
 **Verified against:** Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 + OpenAI 2.13.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs` (pipeline e escolha de protocolo). A superfície do SDK `OpenAI` e das pontes `Microsoft.Agents.AI.OpenAI` / `Microsoft.Extensions.AI.OpenAI` foi **medida por reflexão sobre as assemblies do pin** em 2026-09-08 — o ai-kit **não exercita** o cliente concreto da OpenAI — referencia o pacote no `.csproj`, mas não há `using OpenAI` em `src/` (medido 2026-09-08); ver a tabela "Dois níveis de garantia" no README do kit. Last-verified: 2026-09-08.
 

package/framework/standards/architecture/code-comments.md

@@ -41,10 +41,10 @@ Só o **porquê que o código não mostra**:
 
 ## O que não merece
 
-- **História de processo.** Task, UC, ADR, FR, Gate, avaliador, `spec.md`, mockup, "confirmado ao
-  implementar a T11", "o Gate 3 pediu". Isso vai na mensagem de commit e no `decisions.md`, onde tem
-  data e autor e não envelhece dentro do arquivo. Em teste, o elo com a pós-condição vai no **nome**
-  do teste (`P5_estado_do_lead_espelha_o_crm`, `DisplayName`), nunca em `// UC-672 P5`.
+- **História de processo.** Fatia, cenário, ADR, Gate, avaliador, `plan.md`, mockup, "confirmado ao
+  implementar a F2", "o Gate 3 pediu". Isso vai na mensagem de commit e no `plan.md`, onde tem
+  data e autor e não envelhece dentro do arquivo. Em teste, o elo com o cenário vai no **nome**
+  do teste (`C5_estado_do_lead_espelha_o_crm`, `DisplayName`), nunca em `// C5`.
 - **Repetição do código.** `// incrementa o contador` sobre `count++`, `// valida o request` sobre
   `validator.Validate(request)`. Nome bom substitui comentário.
 - **Doc-comment que repete a assinatura.** `/// <summary>Obtém o pedido.</summary>` sobre
@@ -70,12 +70,12 @@ comentado não é modelo: código novo segue este padrão, não a densidade do l
 ## Exemplo
 
 ```ts
-// Ruim: rotula, conta a task, repete o código e afirma comportamento que nenhum teste cobra.
+// Ruim: rotula, conta a fatia, repete o código e afirma comportamento que nenhum teste cobra.
 /**
  * Salva o documento.
  * @param doc o documento
  */
-// T8 + T11: mutação obrigatória do relatório, item c. Faz upsert e nunca duplica.
+// F2 + C3: mutação obrigatória do relatório, item c. Faz upsert e nunca duplica.
 async function save(doc: Doc) {
   await upsert({ key: doc.sourceId, hash: sha256(doc.body) });
 }

package/framework/standards/integration/mcp/mcp-tools.md

@@ -195,14 +195,14 @@ Fallback: WebSearch for library capabilities.
 
 | Tool | Use Case | Example |
 |------|----------|---------|
-| **GitHub CLI (`gh`)** | Create issues from tasks, link to milestone | `gh issue create` (Bash) |
+| **GitHub CLI (`gh`)** | Create issues from slices, link to milestone | `gh issue create` (Bash) |
 | **Context7** | Estimate complexity based on library docs | `mcp__context7__query-docs()` |
 
 ```bash
-# Create GitHub issues from tasks.json (if team uses GitHub Projects)
-# — one `gh issue create` per task, iterating tasks.json:
-gh issue create --title "T001: Create Entity Lead" \
-  --body "description + doneCriteria da task" \
+# Create GitHub issues from the plan's slices (if team uses GitHub Projects)
+# — one `gh issue create` per slice of .morph/features/{f}/2-plan/checks.json:
+gh issue create --title "F1: Create Entity Lead" \
+  --body "fatia F1 do plan.md + cenários que ela cobre" \
   --label "backend" --milestone "feature-x"
 ```
 
@@ -234,7 +234,7 @@ psql $(neonctl connection-string) -c "SELECT column_name, data_type FROM informa
 psql $(neonctl connection-string) -c "SELECT policyname, cmd, qual FROM pg_policies WHERE tablename = 'leads'"
 ```
 
-Look up the API while coding, then smoke test the deployed feature: the snapshot shows whether the page renders, the console messages catch JavaScript errors and failed API calls, and the screenshot goes to `recap.md`. Vercel covers deployment status, logs and environment variables.
+Look up the API while coding, then smoke test the deployed feature: the snapshot shows whether the page renders, the console messages catch JavaScript errors and failed API calls, and the screenshot goes to the slice report (`3-implement/reports/F{n}.md`). Vercel covers deployment status, logs and environment variables.
 
 ```javascript
 const docs = await mcp__context7__query-docs({
@@ -329,7 +329,7 @@ await mcp__playwright__browser_file_upload({ ref: "s1e20", paths: ["/path/to/fil
 | Implement (7) | Smoke test deployed features | `browser_navigate` + `browser_click` + `browser_snapshot` |
 | Implement (7) | Verify form flows end-to-end | `browser_fill_form` + `browser_click` + `browser_snapshot` |
 | Implement (7) | Check console errors after deploy | `browser_navigate` + `browser_console_messages` |
-| Implement (7) | Screenshot for recap.md | `browser_take_screenshot` |
+| Implement (7) | Screenshot for the slice report | `browser_take_screenshot` |
 
 ---
 

package/framework/templates/README.md

@@ -18,8 +18,7 @@ through the registry, and this README never repeats a path the registry already
 
 ```
 framework/templates/
-├── docs/              # Phase documents (proposal, spec, ui-*)
-├── feature/           # decisions.md, recap.md
+├── docs/              # plan.md (the plan's single source) and ui-mockups.md
 ├── context/           # ARCHITECTURE.md, design-system.md
 │
 ├── code/              # Code templates, by technology
@@ -38,7 +37,7 @@ framework/templates/
 ├── integrations/      # asaas-client, asaas-webhook, neon-auth-config
 ├── ui/                # design-system.css
 ├── meta-prompts/      # fusion, squad-leaders, validators
-├── examples/          # spec-examples.md, design-system-examples.md
+├── examples/          # design-system-examples.md
 └── REGISTRY.json      # template metadata — the index every consumer reads
 ```
 

package/framework/templates/REGISTRY.json

@@ -29,84 +29,18 @@
   ],
   "templates": [
     {
-      "id": "proposal",
+      "id": "plan",
       "kind": "template",
-      "name": "Feature Proposal",
-      "path": "docs/proposal.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "proposal",
-      "required": true,
-      "description": "Feature proposal with overview, problem statement, solution approach, and cost estimates",
-      "outputName": "proposal.md",
-      "placeholders": [
-        "AUTHOR",
-        "DATE",
-        "STACK"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "spec",
-      "kind": "template",
-      "name": "Technical Specification",
-      "path": "docs/spec.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "plan",
-      "required": true,
-      "description": "Detailed technical spec with architecture, data model, API contracts",
-      "outputName": "spec.md",
-      "placeholders": [
-        "DATE",
-        "FEATURE_NAME",
-        "STACK"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "decisions",
-      "kind": "template",
-      "name": "Architecture Decision Records",
-      "path": "feature/decisions.md",
+      "name": "Feature Plan",
+      "path": "docs/plan.md",
       "location": "framework",
       "category": "documentation",
       "phase": "plan",
       "required": true,
-      "description": "ADR format for documenting architectural decisions with context, alternatives, consequences",
-      "outputName": "decisions.md",
+      "description": "Single source of a feature: problem, scenarios (Cn with proof), decisions (ADRs), reuse, slices (Fn) and errata — parsed by morph-spec plan-check into checks.json",
+      "outputName": "plan.md",
       "placeholders": [
-        "DATE"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "recap",
-      "kind": "template",
-      "name": "Feature Recap",
-      "path": "feature/recap.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "implement",
-      "required": true,
-      "description": "Post-implementation summary with deliverables, metrics, lessons learned",
-      "outputName": "recap.md",
-      "placeholders": [
-        "DATE",
-        "FEATURE_NAME",
-        "STACK"
+        "FEATURE_NAME"
       ],
       "stackSpecific": false,
       "engine": "handlebars",
@@ -132,24 +66,6 @@
       "technology": "handlebars",
       "validatePlaceholders": true
     },
-    {
-      "id": "spec-examples",
-      "kind": "template",
-      "name": "Spec Examples",
-      "path": "examples/spec-examples.md",
-      "location": "framework",
-      "category": "examples",
-      "phase": null,
-      "required": false,
-      "description": "Example technical specs for reference",
-      "outputName": null,
-      "placeholders": [],
-      "stackSpecific": false,
-      "engine": null,
-      "deprecated": false,
-      "technology": null,
-      "validatePlaceholders": true
-    },
     {
       "id": "design-system-examples",
       "kind": "template",
@@ -614,71 +530,6 @@
       "technology": "handlebars",
       "validatePlaceholders": true
     },
-    {
-      "id": "ui-flows",
-      "kind": "template",
-      "name": "UI Flows",
-      "path": "docs/ui-flows.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "uiux",
-      "required": false,
-      "description": "User flows and interaction patterns with state diagrams and edge cases",
-      "outputName": "flows.md",
-      "placeholders": [
-        "DATE",
-        "FEATURE_NAME"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "ui-components",
-      "kind": "template",
-      "name": "UI Components",
-      "path": "docs/ui-components.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "uiux",
-      "required": false,
-      "description": "Component specifications mapping UI elements to shadcn/ui components with props and events",
-      "outputName": "components.md",
-      "placeholders": [
-        "DATE",
-        "FEATURE_NAME",
-        "STACK"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "ui-design-system",
-      "kind": "template",
-      "name": "UI Design System",
-      "path": "docs/ui-design-system.md",
-      "location": "framework",
-      "category": "documentation",
-      "phase": "uiux",
-      "required": false,
-      "description": "Design system documentation with color palette, typography, spacing, and semantic tokens",
-      "outputName": "design-system.md",
-      "placeholders": [
-        "DATE",
-        "FEATURE_NAME",
-        "PROJECT_NAME"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "technology": "handlebars",
-      "validatePlaceholders": true
-    },
     {
       "id": "github-workflow-dotnet-build",
       "kind": "template",
@@ -1460,21 +1311,6 @@
         "TIMESTAMP"
       ],
       "validatePlaceholders": true
-    },
-    {
-      "id": "tasks-template",
-      "kind": "template",
-      "consumption": "reference",
-      "name": "tasks.json",
-      "path": "tasks.template.json",
-      "category": "context",
-      "phase": null,
-      "outputName": null,
-      "description": "Initial tasks.json scaffold",
-      "engine": "handlebars",
-      "deprecated": false,
-      "placeholders": [],
-      "validatePlaceholders": true
     }
   ]
 }

package/framework/templates/docs/plan.md

@@ -0,0 +1,72 @@
+# Plano — {{FEATURE_NAME}}
+
+<!-- Fonte única da feature. `morph-spec plan-check {{FEATURE_NAME}}` lê este arquivo e grava 2-plan/checks.json.
+     Depois do gate plan, o corpo congela: fato errado sobre o código vai em ## Errata (append-only). -->
+
+## Problema
+
+<O que dói hoje, para quem, e como se percebe. Duas a cinco frases.>
+
+## Fora de escopo
+
+- <o que esta feature deliberadamente não faz>
+
+## Suposições não confirmadas
+
+- <o que foi assumido sem prova; "nenhuma" vale>
+
+## Cenários
+
+<!-- Um cenário por comportamento observável. `prova:` é teste | e2e | eval | manual.
+     Cenário que fala de arquivo, grep ou texto exige a linha "> Por que artefato:" logo abaixo. -->
+
+- **C1** — Dado <estado>, quando <ação>, então <resultado observável>.
+  prova: teste
+
+## Decisões
+
+### ADR-001 — <título>
+**Alcance:** feature
+
+<Contexto, decisão e consequência. `projeto` quando a decisão vale além desta feature.>
+
+### Conflitos com o acervo
+
+<!-- ADR do índice (.morph/specs/adrs/) que este plano contradiz: "nenhum", ou a tabela abaixo fora do bloco.
+     O finish aplica cada linha: total retira o ADR do índice; parcial o mantém com o escopo onde ainda vale.
+```
+| ADR | Mudança | Escopo em que o antigo ainda vale |
+|---|---|---|
+| {feature}/ADR-{nnn} | parcial | <onde o antigo ainda vale> |
+| {feature}/ADR-{nnn} | total | — |
+```
+-->
+
+nenhum
+
+## Arquitetura
+
+<Onde o código entra, o que conversa com o quê. Diagrama só se ajudar.>
+
+## Reuso
+
+| conceito | veredito | alvo | why |
+|---|---|---|---|
+| <conceito> | REUSAR | <arquivo ou símbolo existente> | |
+
+## Fatias
+
+<!-- Uma fatia = uma unidade de entrega (com ou sem dispatch), relatório em 3-implement/reports/Fn.md.
+     arquivos ≤ 8; superfície e depende são opcionais; toda Cn é coberta por alguma fatia. -->
+
+### F1 — <título>
+- persona: dotnet-senior
+- standards: <id>
+- arquivos: <caminho/a.cs>, <caminho/b.cs>
+- cobre: C1
+
+## Contrato de implementação
+
+<Assinaturas, records, enums e rotas que as fatias precisam honrar.>
+
+## Errata

package/framework/templates/dotnet/ai-kit/README.md

@@ -58,15 +58,7 @@ dotnet test  --solution Morph.AiKit.sln -c Release --no-build
 > do `morph-spec verify`); por isso nenhum chamador repassa a flag. Ao adicionar
 > testes, suba o piso — `test/framework/ai-kit-ci-packaging.test.js` reprova um
 > piso que ficou para trás da contagem de `[Fact]`/`[Theory]`.
-> **Consequência para o recorte por task:** `--minimum-expected-tests 1` na
-> linha de comando não sobrescreve o valor do projeto (medido: o recorte verde
-> sai 9 do mesmo jeito), mas a propriedade global do MSBuild sim. Por isso
-> `morph-spec verify {f} {task}` estreita este projeto repassando
-> `"-p:TestingPlatformCommandLineArguments=…"` com o valor do `.csproj` e o piso
-> em 1 — verde sai 0, zero testes segue saindo 8, nada recompila (issue #114).
-> Mantenha o piso **nesse** elemento, literal (sem `Condition`, sem `$(…)`, sem
-> outra declaração da propriedade em `Directory.Build.*`): em qualquer outra
-> forma o recorte volta a rodar o nó inteiro.
+
 
 > **`dotnet test` precisa rodar COM O CWD DENTRO deste diretório.** O opt-in do
 > Microsoft.Testing.Platform (que `xunit.v3` 4.x usa) vive em `global.json`, e o

package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Morph.AiKit.Tests.csproj

@@ -30,16 +30,6 @@
       de workflow. Uma unica verdade: nenhum chamador repassa a flag na linha de
       comando, porque repassa-la duplicaria a opcao.
 
-      Consequencia para o recorte por task (`morph-spec verify {f} {task}`): a
-      mesma opcao com valor 1 na linha de comando NAO sobrescreve o valor do
-      projeto (medido: o recorte verde sai 9 do mesmo jeito), mas a propriedade
-      global do MSBuild sim. O recorte estreita este projeto repassando
-      "-p:TestingPlatformCommandLineArguments=" com ESTE valor e o piso em 1
-      (issue #114: verde sai 0, zero testes segue saindo 8, nada recompila). Por
-      isso o piso fica NESTE elemento, literal: sem Condition, sem $(...), sem
-      outra declaracao da propriedade em Directory.Build.* — em qualquer outra
-      forma o recorte volta a rodar o no inteiro.
-
       O numero e o total de CASOS EXECUTADOS (275), nao de atributos nem de casos
       DESCOBERTOS (276): os [Theory] expandem, e um caso IGNORADO nao conta para o piso — a
       suite descobre 276 e executa 275, porque o semeador da cache exemplar de eval

package/framework/templates/meta-prompts/squad-leaders/backend-squad.md

@@ -78,7 +78,7 @@ Backend deliverables typically include:
 2. Create migrations before writing service logic
 3. Implement services with proper unit-testable interfaces
 4. Wire up API endpoints last (depends on services)
-5. After every 3 tasks, persist completed tasks to `tasks.json` (`status`/`outputs`/`notes` only) and run the checkpoint
+5. After every 3 slices, write each finished slice's report (`3-implement/reports/F{n}.md`) and run the checkpoint
 6. If blocked (compilation error, migration conflict), document and continue with next unblocked task
 
 ## Report Back When Done

package/framework/templates/meta-prompts/squad-leaders/frontend-squad.md

@@ -72,7 +72,7 @@ Frontend deliverables typically include:
 2. Build reusable sub-components before composing pages
 3. Wire up API calls/services last (after UI is structured)
 4. Test each component with loading + error + empty states
-5. After every 3 tasks, persist completed tasks to `tasks.json` (`status`/`outputs`/`notes` only) and run the checkpoint
+5. After every 3 slices, write each finished slice's report (`3-implement/reports/F{n}.md`) and run the checkpoint
 
 ## Report Back When Done
 Provide a summary of:

package/framework/templates/meta-prompts/squad-leaders/squad-leader.md

@@ -32,7 +32,7 @@ You are a **Squad Leader** in the MORPH-SPEC agent hierarchy.
 ## How to Work
 1. Read your standards carefully before starting
 2. Implement each task in order (respecting dependencies)
-3. After every 3 tasks, persist completed tasks to `tasks.json` (`status`/`outputs`/`notes` only) and run the checkpoint
+3. After every 3 slices, write each finished slice's report (`3-implement/reports/F{n}.md`) and run the checkpoint
 4. If blocked, document the blocker and continue with the next unblocked task
 5. Report completion with: files created, any blockers, checkpoint results
 

package/framework/templates/meta-prompts/validators/pre-commit-validator.md

@@ -46,11 +46,10 @@ If `.morph/framework/agents.json` is in staged files:
 - No duplicate agentIds
 - Valid tier values (1-4)
 
-### 4. Spec Format Validation (if spec.md staged)
-If any `spec.md` is staged:
-- Has required sections: Overview, Requirements, Technical Design, Data Model, API Contracts
+### 4. Plan Format Validation (if plan.md staged)
+If any `.morph/features/*/2-plan/plan.md` is staged:
+- `morph-spec plan-check <feature>` exits 0 (sections, scenarios with `prova:`, slices that cover them)
 - No placeholder text (`{{TODO}}`, `TBD`, `[PLACEHOLDER]`)
-- Word count > 200 (meaningful spec)
 
 ### 5. Stack-Specific Validation
 {{#if IS_CSHARP}}

package/package.json

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

package/src/commands/e2e/e2e.js

@@ -232,7 +232,7 @@ export async function e2eUpCommand(featureName, options = {}) {
 /**
  * Where the app actually landed.
  *
- * The reviewer hands this to the evaluator instead of letting it guess
+ * The orchestrator hands this to the verifier instead of letting it guess
  * `localhost:3000` — each feature owns a port block, so the default port is the
  * one address most likely to be wrong. Mirrors what `playwright.config.ts` is
  * asked to do, deliberately: one rule, two readers.
@@ -331,7 +331,7 @@ export async function e2eDownCommand(featureName, options = {}) {
     volumes: Boolean(options.volumes),
   });
   const stampDeleted = deleteStamp(ctx.gitCommonDir, ctx.projectName);
-  const cleanup = afterHeavyRun({ projectPath: ctx.cwd, config: readHeavyConfig(ctx.cwd), scope: 'e2e-down' });
+  const cleanup = afterHeavyRun({ projectPath: ctx.cwd, config: readHeavyConfig(ctx.cwd) });
 
   if (options.json) {
     console.log(JSON.stringify(