oxe-cc 0.9.3 → 1.2.1

package/oxe/workflows/execute.md

@@ -1,8 +1,36 @@
 # OXE — Workflow: execute
 
 <objective>
-Guiar a **implementação** de um plano OXE com dois modos possíveis:
+Guiar a **implementação** de um plano OXE com dois modos possíveis.
 
+**Flags suportadas:**
+- `--note "texto"` — registrar observação contextual em `OBSERVATIONS.md` antes de iniciar a execução (equivalente a `/oxe-obs`). Pode ser usado com qualquer outro argumento.
+- `--debug` — ativar diagnóstico técnico explícito ao primeiro sinal de falha em vez de esperar 2 tentativas (equivalente a `/oxe-debug`). Fornece stack trace detalhado, hipóteses e fix.
+- `--deep-diagnosis` — iniciar diretamente em modo de diagnóstico pós-falha persistente (equivalente a `/oxe-forensics`). Usar quando a execução já falhou repetidamente e o estado está corrompido ou inconsistente.
+- `--checkpoint "<nome>"` — criar snapshot nomeado do estado da sessão antes de iniciar ou após concluir (equivalente a `/oxe-checkpoint`). Útil antes de experimentos ou ondas arriscadas.
+- `--iterative` — ativar modo B com loop automático até verify passar, com retry controlado por `loop_max` (equivalente a `/oxe-loop`).
+
+**Nota de compatibilidade v1.1.0:** `/oxe-obs`, `/oxe-debug`, `/oxe-forensics`, `/oxe-checkpoint` e `/oxe-loop` foram incorporados por este comando. Esses comandos legados continuam funcionando mas exibem aviso de migração.
+
+</objective>
+
+<flags_processing>
+## Processamento de flags (executar antes do step 1)
+
+Ao receber qualquer argumento, verificar flags antes de iniciar o fluxo principal:
+
+1. **`--note "texto"`**: escrever entrada em `OBSERVATIONS.md` do escopo resolvido com status `pendente`, impacto `execute`, severidade `info`. Marcar como `incorporada → execute (data)` imediatamente após registrar. Continuar com o fluxo normal.
+
+2. **`--checkpoint "<nome>"`**: executar a lógica de `oxe/workflows/checkpoint.md` com o slug fornecido antes de iniciar a onda. Reportar confirmação do snapshot. Continuar.
+
+3. **`--deep-diagnosis`**: saltar diretamente para o fluxo de `oxe/workflows/forensics.md` com o contexto atual do `EXECUTION-RUNTIME.md` e `STATE.md`. Não iniciar nova onda sem resolução explícita.
+
+4. **`--debug`**: ajustar `<failure_mode>` para acionar diagnóstico imediato na primeira falha (sem 2 tentativas antes). Reportar hipóteses, evidências e fix com mais detalhe.
+
+5. **`--iterative`**: registrar em STATE.md: `execute_mode: por_onda` e `loop_max: 3` (ou o valor de config). Informar ao usuário que o modo iterativo está ativo.
+</flags_processing>
+
+<execution_modes>
 **Modo Solo (padrão):** seguir `PLAN.md` do escopo resolvido da sessão onda a onda sem `plan-agents.json`. O agente implementa diretamente cada tarefa Tn da onda atual, roda a verificação e avança. Não exige nenhum artefato além do PLAN.md.
 
 **Modo com Agentes (extensão):** quando existe `plan-agents.json` válido no escopo resolvido (schema 2+, lifecycle ativo, runId alinhado ao STATE), adotar roles e personas por agente conforme o blueprint.
@@ -10,7 +38,7 @@ Guiar a **implementação** de um plano OXE com dois modos possíveis:
 **Seleção de execução (redução de requisições):** quando o plano tem 2+ ondas, o usuário escolhe entre Completo (1 sessão), Por onda (N sessões) ou Por tarefa (N tarefas). A escolha é feita **uma vez** no início.
 
 Se existir apenas **`QUICK.md`** no escopo resolvido: tratar passos numerados como onda única (modo sempre Completo).
-</objective>
+</execution_modes>
 
 <modo_solo>
 ## Modo Solo — Execução direta do PLAN.md

package/oxe/workflows/forensics.md

