@polymorphism-tech/morph-spec 8.0.0 → 8.1.0

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 8.0.0  
+**Version:** 8.1.0  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -394,4 +394,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v8.0.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v8.1.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "8.0.0",
+  "version": "8.1.0",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -237,4 +237,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v8.0.0 by Polymorphism Tech*
+*morph-spec v8.1.0 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -256,4 +256,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v8.0.0 by Polymorphism Tech*
+*morph-spec v8.1.0 by Polymorphism Tech*

package/framework/CLAUDE.md

@@ -25,7 +25,7 @@ Se não houver feature ativa, pergunte ao usuário qual feature trabalhar.
 - Apresentar gates com o template fixo definido em MORPH.md / morph-plan.
 - Registrar decisões não triviais em `decisions.md`.
 - Aplicar `morph-eval` após cada tarefa; silêncio em score ≥ 9 é o sinal correto. Score < 9 dispara o loop de correção autônomo (re-implementa, sem pausa), não escala ao humano entre tarefas. No Gate 3, o score composto da feature vem do **avaliador independente** despachado pela `morph-review` (persona `evaluator`, contexto fresco) — nunca de auto-avaliação de quem implementou.
-- Incluir as 3 cláusulas de protocolo em todo dispatch de sub-agent (**ato final = relatório via `SendMessage` para `main` como a ÚLTIMA tool call, encerrando imediatamente depois — zero texto extra, zero "aguardando confirmação"** — última mensagem em texto não chega ao orquestrador; não tocar tasks.json/feature.json/board; sem build/test da suíte compartilhada em batch paralelo) — templates com exemplo literal em `morph-implement` §4 e `morph-apply` §3b. O hook `subagent-report-guard` bloqueia uma vez o encerramento de subagent despachado sem SendMessage. **Ao consumir o relatório, libere a sessão do sub-agent com `TaskStop`** — não deixe o idle-detector do harness ser o único a encerrá-la.
+- Incluir as 3 cláusulas do contrato do relatório final em todo dispatch de sub-agent (**ato final = o relatório é a ÚLTIMA MENSAGEM DE TEXTO do sub-agent, com os 4 itens obrigatórios (o quê / arquivos / problemas / auto-score 0-10) — ela é o valor de retorno e chega inteira ao orquestrador; não chamar `SendMessage`, que gera um evento a mais e custa um turno inútil**; não tocar tasks.json/feature.json/board; sem build/test da suíte compartilhada em batch paralelo) — templates em `morph-implement` §4 e `morph-apply` §3b.
 
 ## Slash commands
 

package/framework/MORPH.md

@@ -250,7 +250,7 @@ Inline (sem dispatch) é aceitável para tasks curtas (effort S/M) **dentro do d
 
 **Mecanismo de dispatch:** os agents de domínio são subagents **registrados** (`.claude/agents/morph-{id}.md`, gerados de `agents.json` — a fonte única — na instalação). Despache com `subagent_type: "morph-{id}"` (ex.: `morph-dotnet-senior`): a persona é o **system prompt** do subagent, com tools, model e MCPs definidos por domínio no próprio `agents.json` (ex.: `context7` para docs vivas nos implementadores; Stitch/Gemini/Playwright no `morph-ui-designer`; o `morph-evaluator` é read-only). **Fallback** quando o tipo não está registrado (stack não instalado neste projeto): `general-purpose` com o campo `persona` de `agents.json` colado no prompt, **registrado nas `notes` da task**. O `**Persona:**` do recap registra sempre o mecanismo real usado — nunca uma auto-declaração.
 
-**Persona de estágio — scout:** além das personas de domínio, existe o `morph-scout` (read-only: Read/Glob/Grep/Bash somente-leitura). Despache-o quando precisar de um mapa do território sem contaminar a thread principal — obrigatoriamente no início de um hotfix (localizar root cause + blast radius) e opcionalmente antes do plan de uma feature grande (buscar código, docs e specs anteriores relevantes). Ele devolve um mapa curto via SendMessage e encerra; não escreve código.
+**Persona de estágio — scout:** além das personas de domínio, existe o `morph-scout` (read-only: Read/Glob/Grep/Bash somente-leitura). Despache-o quando precisar de um mapa do território sem contaminar a thread principal — obrigatoriamente no início de um hotfix (localizar root cause + blast radius) e opcionalmente antes do plan de uma feature grande (buscar código, docs e specs anteriores relevantes). Ele devolve um mapa curto como relatório final e encerra; não escreve código.
 
 **O que passar ao sub-agent:**
 - Especificação da tarefa (do tasks.json)
