oxe-cc 1.2.1 → 1.4.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/plan.md

@@ -5,14 +5,39 @@ Produzir **`.oxe/PLAN.md`**: tarefas **pequenas**, **ondas** (paralelizáveis vs
 
 Base: `SPEC.md` do escopo resolvido da sessão (critérios com IDs **A1**, **A2**, …) + `.oxe/codebase/*` + código quando necessário (Grep/Read pontual).
 
-Se o usuário pedir **--replan** (ou replanejamento implícito após `verify_failed`):
-- Ler `VERIFY.md` e `SUMMARY.md` do escopo resolvido, e o `PLAN.md` atual.
-- Preservar tarefas já concluídas ou renumerar com nota em **Replanejamento**; não apagar histórico útil — deslocar para a seção **Replanejamento** e reescrever **Tarefas** conforme necessário.
-- Se **SUMMARY.md** não existir, criar a partir de `oxe/templates/SUMMARY.template.md` para registrar o contexto do replan (ou dar append se já existir).
-</objective>
-
-<context>
-- Aplicar `oxe/workflows/references/reasoning-planning.md` como contrato deste passo. O `PLAN.md` deve sair decision-complete e não deixar decisões relevantes para a execução.
+Se o usuário pedir **--replan** (ou replanejamento implícito após `verify_failed`):
+- Ler `VERIFY.md` e `SUMMARY.md` do escopo resolvido, e o `PLAN.md` atual.
+- Preservar tarefas já concluídas ou renumerar com nota em **Replanejamento**; não apagar histórico útil — deslocar para a seção **Replanejamento** e reescrever **Tarefas** conforme necessário.
+- Se **SUMMARY.md** não existir, criar a partir de `oxe/templates/SUMMARY.template.md` para registrar o contexto do replan (ou dar append se já existir).
+</objective>
+
+<plan_iteration_contract>
+## Contrato de iteração do plano
+
+Quando já existir `PLAN.md` no escopo resolvido, a regra do OXE é esta:
+
+1. **Mesmo escopo e mesma spec, mas o usuário quer refinar o plano**:
+   - tratar uma nova chamada de `/oxe-plan` como **replan implícito**, mesmo sem `--replan`;
+   - preservar histórico útil e preencher a seção **Replanejamento**.
+2. **A estratégia técnica mudou** (arquitetura, tradeoff, sequencing, decisão de implementação, boundary entre componentes):
+   - **não** reescrever o plano como se fosse só refinamento;
+   - orientar ou executar `discuss` antes do novo plano;
+   - depois voltar a `plan` em modo de replanejamento.
+3. **O escopo mudou** (requisitos, critérios A*, prioridade, corte de entrega, aceite, roadmap):
+   - **não** tratar como replan simples;
+   - voltar para `spec` antes de gerar novo plano.
+4. **Regra de precedência**:
+   - mudança de escopo → `spec`
+   - mudança de estratégia → `discuss`
+   - mudança de decomposição/ordem/risco/validação mantendo o mesmo escopo → `plan --replan`
+
+Resumo operacional:
+- `/oxe-plan` repetido até o usuário ficar satisfeito é válido, mas, se já houver `PLAN.md`, isso deve ser tratado como **replan implícito** por padrão.
+- O agente só deve continuar refinando o plano na mesma trilha quando os requisitos e critérios da `SPEC.md` permanecerem válidos.
+</plan_iteration_contract>
+
+<context>
+- Aplicar `oxe/workflows/references/reasoning-planning.md` como contrato deste passo. O `PLAN.md` deve sair decision-complete e não deixar decisões relevantes para a execução.
 - Seguir `oxe/workflows/references/flow-robustness-contract.md` como contrato canónico de robustez. A ordem obrigatória é: ler artefatos, resolver sessão/paths, validar pré-condições, escrever o plano, autoavaliar o plano, registrar próximo passo único.
 - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, o plano vive em `.oxe/<active_session>/plan/` e lê a spec em `.oxe/<active_session>/spec/`.
 - Antes do scan amplo, carregar `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.json` como entrada prioritária do contexto do passo.
@@ -138,16 +163,21 @@ Resumo obrigatório no chat: `Gate do plano: OK` ou `Gate do plano: corrigido (N
 </plan_quality_gate>
 
 <process>
-1. Resolver `active_session` e ler `SPEC.md` do escopo correto (obrigatório). Se faltar, pedir **spec** primeiro.
-1a. Resolver o context pack `plan` primeiro:
-   - ler `.oxe/context/packs/plan.md|json` (ou `oxe-cc context inspect --workflow plan --json`);
-   - se estiver fresco e coerente, usar o pack como mapa primário;
+1. Resolver `active_session` e ler `SPEC.md` do escopo correto (obrigatório). Se faltar, pedir **spec** primeiro.
+1a. Se `PLAN.md` já existir no escopo resolvido:
+   - se o pedido atual só refina tarefas, ondas, dependências, riscos, validação ou sequencing, tratar como **replan implícito**;
+   - se o pedido atual mudar estratégia técnica, pedir ou executar `discuss` antes de seguir;
+   - se o pedido atual mudar escopo, critérios, prioridades ou aceite, pedir ou executar `spec` antes de seguir.
+   Registar explicitamente no chat qual dos três caminhos foi adotado.
+1b. Resolver o context pack `plan` primeiro:
+   - ler `.oxe/context/packs/plan.md|json` (ou `oxe-cc context inspect --workflow plan --json`);
+   - se estiver fresco e coerente, usar o pack como mapa primário;
    - se estiver stale, incompleto ou ausente, registar `fallback para leitura direta` e seguir com leitura bruta.
-1b. Com pack válido, ler primeiro o resumo do pack e os artefatos de `read_order`; só abrir outros artefatos quando faltarem evidências para fechar tarefas, riscos ou autoavaliação.
+1c. Com pack válido, ler primeiro o resumo do pack e os artefatos de `read_order`; só abrir outros artefatos quando faltarem evidências para fechar tarefas, riscos ou autoavaliação.
 2. Se `.oxe/config.json` tiver `discuss_before_plan: true` e **não** existir `DISCUSS.md` no escopo resolvido com decisões fechadas, pedir **discuss** antes de planejar.
 3. Se existir **`.oxe/NOTES.md`**, consumir ou explicitamente adiar cada bullet relevante (ver **context**).
 4. Ler `.oxe/codebase/*.md` (incl. CONVENTIONS / CONCERNS) e inspecionar pontos de entrada se a spec exigir. Se o pack não bastar, expandir a leitura apenas para os artefatos adicionais necessários e registar essa expansão.
-5. Escrever ou atualizar `PLAN.md` no escopo resolvido usando `oxe/templates/PLAN.template.md` como cabeçalho; **preservar** YAML inicial (`oxe_doc: plan`, `status`, `inputs`) se já existir e **atualizar** `updated:` (ISO); em **--replan**, preencher a seção **Replanejamento** (data, motivo, lições de VERIFY/SUMMARY, tarefas removidas/alteradas).
+5. Escrever ou atualizar `PLAN.md` no escopo resolvido usando `oxe/templates/PLAN.template.md` como cabeçalho; **preservar** YAML inicial (`oxe_doc: plan`, `status`, `inputs`) se já existir e **atualizar** `updated:` (ISO); em **--replan** ou **replan implícito**, preencher a seção **Replanejamento** (data, motivo, lições de VERIFY/SUMMARY, tarefas removidas/alteradas).
 6. Definir ondas: onda 1 = tarefas sem dependência entre si; onda seguinte = dependentes; respeitar `plan_max_tasks_per_wave` se configurado.
 6a. **Calibração histórica:** se `.oxe/calibration.json` existir e tiver ≥ 2 registros, ler as últimas 3 entradas antes de preencher a autoavaliação. Para cada dimensão com `calibration_error > 0.25` em 2+ ciclos consecutivos, adicionar `[⚠ historicamente subestimado]` na nota da dimensão e reduzir o score em 0.10 ou justificar explicitamente por que o ciclo atual é diferente.
 7. Preencher `## Autoavaliação do Plano` com a rubrica fixa. A confiança é a soma ponderada das seis dimensões; não inventar percentagem sem justificar os pontos. As lacunas, conflitos e freshness do pack devem aparecer nessa autoavaliação quando forem relevantes. **Incluir o bloco `<confidence_vector>`** com as 6 dimensões usando o template em `oxe/templates/PLAN.template.md`.
@@ -156,12 +186,13 @@ Resumo obrigatório no chat: `Gate do plano: OK` ou `Gate do plano: corrigido (N
 9. Atualizar `.oxe/STATE.md` global: fase `plan_ready`, próximo passo `oxe:execute` apenas se `Melhor plano atual: sim` e a confiança estiver no limiar executável; caso contrário, próximo passo deve reduzir incerteza (`oxe:discuss`, `oxe:research` ou replanejamento).
 10. **Sugestão de agentes (inteligente):** após o gate passar, verificar se o plano tem 3+ domínios distintos (ex.: backend + frontend + DB, ou auth + notificações + UI). Se sim, sugerir proativamente: "Este plano tem N domínios distintos. Quer gerar um blueprint de agentes com `/oxe-plan --agents`?" — não executar automaticamente, apenas oferecer. Se o usuário incluiu `--agents` no input original, executar imediatamente a lógica de `oxe/workflows/plan-agent.md`.
 11. Listar no chat: resultado do gate (OK ou corrigido), ondas, contagem de tarefas, comando de teste guarda-chuva se houver, melhor-plano-atual e confiança.
-12. No resumo em chat, deixar explícitos:
-   - objetivo e escopo do plano;
-   - principais riscos e contenções;
-   - assumptions relevantes;
-   - se o plano foi produzido com pack fresco ou com fallback explícito;
-   - comando único recomendado para o próximo passo.
+12. No resumo em chat, deixar explícitos:
+   - objetivo e escopo do plano;
+   - principais riscos e contenções;
+   - assumptions relevantes;
+   - se o plano foi produzido com pack fresco ou com fallback explícito;
+   - se a chamada foi tratada como plano novo, replan implícito, ou se foi devolvida para `spec`/`discuss`;
+   - comando único recomendado para o próximo passo.
 </process>
 
 <success_criteria>

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**