@@ -1,14 +1,18 @@
 # OXE — Workflow: forensics
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-execute`.
+> Use: `/oxe-execute --deep-diagnosis` para diagnóstico pós-falha persistente.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Diagnosticar **incidentes de fluxo** após falha ou incoerência entre artefatos `.oxe/`, Git e saída de `oxe-cc doctor`: produzir **`FORENSICS.md`** no escopo resolvido com linha do tempo, hipótese de causa e **exatamente um** próximo passo canónico OXE (`scan`, `plan` ou `execute` — incluindo ações como reinstalar workflows ou correr verify como parte do movimento **execute**).
 
 Não reescrever `SPEC.md` nem apagar `PLAN.md`; apenas **recomendar** o reingresso na trilha.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-execution.md` para montar a linha do tempo e `oxe/workflows/references/reasoning-status.md` para devolver um único reingresso recomendado.
-- Usar quando: `VERIFY.md` com falhas ou gaps não explicados, `oxe-cc doctor` com **FALHA**, `STATE.md` contradiz ficheiros presentes (ex.: “onda concluída” sem `VERIFY.md`), ou o utilizador indica estar **preso** após várias tentativas de replan.
+<context>
+- Aplicar `oxe/workflows/references/reasoning-execution.md` para montar a linha do tempo e `oxe/workflows/references/reasoning-status.md` para devolver um único reingresso recomendado.
+- Usar quando: `VERIFY.md` com falhas ou gaps não explicados, `oxe-cc doctor` com **FALHA**, `STATE.md` contradiz ficheiros presentes (ex.: “onda concluída” sem `VERIFY.md`), ou o utilizador indica estar **preso** após várias tentativas de replan.
 - Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`; ler `.oxe/STATE.md` global e os artefatos de sessão (`VERIFY.md`, `PLAN.md`, `SPEC.md`, `QUICK.md`) no escopo resolvido.
 - **Git é opcional:** em sandbox sem Git ou sem permissão de terminal, **não** falhar o workflow; registar em `FORENSICS.md` que Git não foi avaliado.
 - Opcional: saída resumida de `npx oxe-cc doctor` no diretório do projeto.
@@ -33,12 +37,12 @@ Não reescrever `SPEC.md` nem apagar `PLAN.md`; apenas **recomendar** o reingres
    - **Próximo passo OXE recomendado:** **um único** valor entre `scan` | `plan` | `execute` e o **comando** correspondente (`/oxe-scan`, `/oxe-plan`, `/oxe-execute` ou `npx oxe-cc@latest` / `npx oxe-cc doctor` quando a causa for tooling).
    - **Justificativa** — uma frase que liga evidência ao passo escolhido.
 4. Atualizar **`.oxe/STATE.md`** global com uma linha opcional sob decisões ou contexto: referência a `FORENSICS.md` e fase sugerida (ex.: `forensics_complete` → próximo conforme passo recomendado).
-5. Responder no chat em ≤8 linhas, nesta ordem:
-   - **Leitura atual**
-   - **Hipótese de causa**
-   - **Próximo passo**
-   - **Motivo**
-</process>
+5. Responder no chat em ≤8 linhas, nesta ordem:
+   - **Leitura atual**
+   - **Hipótese de causa**
+   - **Próximo passo**
+   - **Motivo**
+</process>
 
 <success_criteria>
 - [ ] `FORENSICS.md` existe no escopo correto com **Próximo passo OXE recomendado** igual a **um** entre `scan`, `plan`, `execute`.

package/oxe/workflows/help.md

@@ -26,9 +26,12 @@ Escolha a complexidade certa. Comece simples e adicione estrutura quando precisa
 
 **Standard** — ciclo completo para features e refatorações:
 ```
-/oxe-scan → /oxe-spec → /oxe-plan → /oxe-execute → /oxe-verify → /oxe-retro
+/oxe → /oxe-spec → /oxe-plan → /oxe-execute → /oxe-verify
 ```
 
+> scan, research, debug, retro e validações especializadas são acionados automaticamente
+> dentro dos estágios corretos ou por flags explícitas.
+
 **Full** — sessões, multi-agente, dashboard, capabilities:
 ```
 /oxe-session new <nome> → /oxe-plan --agents → /oxe-execute → /oxe-dashboard (opt-in)
@@ -36,25 +39,40 @@ Escolha a complexidade certa. Comece simples e adicione estrutura quando precisa
 
 ---
 