@@ -269,10 +269,10 @@ Inline (sem dispatch) é aceitável para tasks curtas (effort S/M) **dentro do d
 - Problemas encontrados e como foram resolvidos
 - Auto-score 0-10 com justificativa em uma linha
 
-**Protocolo obrigatório do sub-agent** (cláusulas que todo prompt de dispatch inclui — ver templates em `morph-implement` §4 e `morph-apply` §3b):
-1. **ATO FINAL: enviar o relatório completo via `SendMessage` para `main` como a ÚLTIMA tool call do turno, e encerrar IMEDIATAMENTE depois** — a última mensagem em texto NÃO chega ao orquestrador; só SendMessage chega. Zero texto adicional, zero nova tool call, zero "aguardando confirmação" depois do SendMessage: é o encerramento, não um passo intermediário. Terminar idle sem SendMessage, ou continuar agindo depois dele, é **falha de protocolo**: o hook `subagent-report-guard` bloqueia o encerramento uma vez com a instrução, e a cobrança do orquestrador via SendMessage é apenas o fallback (registrada como falha no recap). Os templates trazem o exemplo literal da chamada.
+**Contrato do relatório final** (cláusulas que todo prompt de dispatch inclui — ver templates em `morph-implement` §4 e `morph-apply` §3b):
+1. **ATO FINAL: o seu relatório é a sua ÚLTIMA MENSAGEM DE TEXTO** — ela é o valor de retorno do sub-agent e chega inteira ao orquestrador. **Não chame `SendMessage`**: ele gera um evento a mais (o teammate-message) além da notificação de término, custando um turno inútil ao orquestrador. Conteúdo obrigatório: (1) o que foi feito em 2-3 frases, (2) arquivos modificados, (3) problemas encontrados e como foram resolvidos, (4) auto-score 0-10 com justificativa em uma linha. Relatório oco ou sem os 4 itens é **falha de protocolo** — registrada no recap.
 2. Não tocar em `tasks.json`, `feature.json`, `state.json` nem no board de sessão (TaskCreate/TaskUpdate) — todo estado é gravado exclusivamente pelo orquestrador.
-3. **Verificação em batch paralelo — condicional ao isolamento:** em batch **sem isolamento** (agentes na mesma working tree), não rode build/test da suíte compartilhada — a verificação (`morph-spec verify`) é do orquestrador, uma vez, pós-batch. Em batch **com `isolation: "worktree"`** (quando o `morph-spec dag` recomenda, por colisão de `outputs` entre fluxos), a regra se inverte: rode build/test **dentro do seu worktree**, commite o trabalho na branch do worktree como penúltimo ato (antes do SendMessage), reporte a branch + status de build, e **nunca** faça merge nem toque na árvore principal — a integração é do orquestrador.
+3. **Verificação em batch paralelo — condicional ao isolamento:** em batch **sem isolamento** (agentes na mesma working tree), não rode build/test da suíte compartilhada — a verificação (`morph-spec verify`) é do orquestrador, uma vez, pós-batch. Em batch **com `isolation: "worktree"`** (quando o `morph-spec dag` recomenda, por colisão de `outputs` entre fluxos), a regra se inverte: rode build/test **dentro do seu worktree**, commite o trabalho na branch do worktree como último ato antes do relatório, reporte a branch + status de build, e **nunca** faça merge nem toque na árvore principal — a integração é do orquestrador.
 
 O sub-agent deve ser autossuficiente com o que você passou. Se precisar de mais contexto para começar, a tarefa não estava bem especificada — refine antes de despachar.
 
@@ -281,7 +281,7 @@ O sub-agent deve ser autossuficiente com o que você passou. Se precisar de mais
 - Quando o feedback do sub-agent precisaria ser discutido em tempo real — dispatch é assíncrono.
 - Quando a tarefa envolve mudanças de arquitetura que o Orchestrator precisa validar antes de executar.
 
