oxe-cc 1.0.0 → 1.3.0

package/oxe/workflows/loop.md

@@ -1,14 +1,18 @@
 # OXE — Workflow: loop (execução iterativa até verificação passar)
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-execute`.
+> Use: `/oxe-execute --iterative` para ativar loop de retry até verify passar.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Executar uma **onda do PLAN.md** em ciclo iterativo até que a verificação inline passe ou o limite de tentativas seja atingido. Complementa o **Modo B** (por onda) do **`execute.md`** com retries automáticos e diagnóstico inline de falhas.
 
 Quando verify falha, não interrompe — diagnostica (2-3 hipóteses), corrige, tenta de novo. Escala para **`/oxe-forensics`** apenas quando esgota as tentativas.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-execution.md`. Cada iteração deve deixar explícitos o contexto lido, a hipótese testada e a validação executada.
-- **Pré-requisito:** `.oxe/PLAN.md` existente com pelo menos 1 onda; `STATE.md` com fase ≥ `plan_ready`.
+<context>
+- Aplicar `oxe/workflows/references/reasoning-execution.md`. Cada iteração deve deixar explícitos o contexto lido, a hipótese testada e a validação executada.
+- **Pré-requisito:** `.oxe/PLAN.md` existente com pelo menos 1 onda; `STATE.md` com fase ≥ `plan_ready`.
 - **Máximo de iterações:** padrão = 3; configurável via argumento `max:<N>` (ex.: `/oxe-loop onda 2 max:5`). Nunca exceder 10.
 - **Artefato:** não cria novos arquivos — atualiza `STATE.md` com campos `loop_*` e registra cada iteração como bloco inline no chat.
 - **Escalação:** se esgotou tentativas e ainda falhou → registrar estado em STATE.md + sugerir `/oxe-forensics` com contexto das hipóteses já tentadas.