-## Comandos principais
+## Trilha principal
+
+Estes são os únicos comandos que você precisa conhecer para seguir o framework:
 
 ```
-/oxe              → onde estou / o que faço / help (entrada universal)
-/oxe-ask          → entender a situação atual com leitura robusta de STATE + sessão + artefatos
-/oxe-obs          → registrei algo importante — incorporado automaticamente nos próximos passos
+/oxe              → onde estou / o que faço / help (entrada universal + perguntas situacionais)
 /oxe-quick        → tarefa pequena, sem cerimônia (com agentes lean quando necessário)
-/oxe-capabilities → listar, instalar, remover ou atualizar capabilities nativas do projeto
-/oxe-session      → criar, alternar, retomar, fechar ou migrar sessões OXE
-/oxe-cc azure     → autenticar, sincronizar inventário e operar Azure Service Bus, Event Grid e Azure SQL com checkpoint
-/oxe-scan         → mapeia o projeto (ou atualiza o mapa se já existir)
 /oxe-spec         → nova feature: perguntas → pesquisa → requisitos → roteiro → aprovação
+                    Absorve: scan (--refresh / --full), research (--research / --deep), ui-spec (--ui)
 /oxe-plan         → tarefas por onda (--agents para blueprint multi-agente)
 /oxe-execute      → implementar (A: 1 sessão | B: por onda | C: por tarefa)
-/oxe-verify       → validar (camadas 5+6 opcionais via config: gaps + segurança)
+                    Absorve: obs (--note), debug (--debug), forensics (--deep-diagnosis),
+                             checkpoint (--checkpoint), loop (--iterative)
+/oxe-verify       → validar e fechar o ciclo
+                    Absorve: gaps (--gaps), security (--security), ui-review (--ui),
+                             review-pr (--pr / --diff), retro (automático)
+```
+
+## Trilha avançada
+
+```
+/oxe-session      → criar, alternar, retomar, fechar ou migrar sessões OXE
 /oxe-dashboard    → visão web opt-in para revisão de equipe e aprovação do plano
 ```
 
-Tudo o mais é ativado automaticamente por contexto, por config, ou existe como escape hatch.
+## Comandos administrativos e plataforma
+
+```
+/oxe-capabilities → listar, instalar, remover ou atualizar capabilities nativas do projeto
+/oxe-skill        → descobrir, invocar e gerenciar skills OXE via @<id>
+oxe-cc azure      → autenticar, sincronizar inventário e operar Azure com checkpoint formal
+```
+
+Tudo o mais é ativado automaticamente por contexto, por config, ou existe como flag dos estágios principais.
 
 ---
 
@@ -80,9 +98,13 @@ Tudo o mais é ativado automaticamente por contexto, por config, ou existe como
 
 ### Cursor
 
-Slash commands essenciais: `/oxe`, `/oxe-obs`, `/oxe-quick`, `/oxe-scan`, `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verify`
+Slash commands da trilha principal: `/oxe`, `/oxe-quick`, `/oxe-spec`, `/oxe-plan`, `/oxe-execute`, `/oxe-verify`
+
+Slash commands avançados: `/oxe-session`, `/oxe-dashboard`
 
-Slash commands completos: `/oxe-discuss`, `/oxe-plan-agent`, `/oxe-project`, `/oxe-loop`, `/oxe-security`, `/oxe-update`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-validate-gaps`, `/oxe-compact`, `/oxe-checkpoint`, `/oxe-ui-spec`, `/oxe-ui-review`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-skill`, `/oxe-next`, `/oxe-help` (instalados em `~/.cursor/commands/` pelo `oxe-cc`). **Review de PR:** no Cursor não há slash dedicado — peça em linguagem natural seguindo `oxe/workflows/review-pr.md` em contexto.
+Slash commands administrativos / plataforma: `/oxe-capabilities`, `/oxe-skill`, `/oxe-update`
+
+Slash commands legados (ainda funcionam, exibem aviso de migração): `/oxe-ask`, `/oxe-obs`, `/oxe-scan`, `/oxe-research`, `/oxe-debug`, `/oxe-forensics`, `/oxe-loop`, `/oxe-checkpoint`, `/oxe-ui-spec`, `/oxe-ui-review`, `/oxe-security`, `/oxe-validate-gaps`, `/oxe-review-pr`, `/oxe-retro`, `/oxe-project`, `/oxe-compact`, `/oxe-route`, `/oxe-next`, `/oxe-discuss`, `/oxe-plan-agent`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-help` (instalados em `~/.cursor/commands/` pelo `oxe-cc`).
 
 ### GitHub Copilot (VS Code)
 
@@ -117,26 +139,29 @@ Com **`compact_max_age_days`** em `.oxe/config.json` (ver `oxe/templates/CONFIG.
 
 ## Fluxo completo
 