-**Após receber o retorno do sub-agent:** leia o auto-score — ele é **triagem, não aprovação**. Se for < 7, re-despache com o feedback específico (ou corrija inline) antes de avaliar. Em qualquer caso, a task só avança quando `morph-eval` der score ≥ 9 (a barra única do §0); integre o resultado ao recap.md e siga para a próxima tarefa. **Libere a sessão do sub-agent imediatamente ao consumir o relatório** — `TaskStop(task_id: <id/nome retornado pelo dispatch>)`, tratando falha (agente já finalizado sozinho) como não-fatal — não espere o idle-detector do harness fazer isso sozinho minutos depois.
+**Após receber o retorno do sub-agent:** leia o auto-score — ele é **triagem, não aprovação**. Se for < 7, re-despache com o feedback específico (ou corrija inline) antes de avaliar. Em qualquer caso, a task só avança quando `morph-eval` der score ≥ 9 (a barra única do §0); integre o resultado ao recap.md e siga para a próxima tarefa.
 
 > **Anti-padrão a evitar:** implementar múltiplas tasks de domínios diferentes inline, em sequência, na thread principal — "eu já sei o padrão de cada uma". Isso é exatamente o sinal de que o sistema de delegação foi ignorado. Quando uma feature cruza ≥2 domínios, o caminho default é o Orchestrator despachando especialistas, não o Orchestrator virando faz-tudo.
 

package/framework/agents.json

@@ -155,7 +155,7 @@
       "standards": [],
       "tools": "Read, Glob, Grep, Bash",
       "model": "haiku",
-      "persona": "Você é um scout read-only: mapeia o território sem escrever código. Dado um sintoma ou uma feature, localiza os arquivos relevantes, o root cause provável e o blast radius (o que mais é afetado). Usa Read/Glob/Grep e Bash SOMENTE-LEITURA (git log/diff/show, ls, cat) — nunca Write/Edit, nunca comandos que mudam estado. Devolve um mapa curto e acionável (arquivos com paths, hipótese de causa, áreas de impacto) via SendMessage e encerra. Não implementa, não corrige — ilumina o caminho para quem vai."
+      "persona": "Você é um scout read-only: mapeia o território sem escrever código. Dado um sintoma ou uma feature, localiza os arquivos relevantes, o root cause provável e o blast radius (o que mais é afetado). Usa Read/Glob/Grep e Bash SOMENTE-LEITURA (git log/diff/show, ls, cat) — nunca Write/Edit, nunca comandos que mudam estado. Devolve um mapa curto e acionável (arquivos com paths, hipótese de causa, áreas de impacto) como relatório final e encerra. Não implementa, não corrige — ilumina o caminho para quem vai."
     }
   }
 }

package/framework/hooks/README.md