@@ -42,16 +46,16 @@ Limpar campos `loop_*` ao concluir com `passed` (ou manter `escalated` se escalo
       - Incrementar iteração: `loop_iteracao: K+1/<max>`.
       - Se `K+1 > max`: ir para passo 4 (escalação).
       - Senão: aplicar fix para a hipótese mais provável → voltar a `c`.
-4. **Escalação (tentativas esgotadas):**
-   - Registrar `loop_status: escalated` em STATE.md.
-   - Exibir no chat: tentativas realizadas, hipóteses testadas, evidência de cada falha.
-   - Sugerir `/oxe-forensics` com contexto: "onda N falhou após <max> tentativas — hipóteses testadas: H1, H2, H3".
-5. Em toda resposta ao utilizador, manter a ordem:
-   - **Contexto lido**
-   - **Validação executada**
-   - **Resultado**
-   - **Próximo passo**
-</process>
+4. **Escalação (tentativas esgotadas):**
+   - Registrar `loop_status: escalated` em STATE.md.
+   - Exibir no chat: tentativas realizadas, hipóteses testadas, evidência de cada falha.
+   - Sugerir `/oxe-forensics` com contexto: "onda N falhou após <max> tentativas — hipóteses testadas: H1, H2, H3".
+5. Em toda resposta ao utilizador, manter a ordem:
+   - **Contexto lido**
+   - **Validação executada**
+   - **Resultado**
+   - **Próximo passo**
+</process>
 
 <success_criteria>
 - [ ] STATE.md tem campos `loop_*` atualizados a cada iteração.

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/obs.md

@@ -1,5 +1,9 @@
 # OXE — Workflow: obs
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-execute`.
+> Use: `/oxe-execute --note "sua observação"` para registrar durante a execução.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Registrar uma **observação contextual** em **`.oxe/OBSERVATIONS.md`** durante ou fora de uma execução. A observação é incorporada automaticamente nos próximos `/oxe-spec`, `/oxe-plan`, `/oxe-discuss` ou `/oxe-execute` sem necessidade de re-explicar.
 

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 o fluxo dos 8 comandos essenciais 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>
@@ -34,25 +34,42 @@ Aplicar a lógica completa de `oxe/workflows/next.md`:
 **Saída:** exatamente 1 passo, 1 comando, 1 frase de justificativa.
 </modo_status>
 
+<modo_pergunta>
+## Modo: Pergunta Situacional (input em linguagem natural — ex.: "onde estou?", "qual o risco?")
+
+Aplicar a lógica de `oxe/workflows/ask.md`:
+
+1. Ler `.oxe/STATE.md` global.
+2. Resolver sessão ativa → ler artefatos do escopo correto.
+3. Responder com: **Fatos** · **Inferências** · **Lacunas** · **Próximo passo**.
+
+Se a pergunta for genérica ("situação?", "o que está acontecendo?"), responder com:
+- Situação atual · Escopo ativo · Artefatos relevantes · Riscos / lacunas · Próximo passo recomendado.
+</modo_pergunta>
+
 <modo_route>
-## Modo: Roteamento de Linguagem Natural (input com contexto)
+## Modo: Roteamento de Linguagem Natural (input com contexto de tarefa/ação)
 
 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" | **scan** (modo refresh se codebase/ existir) |
-| "pesquisa / spike / quero entender X" | **research** |
-| "revisa PR / diff" | **review-pr** |
-| "auditoria de segurança" | **security** |
+| "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`** |
+| "revisa PR / diff" | **`/oxe-verify --pr`** |
+| "auditoria de segurança" | **`/oxe-verify --security`** |
 | "valida / verifica" | **verify** |
-| "milestone / release / versão" | **project milestone** |
-| "trilha paralela / workstream" | **project workstream** |
-| "snapshot / checkpoint" | **project checkpoint** |
-| "recuperação / erro / algo quebrou" | **forensics** |
-| "debug / teste falhando" | **debug** |
-| "obs / observação / nota" | **obs** |
+| "commita / entrega / ship" | **`/oxe-ship`** |
+| "milestone / release / versão" | **`/oxe-session milestone`** |
+| "trilha paralela / workstream" | **`/oxe-session workstream`** |
+| "snapshot / checkpoint" | **`/oxe-execute --checkpoint "<nome>"`** |
+| "recuperação / erro / algo quebrou" | **`/oxe-execute --deep-diagnosis`** |
+| "debug / teste falhando" | **`/oxe-execute --debug`** |
+| "obs / observação / nota" | **`/oxe-execute --note "..."`** |
 | "atualiza / update OXE" | **update** |
 
 Se o input não mapear claramente → apresentar 2 opções mais prováveis e perguntar.
@@ -63,27 +80,33 @@ Se o input não mapear claramente → apresentar 2 opções mais prováveis e pe
 
 Apresentar de forma concisa:
 
-### Os 8 comandos que você precisa conhecer
+### A trilha principal (6 comandos)
 
 ```
-/oxe              → onde estou / o que faço / help
-/oxe-obs          → registrei algo importante agora
+/oxe              → onde estou / o que faço / help (entrada universal)
 /oxe-quick        → tarefa pequena, sem cerimônia
-/oxe-scan         → mapeia o projeto (ou atualiza o mapa)
-/oxe-spec         → nova feature ou entrega: perguntas → requisitos → roteiro
+/oxe-spec         → nova feature: perguntas → requisitos → roteiro
+                    (absorve scan, research e ui-spec quando necessário)
 /oxe-plan         → detalhar em tarefas (--agents para multi-agente)
-/oxe-execute      → implementar (A: completo | B: por onda | C: por tarefa)
-/oxe-verify       → validar que está pronto
+/oxe-execute      → implementar A/B/C
+                    (absorve obs, debug, forensics, checkpoint, loop)
+/oxe-verify       → validar e fechar o ciclo
+                    (absorve gaps, security, ui-review, review-pr, retro)
 ```
 
 ### A cadeia
 
 ```
-/oxe-obs (qualquer momento)
-     ↓
-/oxe-scan → /oxe-spec → /oxe-plan → /oxe-execute → /oxe-verify → /oxe-retro
-                                  ↓
-                           /oxe-quick (trabalho pequeno)
+/oxe → /oxe-spec → /oxe-plan → /oxe-execute → /oxe-verify
+                       ↓
+                  /oxe-quick (trabalho pequeno)
+```
+
+### Trilha avançada
+
+```
+/oxe-session      → criar, alternar, retomar, fechar ou migrar sessões
+/oxe-dashboard    → visualizar runtime, ondas, checkpoints e estado operacional
 ```
 
 ### Para saber o próximo passo agora
@@ -92,24 +115,34 @@ Apresentar de forma concisa:
 /oxe
 ```
 
-### Escape hatches (não precisa decorar — aparecem quando necessários)
-
-`/oxe-research`, `/oxe-forensics`, `/oxe-debug`, `/oxe-loop`, `/oxe-security`,
-`/oxe-validate-gaps`, `/oxe-ui-spec`, `/oxe-ui-review`, `/oxe-review-pr`,
-`/oxe-project` (milestone, workstream, checkpoint)
+### Comportamentos especializados (ativados automaticamente ou por flag)
+
+Não precisam ser decorados como comandos separados:
+- scan/refresh → `/oxe-spec --refresh` ou `/oxe-spec --full`
+- research/spike → `/oxe-spec --research`
+- ui-spec → `/oxe-spec --ui`
+- obs/nota → `/oxe-execute --note "..."`
+- debug → `/oxe-execute --debug`
+- forensics → `/oxe-execute --deep-diagnosis`
+- gaps → `/oxe-verify --gaps`
+- security → `/oxe-verify --security`
+- ui-review → `/oxe-verify --ui`
+- review-pr → `/oxe-verify --pr`
 </modo_help>
 
 <process>
 1. Verificar se há input adicional na mensagem:
    - **Sem input ou "next / o que faço / status":** aplicar `<modo_status>`.
    - **"help / comandos / o que é OXE":** aplicar `<modo_help>`.
-   - **Qualquer outra coisa (linguagem natural com contexto):** aplicar `<modo_route>` e, se o workflow for claro, carregar e executar diretamente o `oxe/workflows/<nome>.md` correspondente.
+   - **Pergunta situacional** ("onde estou?", "qual o risco?", "o que está acontecendo?", "me contextualize"): aplicar `<modo_pergunta>`.
+   - **Input de ação/tarefa** (linguagem natural com contexto operacional): aplicar `<modo_route>` e, se o workflow for claro, carregar e executar diretamente o `oxe/workflows/<nome>.md` correspondente.
 2. Nunca produzir listas longas de alternativas. Um passo, um comando, uma frase.
 3. Se o workflow executado diretamente gerar artefatos, reportar no chat conforme esse workflow.
 </process>
 
 <success_criteria>
-- [ ] Usuário recebe exatamente 1 próximo passo (modo status) OU 1 workflow executado (modo route) OU o bloco help compacto (modo help).
+- [ ] Usuário recebe exatamente 1 próximo passo (modo status) OU 1 workflow executado (modo route) OU o bloco help compacto (modo help) OU resposta situacional (modo pergunta).
 - [ ] Nenhum artefato criado por este workflow diretamente (a menos que o workflow delegado o faça).
 - [ ] Nunca lista mais de 2 alternativas ao mesmo tempo.
+- [ ] Help mostra apenas os 6 comandos da trilha principal + 2 avançados; comandos especializados aparecem apenas como flags/comportamentos.
 </success_criteria>

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/project.md

@@ -1,5 +1,10 @@
 # OXE — Workflow: project (gestão de projeto)
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-session`.
+> Use: `/oxe-session milestone <ação>` ou `/oxe-session workstream <ação>`.
+> Checkpoints agora via `/oxe-execute --checkpoint "<nome>"`.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Ponto de entrada unificado para as três operações de gestão de projeto OXE:
 
@@ -14,7 +19,7 @@ Detecta a operação pelo primeiro token do input e delega ao workflow canônico
 - Este workflow é um **dispatcher**: lê o input, identifica a operação e executa o workflow correto.
 - Workflows canônicos: `oxe/workflows/milestone.md`, `oxe/workflows/workstream.md`, `oxe/workflows/checkpoint.md`.
 - Se o input for ambíguo, apresentar as 3 operações disponíveis e pedir escolha.
-- Sem input: mostrar o estado atual de milestones e workstreams ativos lendo `STATE.md`, `.oxe/global/MILESTONES.md` e `CHECKPOINTS.md` do escopo atual da sessão.
+- Sem input: mostrar o estado atual de milestones e workstreams ativos lendo `STATE.md`, `.oxe/global/MILESTONES.md` e `CHECKPOINTS.md` do escopo atual da sessão.
 </context>
 
 <dispatch_table>

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