-0. **obs** *(qualquer momento)* — `/oxe-obs` registra uma observação contextual; incorporada automaticamente no próximo spec/plan/execute sem re-explicar.
-1. **scan** — após clonar ou quando o codebase mudar. **Inteligente:** se `.oxe/codebase/` já existir, opera em modo refresh (incremental) automaticamente — sem precisar chamar `/oxe-compact` separadamente. Use `--full` para forçar scan completo. Repositórios **legado** (COBOL, JCL, VB6): aplica `legacy-brownfield.md` automaticamente.
-2. **spec** — fluxo em **5 fases**: perguntas (máx 3 rodadas) → pesquisa (proposta inline na Fase 2, sem sair do spec) → requisitos R-ID (v1/v2/fora) → roteiro (`.oxe/ROADMAP.md`) → aprovação. Se `discuss_before_plan: true` na config, o próximo passo após aprovação é `oxe:discuss` antes de plan.
-3. **plan** — plano executável + **Verificar** por tarefa. Se 3+ domínios distintos, **sugere automaticamente** blueprint de agentes (`/oxe-plan --agents`). Sem `--agents`: solo. Com `--agents`: gera também `plan-agents.json` (schema 3 com `model_hint`).
-4. **execute** — modo selecionado 1 vez: **A) Completo** (1 sessão), **B) Por onda**, **C) Por tarefa**. Antes de executar, validar a **Autoavaliação do Plano**: se `Melhor plano atual: não` ou a confiança estiver abaixo do limiar, o fluxo deve replanear em vez de implementar. Se Verificar falhar inline: diagnóstico automático (2-3 hipóteses + fix), sem precisar chamar `/oxe-debug` separadamente. Escalação para `/oxe-forensics` só se esgotar tentativas.
-5. **verify** — até **6 camadas** por config: auditoria pré-exec, tarefas + critérios A*, fidelidade D-NN, **coerência operacional** (runtime + checkpoints), **calibração do plano**, UAT, **gaps de cobertura** (camada 5 — `verification_depth: "thorough"`), **segurança OWASP** (camada 6 — `security_in_verify: true`). Sem comandos extras.
-6. **retro** *(opcional, recomendado após verify_complete)* — `/oxe-retro` sintetiza 3–5 lições prescritivas em `.oxe/LESSONS.md`. Cada lição diz **o que fazer diferente** no próximo ciclo — consumida automaticamente pelo próximo spec/plan.
-7. **→ próximo ciclo** — spec/plan do próximo ciclo lê LESSONS.md automaticamente. Os erros do ciclo anterior não se repetem.
-
-**Escape hatches (não precisam ser decorados — aparecem quando necessários):**
-
-- **`/oxe-forensics`** — sugerido automaticamente pelo execute/verify quando falha persiste. Diagnóstico pós-falha + 1 caminho de reentrada.
-- **`/oxe-debug`** — diagnóstico técnico inline durante execute (já integrado ao execute; disponível standalone para controle explícito).
-- **`/oxe-loop`** — iteração até verify passar (disponível standalone; integrado ao Modo B do execute via `loop_max`).
-- **`/oxe-research`** — notas datadas em `.oxe/research/` para spikes, mapas de sistema, engenharia reversa.
-- **`/oxe-capabilities`** — catálogo nativo de capabilities locais, por script ou conector, com metadata e diagnóstico.
-- **`/oxe-skill`** — descobrir, invocar e gerenciar skills (unificação de personas e capabilities via `@<id>`).
-- **`/oxe-dashboard`** — leitura visual/operacional do runtime, checkpoints e ondas ativas.
-- **`/oxe-route`** — traduz linguagem natural → comando. Equivalente a `/oxe [texto]`.
-- **`/oxe-compact`** — refresh explícito do codebase. Equivalente a `/oxe-scan` sem `--full`.
+0. **situação** — `/oxe "pergunta"` responde com base nos artefatos reais. Sem input: próximo passo.
+1. **spec** — fluxo em **5 fases**: perguntas (máx 3 rodadas) → pesquisa (proposta inline na Fase 2, sem sair do spec) → requisitos R-ID (v1/v2/fora) → roteiro (`.oxe/ROADMAP.md`) → aprovação.
+   - `/oxe-spec --refresh` — atualiza o mapa do codebase antes de spec (modo incremental)
+   - `/oxe-spec --full` — força scan completo antes de spec
+   - `/oxe-spec --research` — ativa pesquisa/spike explícita na Fase 2
+   - `/oxe-spec --ui` — gera contrato UI-SPEC ao final da spec
+   - Se `discuss_before_plan: true` na config, o próximo passo após aprovação é `oxe:discuss` antes de plan.
+2. **plan** — plano executável + **Verificar** por tarefa. Se 3+ domínios distintos, **sugere automaticamente** blueprint de agentes (`/oxe-plan --agents`). Sem `--agents`: solo. Com `--agents`: gera também `plan-agents.json` (schema 3 com `model_hint`).
+3. **execute** — modo selecionado 1 vez: **A) Completo** (1 sessão), **B) Por onda**, **C) Por tarefa**. Antes de executar, valida a **Autoavaliação do Plano**. Se Verificar falhar inline: diagnóstico automático (2-3 hipóteses + fix). Escalação automática para diagnóstico profundo se esgotar tentativas.
+   - `/oxe-execute --note "texto"` — registra observação contextual durante a execução
+   - `/oxe-execute --debug` — ativa diagnóstico técnico explícito (stack trace, teste vermelho)
+   - `/oxe-execute --deep-diagnosis` — diagnóstico pós-falha persistente + caminho de reentrada
+   - `/oxe-execute --checkpoint "nome"` — cria snapshot nomeado do estado da sessão
+   - `/oxe-execute --iterative` — loop de retry até verify passar (Modo B com `loop_max`)
+4. **verify** — até **6 camadas** por config: auditoria pré-exec, tarefas + critérios A*, fidelidade D-NN, **coerência operacional** (runtime + checkpoints), **calibração do plano**, UAT, **gaps de cobertura**, **segurança OWASP**. Sem comandos extras.
+   - `/oxe-verify --gaps` — ativa auditoria de cobertura explicitamente (Camada 5)
+   - `/oxe-verify --security` — ativa auditoria OWASP explicitamente (Camada 6)
+   - `/oxe-verify --ui` — inclui auditoria de implementação UI (exige UI-SPEC.md)
+   - `/oxe-verify --pr` — inclui revisão de PR ou diff de branches
+   - `/oxe-verify --diff branchA...branchB` — revisão de diff específico
+   - `/oxe-verify --skip-retro` — pula a retrospectiva automática ao final
+   - **Retro automática:** ao fechar `verify_complete`, sintetiza 3–5 lições em `.oxe/LESSONS.md` (pode ser desativada com `--skip-retro`).
+5. **→ próximo ciclo** — spec/plan do próximo ciclo lê LESSONS.md automaticamente.
 
 **Gestão de projeto (`/oxe-project`):**
 
