oxe-cc 1.2.1 → 1.3.0

package/oxe/workflows/next.md

@@ -1,41 +1,41 @@
 # OXE — Workflow: next
 
 <objective>
-Inspecionar `.oxe/STATE.md` global, a sessão ativa quando existir, e a existência de `SPEC.md`, `PLAN.md`, `QUICK.md`, `VERIFY.md` e `.oxe/codebase/` para recomendar **exatamente um** próximo passo OXE e **uma** frase de justificativa — sem lista de alternativas equiparáveis.
+Inspecionar `.oxe/STATE.md` global, a sessão ativa quando existir, e a existência de `SPEC.md`, `PLAN.md`, `QUICK.md`, `VERIFY.md` e `.oxe/codebase/` para recomendar **exatamente um** próximo passo OXE e **uma** frase de justificativa — sem lista de alternativas equiparáveis.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-status.md`. O passo devolve leitura curta, recomendação única e motivo.
-- O usuário pode rodar **`npx oxe-cc status`** no terminal para a mesma lógica resumida. **`npx oxe-cc status --hints`** (ou **`--json --hints`**) acrescenta lembretes **paralelos** (idade do scan/compact por config) — **não** altera o único passo canónico que este workflow deve devolver.
-- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, preferir os artefatos da sessão antes de olhar a raiz legada.
-- Se houver empate aparente (ex.: poderia ser spec ou quick), preferir **spec** quando já existir mapa de codebase; preferir **quick** só se o usuário deixar explícito que é correção mínima.
-- **Blueprint plan-agent:** se **`.oxe/plan-agents.json`** tiver `lifecycle.status === "invalidated"`, o próximo passo **não** assume papéis desse JSON; continuar a raciocinar só com **PLAN.md** / **QUICK.md** / **VERIFY.md** e **STATE.md**. Se o utilizador quiser de novo agentes + mensagens, indicar **`/oxe-plan-agent`**.
-- Priorizar sempre o passo que **reduz incerteza primeiro**. Se o plano existente não for o melhor plano atual ou estiver abaixo do limiar de confiança, o próximo passo não pode ser `execute`.
-</context>
+<context>
+- Aplicar `oxe/workflows/references/reasoning-status.md`. O passo devolve leitura curta, recomendação única e motivo.
+- O usuário pode rodar **`npx oxe-cc status`** no terminal para a mesma lógica resumida. **`npx oxe-cc status --hints`** (ou **`--json --hints`**) acrescenta lembretes **paralelos** (idade do scan/compact por config) — **não** altera o único passo canónico que este workflow deve devolver.
+- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, preferir os artefatos da sessão antes de olhar a raiz legada.
+- Se houver empate aparente (ex.: poderia ser spec ou quick), preferir **spec** quando já existir mapa de codebase; preferir **quick** só se o usuário deixar explícito que é correção mínima.
+- **Blueprint plan-agent:** se **`.oxe/plan-agents.json`** tiver `lifecycle.status === "invalidated"`, o próximo passo **não** assume papéis desse JSON; continuar a raciocinar só com **PLAN.md** / **QUICK.md** / **VERIFY.md** e **STATE.md**. Se o utilizador quiser de novo agentes + mensagens, indicar **`/oxe-plan-agent`**.
+- Priorizar sempre o passo que **reduz incerteza primeiro**. Se o plano existente não for o melhor plano atual ou estiver abaixo do limiar de confiança, o próximo passo não pode ser `execute`.
+</context>
 
 <process>
 1. Se `.oxe/` ou `STATE.md` não existir → **único** passo: **scan** (ou `oxe-cc init-oxe` seguido de scan).
 2. Se não houver `.oxe/codebase/*.md` completos (sete mapas) e o trabalho **não** for só um quick isolado → **scan**.
-3. Se fase `quick_active` ou existir `QUICK.md` no escopo resolvido **sem** `PLAN.md`:
+3. Se fase `quick_active` ou existir `QUICK.md` no escopo resolvido **sem** `PLAN.md`:
    - Se `QUICK.md` contiver linha `Promover para spec/plan?: sim` → **spec** (promoção declarada pelo autor; ignorar demais heurísticas).
    - Se o `QUICK.md` tiver **mais de 10 passos**, ou o utilizador/descrição indicar **contrato público**, **segurança**, **dados pessoais**, ou **>8 ficheiros** tocados ou previstos → **spec** (promoção obrigatória).
    - Senão → **execute** (há passos curtos a implementar).
-4. Se não houver `SPEC.md` no escopo resolvido e não for quick intencional declarado → **spec** (passo único).
-5. Se houver SPEC no escopo resolvido mas não PLAN → se `.oxe/config.json` tiver `discuss_before_plan: true` e faltar **`DISCUSS.md`** com decisões → **discuss**; senão → **plan**.
-6. Se PLAN existe mas a seção **Autoavaliação do Plano** disser `Melhor plano atual: não`, ou a `Confiança` estiver abaixo do limiar configurado (padrão 70%), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
-7. Se PLAN existe, **VERIFY.md** ainda **não** existe ou está claramente antes da implementação atual → **execute** (onda atual).
-8. Se PLAN existe e VERIFY falta após implementação declarada → **verify**.
-9. Se VERIFY indica falha ou gaps não resolvidos → **plan** (replanejamento) como passo único, com referência a `SUMMARY.md`.
-10. Se VERIFY OK e estado coerente → **spec** ou **quick** para **próxima** entrega, ou mensagem “fluxo da feature atual concluído”.
+4. Se não houver `SPEC.md` no escopo resolvido e não for quick intencional declarado → **spec** (passo único).
+5. Se houver SPEC no escopo resolvido mas não PLAN → se `.oxe/config.json` tiver `discuss_before_plan: true` e faltar **`DISCUSS.md`** com decisões → **discuss**; senão → **plan**.
+6. Se PLAN existe mas a seção **Autoavaliação do Plano** disser `Melhor plano atual: não`, ou a `Confiança` estiver abaixo do limiar configurado (padrão 70%), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
+7. Se PLAN existe, **VERIFY.md** ainda **não** existe ou está claramente antes da implementação atual → **execute** (onda atual).
+8. Se PLAN existe e VERIFY falta após implementação declarada → **verify**.
+9. Se VERIFY indica falha ou gaps não resolvidos → **plan** (replanejamento) como passo único, com referência a `SUMMARY.md`.
+10. Se VERIFY OK e estado coerente → **spec** ou **quick** para **próxima** entrega, ou mensagem “fluxo da feature atual concluído”.
 
 **Saída obrigatória (só isto, nesta ordem):**
 
 - **Próximo passo:** um único entre `scan` | `spec` | `discuss` | `plan` | `quick` | `execute` | `verify`
-- **Comando:** o slash correspondente (ex.: `/oxe-scan`) **ou** `npx oxe-cc status` para conferir de novo
-- **Por quê:** uma frase
-- **Confiança / lacuna:** só quando o estado estiver incompleto ou ambíguo
-- **Artefatos em jogo:** lista curta (máx. 4 itens)
-</process>
+- **Comando:** o slash correspondente (ex.: `/oxe-scan`) **ou** `npx oxe-cc status` para conferir de novo
+- **Por quê:** uma frase
+- **Confiança / lacuna:** só quando o estado estiver incompleto ou ambíguo
+- **Artefatos em jogo:** lista curta (máx. 4 itens)
+</process>
 
 <success_criteria>
 - [ ] Foi indicado **exatamente um** próximo passo entre os valores canónicos (`scan`, `spec`, `discuss`, `plan`, `quick`, `execute`, `verify`) ou mensagem explícita de fluxo concluído.

package/oxe/workflows/oxe.md

@@ -5,7 +5,7 @@ Ponto de entrada inteligente do OXE. Faz uma de três coisas dependendo do input
 
 1. **Sem input / "o que faço agora?"** → lê `STATE.md` e recomenda exatamente 1 próximo passo (lógica de `next.md`).
 2. **Input em linguagem natural** (ex.: "quero adicionar login", "preciso revisar um PR") → traduz para o comando OXE correto e executa ou orienta (lógica de `route.md`).
-3. **"help", "o que é OXE" ou "comandos"** → apresenta a trilha principal, a trilha avançada e a cadeia canônica.
+3. **"help", "o que é OXE" ou "comandos"** → apresenta a trilha principal, a trilha avançada e a cadeia canônica.
 
 **Princípio:** o usuário não precisa decorar o nome do comando — `/oxe [contexto]` resolve.
 </objective>
@@ -55,15 +55,15 @@ Mapear o input para o workflow correto e executar ou orientar:
 | Se o usuário disser | Executar |
 |---------------------|----------|
 | "quero [feature / tarefa / entrega]" | Verificar estado → **spec** ou **quick** |
-| "analisa / mapeia o projeto" | **`/oxe-spec --refresh`** (incremental) ou **`/oxe-scan`** (scan completo) |
-| "o que faz esse módulo / o que usa esse projeto" | **`/oxe "pergunta"`** com base nos artefatos existentes |
+| "analisa / mapeia o projeto" | **`/oxe-spec --refresh`** (incremental) ou **`/oxe-scan`** (scan completo) |
+| "o que faz esse módulo / o que usa esse projeto" | **`/oxe "pergunta"`** com base nos artefatos existentes |
 | "pesquisa / spike / quero entender X" | **`/oxe-spec --research`** |
-| "executa tudo / faz tudo / modo automático" | **`/oxe-execute`** |
-| "executa sem parar / autônomo" | **`/oxe-execute`** |
+| "executa tudo / faz tudo / modo automático" | **`/oxe-execute`** |
+| "executa sem parar / autônomo" | **`/oxe-execute`** |
 | "revisa PR / diff" | **`/oxe-verify --pr`** |
 | "auditoria de segurança" | **`/oxe-verify --security`** |
 | "valida / verifica" | **verify** |
-| "commita / entrega / ship" | **`/oxe-ship`** |
+| "commita / entrega / ship" | **`/oxe-ship`** |
 | "milestone / release / versão" | **`/oxe-session milestone`** |
 | "trilha paralela / workstream" | **`/oxe-session workstream`** |
 | "snapshot / checkpoint" | **`/oxe-execute --checkpoint "<nome>"`** |

package/oxe/workflows/plan-agent.md

@@ -3,7 +3,7 @@
 <objective>
 Produzir **dois artefactos alinhados**:
 
-1. **`.oxe/PLAN.md`** — mesmo contrato que o workflow **`plan.md`** (tarefas `Tn`, **Onda**, **Depende de**, **Verificar**, **Aceite vinculado**, **Autoavaliação do Plano** com rubrica e confiança determinística), para **`/oxe-execute`**, **`/oxe-verify`** e gates OXE existentes.
+1. **`.oxe/PLAN.md`** — mesmo contrato que o workflow **`plan.md`** (tarefas `Tn`, **Onda**, **Depende de**, **Verificar**, **Aceite vinculado**, **Autoavaliação do Plano** com rubrica e confiança determinística), para **`/oxe-execute`**, **`/oxe-verify`** e gates OXE existentes.
 2. **`.oxe/plan-agents.json`** — **blueprint de execução**: objetivo, **agentes** (papéis, âmbito, entradas/saídas esperadas, dependências entre agentes), **estratégia em ondas** (`execution.waves`), **`runId`** e **`lifecycle`** (schema **2**).
 
 O plano **não** é só uma lista de tarefas: cada agente é um **pacote de contexto** (o que ler, o que produzir, que `Tn` cobre). A execução real continua a ser feita pelo utilizador ou por subagentes da IDE, guiados por este blueprint e pelo `PLAN.md`.
@@ -13,11 +13,11 @@ O plano **não** é só uma lista de tarefas: cada agente é um **pacote de cont
 Se o utilizador pedir **`--replan`**: aplicar a mesma lógica de replanejamento descrita em **`plan.md`** (VERIFY, SUMMARY, secção Replanejamento) e **atualizar ou recriar** `plan-agents.json` em coerência com o novo `PLAN.md`; gerar **novo** `runId` e repor `lifecycle.status` → `pending_execute`. Se ainda existir pasta **`.oxe/plan-agent-messages/`** cheia do **run** anterior e o utilizador não precisar dela na raiz, **arquivar** primeiro em **`.oxe/archive/plan-agent-runs/<runId-antigo>/`** (ver **`references/plan-agent-chat-protocol.md`**) ou pedir confirmação antes de sobrescrever; depois recriar **`.oxe/plan-agent-messages/README.md`** para o novo `runId`.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-planning.md`. O blueprint e o PLAN devem sair decision-complete; não deixar decisões relevantes implícitas para a execução dos agentes.
-- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, `PLAN.md`, `plan-agents.json` e `plan-agent-messages/` vivem em `.oxe/<active_session>/plan/`; sem sessão ativa, manter `.oxe/`.
-- O `plan-agent` herda integralmente o contrato `oxe/workflows/references/flow-robustness-contract.md`. Não pode emitir percentuais concorrentes por agente; a confiança final do plano é única e visível no `PLAN.md`.
-- **Pré-requisitos** iguais a **`plan.md`**: `.oxe/SPEC.md` obrigatória; `discuss_before_plan` + `DISCUSS.md` quando configurado; consumir **NOTES**, **UI-SPEC**, **DISCUSS**, **RESEARCH**, **CODEBASE-DELTA** / **RESUME**, **config.json** (`plan_max_tasks_per_wave`, `default_verify_command`) como em **`plan.md`**.
+<context>
+- Aplicar `oxe/workflows/references/reasoning-planning.md`. O blueprint e o PLAN devem sair decision-complete; não deixar decisões relevantes implícitas para a execução dos agentes.
+- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, `PLAN.md`, `plan-agents.json` e `plan-agent-messages/` vivem em `.oxe/<active_session>/plan/`; sem sessão ativa, manter `.oxe/`.
+- O `plan-agent` herda integralmente o contrato `oxe/workflows/references/flow-robustness-contract.md`. Não pode emitir percentuais concorrentes por agente; a confiança final do plano é única e visível no `PLAN.md`.
+- **Pré-requisitos** iguais a **`plan.md`**: `.oxe/SPEC.md` obrigatória; `discuss_before_plan` + `DISCUSS.md` quando configurado; consumir **NOTES**, **UI-SPEC**, **DISCUSS**, **RESEARCH**, **CODEBASE-DELTA** / **RESUME**, **config.json** (`plan_max_tasks_per_wave`, `default_verify_command`) como em **`plan.md`**.
 - **Fonte de verdade das tarefas:** `PLAN.md`. O JSON referencia tarefas via **`taskIds`** em cada agente — **não** duplicar o texto de **Verificar** no JSON; copiar só paths/resumo curto em **`outputs`** quando útil para routing.
 - **Agentes ≠ ferramentas externas fixas:** `role` e `scope` descrevem o **comportamento esperado** de um contexto focado (ex.: “Backend Auth Specialist”), não um binário. Quem executa pode ser um único modelo com instruções diferentes por onda.
 - **Protocolo agente → agente:** **`oxe/workflows/references/plan-agent-chat-protocol.md`** — mensagens em **`.oxe/plan-agent-messages/`** (ficheiros `W{onda}-{seq}-{from}-to-{dest}.md` com frontmatter YAML). Criar a pasta e copiar o índice a partir de **`oxe/templates/plan-agent-messages-README.template.md`** → `.oxe/plan-agent-messages/README.md`.
@@ -128,11 +128,11 @@ Resumo obrigatório no chat: `Gate plan-agent: OK` ou `Gate plan-agent: corrigid
 3. Escrever **`.oxe/PLAN.md`** (cabeçalho YAML como em `oxe/templates/PLAN.template.md`; em **--replan**, secção Replanejamento).
 4. Gerar **`runId`** novo e **`lifecycle`**: `{ "status": "pending_execute", "since": "<ISO agora>" }`.
 5. Escrever **`.oxe/plan-agents.json`** a partir de **`oxe/templates/plan-agents.template.json`**, com **`oxePlanAgentsSchema: 3`**, `goal`, `agents` (incluindo `model_hint` por agente conforme `<model_hints>`), `execution`, `runId`, `lifecycle`.
-6. Criar `plan-agent-messages/` e `plan-agent-messages/README.md` no escopo resolvido a partir de **`oxe/templates/plan-agent-messages-README.template.md`**.
+6. Criar `plan-agent-messages/` e `plan-agent-messages/README.md` no escopo resolvido a partir de **`oxe/templates/plan-agent-messages-README.template.md`**.
 7. Atualizar **`.oxe/STATE.md`**: fase `plan_ready`, próximo passo `oxe:execute`; preencher **Blueprint de agentes (sessão)** — `run_id` (= `runId`), `lifecycle_status` (= `pending_execute`), **última onda** — (ou `—`).
 8. Aplicar **`<plan_agent_quality_gate>`**; corrigir até passar.
-9. No chat: resumo do gate plan-agent, `runId`, número de agentes, ondas, tarefas, riscos e assumptions relevantes, e referência ao protocolo em **`references/plan-agent-chat-protocol.md`**.
-</process>
+9. No chat: resumo do gate plan-agent, `runId`, número de agentes, ondas, tarefas, riscos e assumptions relevantes, e referência ao protocolo em **`references/plan-agent-chat-protocol.md`**.
+</process>
 
 <success_criteria>
 - [ ] `PLAN.md` existe e passa o gate de **`plan.md`**.

package/oxe/workflows/quick.md

@@ -8,9 +8,9 @@ Quando o trabalho envolve **2 ou mais domínios distintos** (ex.: backend + fron
 Usar quando: correção pontual, refactor local, feature pequena ou protótipo que **não** justifica critérios de aceite completos.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-planning.md` em modo lean. Mesmo sem plano formal completo, o quick deve explicitar objetivo, validação, riscos e condição de promoção.
-- Seguir `oxe/workflows/references/flow-robustness-contract.md`. Quick continua leve, mas não pode fingir que existe plano formal quando ele não existe.
+<context>
+- Aplicar `oxe/workflows/references/reasoning-planning.md` em modo lean. Mesmo sem plano formal completo, o quick deve explicitar objetivo, validação, riscos e condição de promoção.
+- Seguir `oxe/workflows/references/flow-robustness-contract.md`. Quick continua leve, mas não pode fingir que existe plano formal quando ele não existe.
 - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, `QUICK.md` e `quick-agents.json` vivem em `.oxe/<active_session>/plan/`; sem sessão ativa, manter `.oxe/`.
 - Ler `.oxe/STATE.md` e, se existirem, `OVERVIEW.md` e `STACK.md` em `.oxe/codebase/` para não contradizer o repo.
 - Não apagar `SPEC.md` / `PLAN.md` se existirem; este fluxo é paralelo ou temporário.
@@ -163,13 +163,13 @@ Se **sim**, o próximo passo recomendado no chat é **`/oxe-spec`** (depois disc
 5. Se existir **`.oxe/plan-agents.json`** com schema 2 e lifecycle ainda não `invalidated`, aplicar a invalidação descrita em **context** (actualizar JSON + **STATE.md** — blueprint de agentes).
 6. Se existir **`.oxe/quick-agents.json`** anterior com `status` não-terminal, invalidá-lo (ver **context**).
 7. Atualizar **`.oxe/STATE.md`**: fase `quick_active`, próximo passo `oxe:execute` ou implementação manual + `oxe:verify`; se PDDA ativo, registrar `quick_agents_status: active` e `quick_id: <quickId>`.
-8. Responder no chat com resumo em ≤10 linhas, nesta ordem:
-   - **Objetivo**
-   - **Plano**
-   - **Validação**
-   - **Riscos / assumptions**
-   - **Próximo passo**
-   Se promover = sim, destacar **`/oxe-spec`** como próximo passo lógico; se blueprint plan-agent foi invalidado, mencionar **`/oxe-plan-agent`** para novo roteiro.
+8. Responder no chat com resumo em ≤10 linhas, nesta ordem:
+   - **Objetivo**
+   - **Plano**
+   - **Validação**
+   - **Riscos / assumptions**
+   - **Próximo passo**
+   Se promover = sim, destacar **`/oxe-spec`** como próximo passo lógico; se blueprint plan-agent foi invalidado, mencionar **`/oxe-plan-agent`** para novo roteiro.
 9. **Sugestão de commit (pós-verify bem-sucedido):** após o bloco **Verificar** passar, sugerir ao usuário: *"Quick concluído. Commitar? `git add -p && git commit -m 'quick: <objetivo em uma linha>'`"* — apenas sugerir, não executar automaticamente.
 </process>
 

package/oxe/workflows/references/reasoning-discovery.md

@@ -1,28 +1,28 @@
-# OXE — Contrato de Raciocínio: Discovery
-
-Use este contrato em workflows de descoberta, leitura situacional e redução de ambiguidade.
-
-## Ordem obrigatória
-
-1. Explorar artefatos e repositório antes de perguntar.
-2. Separar fatos confirmados, inferências e lacunas.
-3. Perguntar apenas ambiguidades de alto impacto.
-4. Responder com base em evidência do workspace.
-5. Fechar com um próximo passo único quando fizer sentido.
-
-## Regras
-
-- Não perguntar o que pode ser resolvido por leitura de arquivos, código, config ou estado.
-- Distinguir explicitamente:
-  - fato confirmado;
-  - inferência;
-  - lacuna de evidência.
-- Se o contexto local já for suficiente, não abrir rodada de perguntas por hábito.
-- Quando a resposta envolver estado incompleto, dizer a confiança da leitura e o artefato ausente.
-
-## Saída esperada
-
-- **Fatos**
-- **Inferências**
-- **Lacunas**
-- **Próximo passo**
+# OXE — Contrato de Raciocínio: Discovery
+
+Use este contrato em workflows de descoberta, leitura situacional e redução de ambiguidade.
+
+## Ordem obrigatória
+
+1. Explorar artefatos e repositório antes de perguntar.
+2. Separar fatos confirmados, inferências e lacunas.
+3. Perguntar apenas ambiguidades de alto impacto.
+4. Responder com base em evidência do workspace.
+5. Fechar com um próximo passo único quando fizer sentido.
+
+## Regras
+
+- Não perguntar o que pode ser resolvido por leitura de arquivos, código, config ou estado.
+- Distinguir explicitamente:
+  - fato confirmado;
+  - inferência;
+  - lacuna de evidência.
+- Se o contexto local já for suficiente, não abrir rodada de perguntas por hábito.
+- Quando a resposta envolver estado incompleto, dizer a confiança da leitura e o artefato ausente.
+
+## Saída esperada
+
+- **Fatos**
+- **Inferências**
+- **Lacunas**
+- **Próximo passo**

package/oxe/workflows/references/reasoning-execution.md

@@ -1,29 +1,29 @@
-# OXE — Contrato de Raciocínio: Execution
-
-Use este contrato em workflows de execução, correção, loop operacional e mutação controlada.
-
-## Ordem obrigatória
-
-1. Fazer reconhecimento curto do contexto real antes de editar ou aplicar efeitos colaterais.
-2. Explicitar o alvo da mudança e a fatia atual.
-3. Operar no menor write set viável.
-4. Validar após cada fatia relevante.
-5. Parar e registrar bloqueio quando a hipótese crítica não estiver verificada.
-
-## Regras
-
-- Não saltar direto para mutação sem ler os artefatos e arquivos necessários.
-- Preferir mudanças pequenas e verificáveis em vez de alteração ampla e opaca.
-- Se surgir conflito estrutural ou ambiguidade de alto impacto, pausar e explicitar.
-- Toda execução deve terminar com:
-  - avanço confirmado;
-  - bloqueio claro; ou
-  - próxima ação única.
-
-## Saída esperada
-
-- **Contexto lido**
-- **Alvo da mudança**
-- **Validação executada**
-- **Resultado**
-- **Próximo passo**
+# OXE — Contrato de Raciocínio: Execution
+
+Use este contrato em workflows de execução, correção, loop operacional e mutação controlada.
+
+## Ordem obrigatória
+
+1. Fazer reconhecimento curto do contexto real antes de editar ou aplicar efeitos colaterais.
+2. Explicitar o alvo da mudança e a fatia atual.
+3. Operar no menor write set viável.
+4. Validar após cada fatia relevante.
+5. Parar e registrar bloqueio quando a hipótese crítica não estiver verificada.
+
+## Regras
+
+- Não saltar direto para mutação sem ler os artefatos e arquivos necessários.
+- Preferir mudanças pequenas e verificáveis em vez de alteração ampla e opaca.
+- Se surgir conflito estrutural ou ambiguidade de alto impacto, pausar e explicitar.
+- Toda execução deve terminar com:
+  - avanço confirmado;
+  - bloqueio claro; ou
+  - próxima ação única.
+
+## Saída esperada
+
+- **Contexto lido**
+- **Alvo da mudança**
+- **Validação executada**
+- **Resultado**
+- **Próximo passo**

package/oxe/workflows/references/reasoning-planning.md

@@ -1,32 +1,32 @@
-# OXE — Contrato de Raciocínio: Planning
-
-Use este contrato em workflows que produzem plano, roteiro de implementação ou decomposição de trabalho.
-
-## Ordem obrigatória
-
-1. Ler artefatos de contrato e contexto técnico.
-2. Validar pré-condições e incertezas abertas.
-3. Produzir um plano decision-complete.
-4. Autoavaliar o plano com confiança explícita.
-5. Registrar o próximo passo único.
-
-## Regras
-
-- Não deixar decisões importantes para quem implementar depois.
-- Tornar explícitos:
-  - interfaces e artefatos esperados;
-  - validação mínima;
-  - riscos e contenção;
-  - assumptions;
-  - condição para replanejar.
-- Se faltar evidência crítica, refletir isso na confiança e no próximo passo.
-- Não propor execução direta quando a própria confiança ou os gates não sustentam isso.
-
-## Saída esperada
-
-- **Objetivo**
-- **Plano**
-- **Validação / testes**
-- **Riscos e contenção**
-- **Assumptions**
-- **Confiança**
+# OXE — Contrato de Raciocínio: Planning
+
+Use este contrato em workflows que produzem plano, roteiro de implementação ou decomposição de trabalho.
+
+## Ordem obrigatória
+
+1. Ler artefatos de contrato e contexto técnico.
+2. Validar pré-condições e incertezas abertas.
+3. Produzir um plano decision-complete.
+4. Autoavaliar o plano com confiança explícita.
+5. Registrar o próximo passo único.
+
+## Regras
+
+- Não deixar decisões importantes para quem implementar depois.
+- Tornar explícitos:
+  - interfaces e artefatos esperados;
+  - validação mínima;
+  - riscos e contenção;
+  - assumptions;
+  - condição para replanejar.
+- Se faltar evidência crítica, refletir isso na confiança e no próximo passo.
+- Não propor execução direta quando a própria confiança ou os gates não sustentam isso.
+
+## Saída esperada
+
+- **Objetivo**
+- **Plano**
+- **Validação / testes**
+- **Riscos e contenção**
+- **Assumptions**
+- **Confiança**

package/oxe/workflows/references/reasoning-review.md

@@ -1,29 +1,29 @@
-# OXE — Contrato de Raciocínio: Review
-
-Use este contrato em workflows de auditoria, verificação, revisão de diff, segurança e gaps.
-
-## Ordem obrigatória
-
-1. Ler a evidência real antes de concluir.
-2. Apresentar findings primeiro.
-3. Ordenar por severidade e impacto.
-4. Sustentar cada finding com evidência observável.
-5. Só depois resumir o quadro geral.
-
-## Regras
-
-- Findings devem vir antes de resumo narrativo.
-- Separar:
-  - bug ou regressão;
-  - risco;
-  - divergência de contrato;
-  - lacuna de teste/evidência.
-- Se não houver findings, declarar isso explicitamente.
-- Mesmo sem findings, listar riscos residuais ou gaps de cobertura quando existirem.
-
-## Saída esperada
-
-- **Findings**
-- **Perguntas abertas**
-- **Riscos residuais**
-- **Resumo**
+# OXE — Contrato de Raciocínio: Review
+
+Use este contrato em workflows de auditoria, verificação, revisão de diff, segurança e gaps.
+
+## Ordem obrigatória
+
+1. Ler a evidência real antes de concluir.
+2. Apresentar findings primeiro.
+3. Ordenar por severidade e impacto.
+4. Sustentar cada finding com evidência observável.
+5. Só depois resumir o quadro geral.
+
+## Regras
+
+- Findings devem vir antes de resumo narrativo.
+- Separar:
+  - bug ou regressão;
+  - risco;
+  - divergência de contrato;
+  - lacuna de teste/evidência.
+- Se não houver findings, declarar isso explicitamente.
+- Mesmo sem findings, listar riscos residuais ou gaps de cobertura quando existirem.
+
+## Saída esperada
+
+- **Findings**
+- **Perguntas abertas**
+- **Riscos residuais**
+- **Resumo**

package/oxe/workflows/references/reasoning-status.md

@@ -1,24 +1,24 @@
-# OXE — Contrato de Raciocínio: Status
-
-Use este contrato em workflows de ajuda, roteamento, leitura de estado, dashboard e recomendação de próximo passo.
-
-## Ordem obrigatória
-
-1. Ler o estado e os artefatos mínimos.
-2. Resolver a situação atual sem inventar contexto.
-3. Dar uma recomendação única e acionável.
-4. Explicitar a razão da recomendação.
-
-## Regras
-
-- Preferir resposta curta e orientada a decisão.
-- Não abrir múltiplas opções equivalentes sem necessidade.
-- Se o estado estiver incompleto ou ambíguo, dizer isso explicitamente.
-- Quando houver recomendação, ela deve vir com o motivo e o artefato que a sustenta.
-
-## Saída esperada
-
-- **Leitura atual**
-- **Recomendação**
-- **Motivo**
-- **Confiança / lacuna**
+# OXE — Contrato de Raciocínio: Status
+
+Use este contrato em workflows de ajuda, roteamento, leitura de estado, dashboard e recomendação de próximo passo.
+
+## Ordem obrigatória
+
+1. Ler o estado e os artefatos mínimos.
+2. Resolver a situação atual sem inventar contexto.
+3. Dar uma recomendação única e acionável.
+4. Explicitar a razão da recomendação.
+
+## Regras
+
+- Preferir resposta curta e orientada a decisão.
+- Não abrir múltiplas opções equivalentes sem necessidade.
+- Se o estado estiver incompleto ou ambíguo, dizer isso explicitamente.
+- Quando houver recomendação, ela deve vir com o motivo e o artefato que a sustenta.
+
+## Saída esperada
+
+- **Leitura atual**
+- **Recomendação**
+- **Motivo**
+- **Confiança / lacuna**