@@ -53,7 +53,6 @@ framework/hooks/
 | **PostToolUse** (Write\|Edit\|AskUserQuestion) | gate-guard.js | Advisory | Warns (never blocks) when a gate action disagrees with the persisted gateDecisions; logs one `coherent`/`divergent` line per check in `.morph/logs/activity.json` (issue #63) |
 | **PostToolUse** (all tools) | loop-detect.js | Advisory | Warns when the last 8 actions collapse to ≤2 unique signatures |
 | **Stop** | validate-completion.js | Advisory | Warns about incomplete tasks/missing outputs/recap drift; build check; session snapshot |
-| **Stop** / **SubagentStop** | subagent-report-guard.js | Block (once) | Blocks a dispatched sub-agent stopping without SendMessage (clause 1 of the dispatch protocol) and injects the exact instruction; `stop_hook_active` prevents loops; inert in the orchestrator's session |
 
 ## Design Principles
 

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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # create-umbraco-lp

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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # migrate-lp-to-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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-apply
@@ -134,21 +134,12 @@ dispatch Agent (subagent_type: "morph-{id}") with prompt:
     Implemente esta task (ou cadeia de tasks do fluxo) isoladamente.
     Não modifique spec.md, mandate.md.
 
-    Protocolo obrigatório:
-    1. ATO FINAL OBRIGATÓRIO — relatório via SendMessage: chame a tool
-       SendMessage com to:"main" e o relatório completo no content como a
-       ÚLTIMA tool call do seu turno. Sua última mensagem em texto NÃO chega
-       ao orquestrador — só SendMessage chega. Encerre IMEDIATAMENTE depois
-       da chamada: zero texto adicional, zero nova tool call, zero "aguardando
-       confirmação" — o SendMessage É o encerramento, não um passo
-       intermediário.
-       Exemplo literal (última chamada de tool da sua sessão, sem nada depois):
-       SendMessage({ to: "main", content: "Fluxo backend concluído (T2→T7).
-       Sumário: ... Arquivos: src/... Standards: vsa-handler-patterns.
-       Auto-score: 9/10" })
-       Terminar idle sem SendMessage, ou continuar agindo depois dele, é
-       falha de protocolo — cada segundo entre o SendMessage e o fim real do
-       turno é cauda que o orquestrador espera sem necessidade.
+    Contrato do relatório final:
+    1. ATO FINAL — o seu relatório é a sua ÚLTIMA MENSAGEM DE TEXTO: ela é o
+       valor de retorno desta sessão e chega inteira ao orquestrador. NÃO chame
+       SendMessage: ele gera um evento a mais além da notificação de término,
+       custando um turno inútil ao orquestrador. Escreva o relatório e encerre.
+       Relatório oco, ou sem os itens abaixo, é falha de protocolo.
     2. NÃO toque em tasks.json, feature.json, state.json nem no board de sessão
        (TaskCreate/TaskUpdate) — todo estado (status de task, scores, gates) é
        gravado exclusivamente pelo orquestrador.
@@ -158,21 +149,21 @@ dispatch Agent (subagent_type: "morph-{id}") with prompt:
          a verificação é do orquestrador, uma vez, pós-batch (`morph-spec verify`).
        - Batch COM isolamento (você recebeu `isolation: "worktree"`): rode build/test
          DENTRO do seu worktree; commite seu trabalho na branch do worktree como
-         penúltimo ato (antes do SendMessage); reporte a branch + status de build no
+         último ato antes do relatório; reporte a branch + status de build no
          relatório; NUNCA faça merge nem toque na árvore principal.
 
-    Retorne no content do SendMessage:
+    Seu relatório final deve conter:
       - sumário das mudanças
       - arquivos modificados (paths)
       - standard(s) consultado(s)
       - auto-score 0-10 (rubric: completeness, correctness, mandate compliance)
 ```
 
-> Este template é deliberadamente paritário com o template sequencial em `morph-implement` §4: ambos despacham o **subagent registrado do domínio (`morph-{id}`)** com standard escopado e as mesmas cláusulas de protocolo. A única diferença é que aqui múltiplos agentes rodam ao mesmo tempo, um por fluxo independente.
+> Este template é deliberadamente paritário com o template sequencial em `morph-implement` §4: ambos despacham o **subagent registrado do domínio (`morph-{id}`)** com standard escopado e as mesmas cláusulas do contrato do relatório final. A única diferença é que aqui múltiplos agentes rodam ao mesmo tempo, um por fluxo independente.
 
 > **Alternativa quando os fluxos tocam os mesmos projetos/arquivos** (ex.: o mesmo csproj de testes compartilhado): siga a §3b-w abaixo em vez desta seção — despache com `isolation: "worktree"`, cada agente trabalha numa working tree própria e o orquestrador integra ao final.
 
-Aguardar todos os agentes terminarem. O hook `subagent-report-guard` (Stop/SubagentStop) bloqueia uma vez o encerramento de um subagent despachado que não chamou SendMessage, com a instrução da cláusula 1 — o ciclo cobrar-esperar deixa de ser o caminho normal. **Fallback: se mesmo assim um agente ficar idle sem entregar o relatório, cobre-o via SendMessage e registre a falha de protocolo no recap.** Assim que o relatório de um agente chegar (SendMessage como teammate-message), **libere a sessão imediatamente** — chame `TaskStop(task_id: <id/nome do agente retornado pelo dispatch>)` antes de seguir para o próximo agente. Não espere o idle-detector do harness: sem esse `TaskStop`, a sessão fica pendurada minutos até o harness marcá-la idle sozinho e injetar um `idle_notification` vazio de volta nesta sessão. Trate falha do TaskStop (agente já finalizado sozinho) como não-fatal. Depois, sequencialmente:
+Aguardar todos os agentes terminarem — o relatório de cada um chega como o resultado do seu dispatch. Se um relatório vier oco ou sem os itens da cláusula 1, registre a falha de protocolo no recap. Depois, sequencialmente:
 - **Rodar `morph-spec verify {feature} --json` uma única vez, pós-batch** (escopo feature) — os agentes não a rodaram (cláusula 3). Vermelho: use `verify.feedback` para corrigir/redespachar ANTES de qualquer morph-eval. (Com isolamento por worktree, cada agente já rodou o verify dentro do seu worktree; o orquestrador roda o verify compartilhado UMA vez após o merge — ver §3b-w.)
 - Para cada relatório retornado:
   - Aplicar `Skill(morph-eval)`.
@@ -187,7 +178,7 @@ Depois do batch paralelo, executar o restante em modo sequencial (passo 3a).
 Quando o `morph-spec dag {feature}` reporta `isolation.recommended: "worktree"` (dois fluxos paralelos planejam escrever no mesmo path — colisão de `outputs`), despache cada fluxo com o parâmetro `isolation: "worktree"` do tool Agent. Cada agente trabalha numa working tree própria; build/test rodam lá dentro sem colidir.
 
 1. **Dispatch:** mesmo `subagent_type: "morph-{id}"` e standards de §3b, mais `isolation: "worktree"`. Se a stack for Node e faltar `node_modules` no worktree, o agente roda `morph-spec worktree link` (fail-open) antes de testar; se ainda impossível, reporta "verificação: não executada" (o verify pós-merge cobre). O agente commita na branch do worktree e reporta a branch.
-2. **Integração (orquestrador, após todos os relatórios + `TaskStop`):** faça o merge de cada branch reportada, uma por vez, na ordem de chegada — `git merge --no-ff <branch>`. Conflito → `git merge --abort`, marque a task de volta a `pending` com nota "merge conflict — reexecutar sequencial", siga para a próxima branch. Os paths em conflito são exatamente os de `isolation.collisions` do dag.
+2. **Integração (orquestrador, após todos os relatórios):** faça o merge de cada branch reportada, uma por vez, na ordem de chegada — `git merge --no-ff <branch>`. Conflito → `git merge --abort`, marque a task de volta a `pending` com nota "merge conflict — reexecutar sequencial", siga para a próxima branch. Os paths em conflito são exatamente os de `isolation.collisions` do dag.
 3. **Pós-merge:** rode `morph-spec verify {feature} --json` UMA vez (o merge é o novo ponto de integração — verificação compartilhada obrigatória), depois `morph-eval` + `morph-spec score` por relatório, como em §3b.
 4. **Cleanup:** `git worktree remove` + `git branch -d` das branches integradas + `git worktree prune` (fail-open). Branches não integradas ficam e são registradas no recap com o motivo.
 5. **Agente morto no meio:** se commitou, a branch sobrevive (retomável); senão, a task volta a `pending` na lane sequencial. Registre a falha de protocolo no recap.

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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-brainstorming

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

@@ -4,7 +4,7 @@ description: Avalia a qualidade de uma tarefa ou fase com rubricas graduadas 0-1
 version: core
 when-to-invoke: ao completar uma tarefa ou ao finalizar uma fase de implementação
 user-invokable: false
-cliVersion: "8.0.0"
+cliVersion: "8.1.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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-hotfix
@@ -43,9 +43,7 @@ subagent_type: "morph-scout"
 
 **Fallback** (se `morph-scout` não estiver registrado nos subagent types deste projeto): `general-purpose` com o campo `persona` do agente `scout` colado no prompt, **registrando o fallback nas notes da task**.
 
-Peça ao scout: localizar o root cause provável, os arquivos afetados e o blast radius (o que mais pode quebrar). Ele é read-only (Read/Glob/Grep/Bash somente-leitura) — não escreve código. Inclua as 3 cláusulas de protocolo obrigatório no prompt (template literal em `morph-implement` §4 / `morph-apply` §3b): ato final = relatório via `SendMessage` para `main` como a ÚLTIMA tool call do turno, sem texto ou tool call depois; 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.
-
-Ao receber o mapa via `SendMessage`, **libere a sessão imediatamente**: `TaskStop(task_id: <id/nome retornado pelo dispatch>)` (trate falha como não-fatal).
+Peça ao scout: localizar o root cause provável, os arquivos afetados e o blast radius (o que mais pode quebrar). Ele é read-only (Read/Glob/Grep/Bash somente-leitura) — não escreve código. Inclua as 3 cláusulas do contrato do relatório final no prompt (template literal em `morph-implement` §4 / `morph-apply` §3b): ato final = o relatório é a última mensagem de texto, sem `SendMessage`; não tocar `tasks.json`/`feature.json`/`state.json` nem o board de sessão; sem build/test da suíte compartilhada em batch paralelo.
 
 ### 3. Hotfix brief (`0-proposal/proposal.md`)
 

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

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "8.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-implement
@@ -58,21 +58,12 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
    Arquivos relevantes: [lista de paths]
    Done quando: [doneCriteria do tasks.json]
 
-   Protocolo obrigatório:
-   1. ATO FINAL OBRIGATÓRIO — relatório via SendMessage: chame a tool
-      SendMessage com to:"main" e o relatório completo no content como a
-      ÚLTIMA tool call do seu turno. Sua última mensagem em texto NÃO chega
-      ao orquestrador — só SendMessage chega. Encerre IMEDIATAMENTE depois
-      da chamada: zero texto adicional, zero nova tool call, zero "aguardando
-      confirmação" — o SendMessage É o encerramento, não um passo
-      intermediário antes de um encerramento "de verdade".
-      Exemplo literal (última chamada de tool da sua sessão, sem nada depois):
-      SendMessage({ to: "main", content: "T{N} concluída. (1) O que foi feito:
-      handler + validator do slice X. (2) Arquivos: src/Features/X/Handler.cs,
-      tests/X/HandlerTests.cs. (3) Problemas: nenhum. (4) Auto-score: 9/10" })
-      Terminar idle sem SendMessage, ou continuar agindo depois dele, é
-      falha de protocolo — cada segundo entre o SendMessage e o fim real do
-      turno é cauda que o orquestrador espera sem necessidade.
+   Contrato do relatório final:
+   1. ATO FINAL — o seu relatório é a sua ÚLTIMA MENSAGEM DE TEXTO: ela é o
+      valor de retorno desta sessão e chega inteira ao orquestrador. NÃO chame
+      SendMessage: ele gera um evento a mais além da notificação de término,
+      custando um turno inútil ao orquestrador. Escreva o relatório e encerre.
+      Relatório oco, ou sem os 4 itens abaixo, é falha de protocolo.
    2. NÃO toque em tasks.json, feature.json, state.json nem no board de sessão
       (TaskCreate/TaskUpdate) — todo estado é gravado exclusivamente pelo
       orquestrador.
@@ -80,14 +71,14 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
       NÃO rode build/test da suíte compartilhada — a verificação
       (`morph-spec verify`) é do orquestrador, uma vez, pós-batch. Em batch
       COM `isolation: "worktree"`, rode build/test dentro do seu worktree,
-      commite na branch do worktree como penúltimo ato (antes do SendMessage)
+      commite na branch do worktree como último ato antes do relatório
       e reporte a branch — nunca faça merge.
 
-   Retorne no content do SendMessage APENAS: (1) o que foi feito em 2-3 frases,
+   Seu relatório final deve conter APENAS: (1) o que foi feito em 2-3 frases,
    (2) arquivos modificados, (3) problemas encontrados e como foram resolvidos,
    (4) auto-score 0-10.
    ```
-   Após receber o retorno: o auto-score é **triagem, não aprovação** — se < 7, re-despache com o feedback específico (ou corrija inline) antes de prosseguir. Em qualquer caso, a task só avança quando `morph-eval` der score ≥ 9 (barra única do MORPH.md §0). **Libere a sessão do sub-agent imediatamente após consumir o relatório** — chame `TaskStop(task_id: <id/nome retornado pelo dispatch>)`. Isso evita que o idle-detector do harness dispare minutos depois e injete um `idle_notification` como teammate-message vazio na sua sessão; trate falha do TaskStop (agente já finalizado sozinho) como não-fatal. Integre o relatório ao recap.md e vá para o passo 7.
+   Após receber o retorno: o auto-score é **triagem, não aprovação** — se < 7, re-despache com o feedback específico (ou corrija inline) antes de prosseguir. Em qualquer caso, a task só avança quando `morph-eval` der score ≥ 9 (barra única do MORPH.md §0). Integre o relatório ao recap.md e vá para o passo 7.
 
    **Se não — siga para o passo 5.**
 

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

@@ -4,7 +4,7 @@ description: Guia a produção dos três artefatos de planejamento de uma featur
 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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-plan

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.0.0"
+cliVersion: "8.1.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.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-review
@@ -56,22 +56,18 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          seguindo as bandas 0-10 de cada uma.
          NÃO reescreva código. NÃO toque em tasks.json, feature.json nem no board
          de sessão.
-         Protocolo obrigatório — ATO FINAL: chame a tool SendMessage com
-         to:"main" e o relatório completo no content como a ÚLTIMA tool call
-         do seu turno; sua última mensagem em texto NÃO chega ao orquestrador
-         — só SendMessage chega. Encerre IMEDIATAMENTE depois: zero texto
-         adicional, zero nova tool call, zero "aguardando confirmação".
-         Exemplo literal (última chamada de tool da sua sessão, sem nada depois):
-         SendMessage({ to: "main", content: "Review de {feature}: arch=9.0
-         contracts=9.5 quality=9.0 tests=8.5 → composto 9.05. Feedback: ..." })
-         Terminar idle sem SendMessage, ou continuar agindo depois dele, é
-         falha de protocolo.
-         Retorne no content: score 0-10 por dimensão, score composto (arch×0.30 +
-         contracts×0.25 + quality×0.25 + tests×0.20), e feedback priorizado
-         (bloqueantes primeiro) para qualquer dimensão < 9.
+         Contrato do relatório final — ATO FINAL: o seu relatório é a sua
+         ÚLTIMA MENSAGEM DE TEXTO; ela é o valor de retorno desta sessão e
+         chega inteira ao orquestrador. NÃO chame SendMessage: ele gera um
+         evento a mais além da notificação de término, custando um turno
+         inútil ao orquestrador. Escreva o relatório e encerre.
+         Seu relatório final deve conter: score 0-10 por dimensão, score
+         composto (arch×0.30 + contracts×0.25 + quality×0.25 + tests×0.20), e
+         feedback priorizado (bloqueantes primeiro) para qualquer dimensão < 9.
+         Relatório 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).
-   - Os scores por dimensão e o composto do review-report vêm **desse retorno**, não da sua auto-avaliação. O hook `subagent-report-guard` bloqueia uma vez o encerramento do avaliador sem SendMessage; se mesmo assim ele ficar idle sem reportar, cobre via SendMessage antes de prosseguir (fallback). **Assim que o relatório chegar, libere a sessão do avaliador** — `TaskStop(task_id: <id/nome retornado pelo dispatch>)` — para não deixá-lo pendurado até o idle-detector do harness disparar um `idle_notification` de volta a esta sessão.
+   - Os scores por dimensão e o composto do review-report vêm **desse retorno**, não da sua auto-avaliação. Se o relatório vier oco ou sem os scores por dimensão, registre a falha de protocolo na seção de método do review-report e re-despache.
 
 5. Produza `review-report.md` em `.morph/features/{feature}/4-review/` com:
    - Scores por dimensão (arquitetura, contratos, qualidade, cobertura)

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

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

@@ -4,7 +4,7 @@ description: Localiza e carrega um standard específico do STANDARDS.json sob de
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "8.0.0"
+cliVersion: "8.1.0"
 ---
 
 # morph-standards

package/package.json

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

package/src/utils/hooks-installer.js

@@ -15,7 +15,7 @@ import { homedir } from 'os';
 import { execSync } from 'child_process';
 
 /** Current hooks schema version — bump when hook definitions change */
-const HOOKS_VERSION = '3.2.0';
+const HOOKS_VERSION = '3.3.0';
 
 /** Marker for old dispatch.js (v1) */
 const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
@@ -176,34 +176,13 @@ const MORPH_HOOKS = [
     }]
   },
 
-  // === Stop — build check + session snapshot + dispatch-report guard ===
-  // subagent-report-guard blocks (once) a dispatched sub-agent stopping
-  // without SendMessage — clause 1 of the dispatch protocol. In the
-  // orchestrator's session it is inert (marker never in a user message).
+  // === Stop — build check + session snapshot ===
   {
     event: 'Stop',
     matcher: null,
-    hooks: [
-      {
-        type: 'command',
-        command: 'node framework/hooks/claude-code/core/validate-completion.js'
-      },
-      {
-        type: 'command',
-        command: 'node framework/hooks/claude-code/core/subagent-report-guard.js',
-        timeout: 5000
-      }
-    ]
-  },
-
-  // === SubagentStop — dispatch-report guard for Task-tool subagents ===
-  {
-    event: 'SubagentStop',
-    matcher: null,
     hooks: [{
       type: 'command',
-      command: 'node framework/hooks/claude-code/core/subagent-report-guard.js',
-      timeout: 5000
+      command: 'node framework/hooks/claude-code/core/validate-completion.js'
     }]
   }
 ];

package/framework/hooks/claude-code/core/subagent-report-guard.js

@@ -1,95 +0,0 @@
-#!/usr/bin/env node
-/**
- * subagent-report-guard.js — Stop / SubagentStop hook
- *
- * Enforces clause 1 of the morph-spec dispatch protocol: a dispatched
- * sub-agent's FINAL act is SendMessage to the orchestrator (main). Plain text
- * in the last message never reaches the orchestrator, and an idle agent forces
- * the costly nag-and-wait cycle (observed 2/2 in real apply sessions —
- * MORPH_GHLBrain 2026-07-11).
- *
- * Detection: the session transcript (JSONL) contains the dispatch-protocol
- * marker ("Protocolo obrigatório") inside a USER message — that is how the
- * dispatch prompt arrives in the sub-agent's own transcript. In the
- * ORCHESTRATOR's transcript the marker only appears inside assistant tool_use
- * input (the Agent call that did the dispatch), so the orchestrator is never
- * blocked by this guard. A SendMessage tool_use anywhere in an assistant
- * message counts as the report.
- *
- * Action: block the stop ONCE ({"decision":"block"}) with the exact
- * instruction to call SendMessage — the agent continues and reports.
- * stop_hook_active guards against blocking loops. Fail-open on any error.
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { stateExists } from '../../shared/state-reader.js';
-import { block, pass } from '../../shared/hook-response.js';
-import { logHookActivity } from '../../shared/activity-logger.js';
-
-const PROTOCOL_MARKER = 'Protocolo obrigatório';
-
-function readStdin() {
-  try {
-    return JSON.parse(readFileSync(0, 'utf8') || '{}');
-  } catch {
-    return {};
-  }
-}
-
-function projectDir() {
-  return process.env.CLAUDE_PROJECT_DIR || process.cwd();
-}
-
-/**
- * Scan a transcript for the dispatch-protocol marker (user messages only) and
- * for a SendMessage tool call (assistant messages).
- *
- * @param {string} path - JSONL transcript path
- * @returns {{ dispatched: boolean, reported: boolean }}
- */
-function scanTranscript(path) {
-  const raw = readFileSync(path, 'utf8');
-  let dispatched = false;
-  let reported = false;
-  for (const line of raw.split('\n')) {
-    if (!line.trim()) continue;
-    let role = null;
-    try {
-      const entry = JSON.parse(line);
-      role = entry?.message?.role ?? entry?.type ?? null;
-    } catch {
-      continue;
-    }
-    if (!dispatched && role === 'user' && line.includes(PROTOCOL_MARKER)) dispatched = true;
-    if (!reported && role === 'assistant' && line.includes('"name":"SendMessage"')) reported = true;
-  }
-  return { dispatched, reported };
-}
-
-try {
-  if (!stateExists(projectDir())) pass();
-
-  const input = readStdin();
-
-  // Never loop: a previous block already forced one continuation — let this
-  // stop through even if the agent still failed to report.
-  if (input.stop_hook_active) pass();
-
-  const transcriptPath = input.transcript_path;
-  if (!transcriptPath || !existsSync(transcriptPath)) pass();
-
-  const { dispatched, reported } = scanTranscript(transcriptPath);
-  if (!dispatched || reported) pass();
-
-  logHookActivity('subagent-report-guard', input.hook_event_name || 'Stop', 'blocked', projectDir());
-  block(
-    '[morph-spec] PROTOCOLO DE RETORNO — você foi despachado com o protocolo obrigatório ' +
-    'mas ainda não chamou SendMessage. Sua última mensagem em texto NÃO chega ao orquestrador. ' +
-    'Antes de encerrar, chame a tool SendMessage com to:"main" e o relatório completo no content: ' +
-    '(1) o que foi feito em 2-3 frases, (2) arquivos modificados, (3) problemas encontrados e ' +
-    'como foram resolvidos, (4) auto-score 0-10. O SendMessage é o seu ato final.'
-  );
-} catch {
-  // Fail-open
-  process.exit(0);
-}