@@ -192,26 +217,49 @@ Um pedido → **um** destino (sem gerar contrato). O agente aplica `route.md` ou
 
 | Se o utilizador disser (exemplos) | Comando / ação |
 |-----------------------------------|----------------|
-| Não sei que passo OXE sou / “o que faço agora?” | `/oxe-next` ou `npx oxe-cc status` |
-| Quero entender rapidamente a situação real da trilha atual | `/oxe-ask [pergunta]` |
+| Não sei que passo OXE sou / “o que faço agora?” | `/oxe` ou `npx oxe-cc status` |
+| Quero entender rapidamente a situação real da trilha atual | `/oxe “pergunta”` |
 | Acabei de clonar / falta OXE no projeto | `npx oxe-cc@latest` (ou `oxe-cc`) na raiz do repo |
-| Verify falhou várias vezes / doctor estranho / artefatos incoerentes | `/oxe-forensics` |
-| Teste ou erro técnico durante o trabalho (stack, flake) | `/oxe-debug` (com **Tn** se houver) |
-| Revisar diff / PR antes do merge | `oxe/workflows/review-pr.md` em contexto *(Copilot: `/oxe-review-pr`)* |
-| O que é OXE / lista de passos | `/oxe-help` |
-| Dúvida entre dois comandos sem contexto claro | `/oxe-route` |
-| Pesquisa técnica, spike, mapa de sistema grande, engenharia reversa, modernização antes do plano | `/oxe-research` |
-| Quero registrar uma observação (restrição, descoberta, preferência) durante ou fora de execução | `/oxe-obs [texto]` |
+| Verify falhou várias vezes / doctor estranho / artefatos incoerentes | `/oxe-execute --deep-diagnosis` |
+| Teste ou erro técnico durante o trabalho (stack, flake) | `/oxe-execute --debug` (com **Tn** se houver) |
+| Revisar diff / PR antes do merge | `/oxe-verify --pr` ou `/oxe-verify --diff branchA...branchB` |
+| O que é OXE / lista de passos | `/oxe help` |
+| Pesquisa técnica, spike, mapa de sistema grande, engenharia reversa, modernização antes do plano | `/oxe-spec --research` |
+| Quero registrar uma observação (restrição, descoberta, preferência) durante ou fora de execução | `/oxe-execute --note “texto”` |
 | Quero executar todo o plano de uma vez (1 sessão) | `/oxe-execute` → escolher opção A (Completo) |
 | Quero executar onda por onda com verificação entre ondas | `/oxe-execute` → escolher opção B (Por onda) |
-| Gaps de cobertura de verificação / Nyquist-lite após verify | `/oxe-validate-gaps` |
-| Mapa OXE desatualizado / quero sincronizar codebase com o código sem scan completo | `/oxe-compact` |
-| Quero gravar um marco nomeado da sessão (antes de experimento grande) | `/oxe-checkpoint` + slug |
+| Gaps de cobertura de verificação / Nyquist-lite após verify | `/oxe-verify --gaps` |
+| Mapa OXE desatualizado / quero sincronizar codebase com o código sem scan completo | `/oxe-spec --refresh` |
+| Quero gravar um marco nomeado da sessão (antes de experimento grande) | `/oxe-execute --checkpoint “<nome>”` |
 | Plano com **blueprint de agentes** (JSON + mesmo PLAN.md) / subagentes por onda | `/oxe-plan-agent` |
-| Criar marco de entrega / versão / milestone | `/oxe-milestone new [nome]` |
-| Verificar se o milestone está pronto para fechar | `/oxe-milestone audit` |
-| Trabalho paralelo em trilhas separadas / feature branch OXE | `/oxe-workstream new <nome>` |
-| Alternar entre trilhas de desenvolvimento | `/oxe-workstream switch <nome>` |
+| Criar marco de entrega / versão / milestone | `/oxe-session milestone new [nome]` |
+| Verificar se o milestone está pronto para fechar | `/oxe-session milestone audit` |
+| Trabalho paralelo em trilhas separadas / feature branch OXE | `/oxe-session workstream new <nome>` |
+| Alternar entre trilhas de desenvolvimento | `/oxe-session workstream switch <nome>` |
+
+---
+
+## Compatibilidade (v1.1.0)
+
+Os comandos abaixo continuam funcionando mas foram incorporados pelos estágios principais:
+
+| Comando legado | Novo destino | Aviso exibido |
+|----------------|--------------|---------------|
+| `/oxe-ask` | `/oxe “pergunta”` | sim |
+| `/oxe-scan` | `/oxe-spec --refresh` | sim |
+| `/oxe-research` | `/oxe-spec --research` | sim |
+| `/oxe-ui-spec` | `/oxe-spec --ui` | sim |
+| `/oxe-obs` | `/oxe-execute --note` | sim |
+| `/oxe-debug` | `/oxe-execute --debug` | sim |
+| `/oxe-forensics` | `/oxe-execute --deep-diagnosis` | sim |
+| `/oxe-checkpoint` | `/oxe-execute --checkpoint` | sim |
+| `/oxe-loop` | `/oxe-execute --iterative` | sim |
+| `/oxe-validate-gaps` | `/oxe-verify --gaps` | sim |
+| `/oxe-security` | `/oxe-verify --security` | sim |
+| `/oxe-ui-review` | `/oxe-verify --ui` | sim |
+| `/oxe-review-pr` | `/oxe-verify --pr` | sim |
+| `/oxe-retro` | `/oxe-verify` (retro automática) | sim |
+| `/oxe-project` | `/oxe-session milestone\|workstream` | sim |
 
 ## Observações Contextuais (`/oxe-obs`)
 

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/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/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/references/workflow-runtime-contracts.json

@@ -690,6 +690,29 @@
       ],
       "extraction_intent": "execution_input"
     },
+    "ship": {
+      "reasoning_mode": "execution",
+      "required_artifacts": [
+        "state"
+      ],
+      "optional_artifacts": [
+        "spec",
+        "quick",
+        "plan",
+        "verify",
+        "summary",
+        "runtime",
+        "active_run",
+        "phase_summary",
+        "session_summary",
+        "project_summary"
+      ],
+      "blocking_conditions": [
+        "missing:verify_without_override",
+        "missing:tracked_changes"
+      ],
+      "extraction_intent": "execution_input"
+    },
     "skill": {
       "reasoning_mode": "execution",
       "required_artifacts": [