oxe-cc 1.0.0 → 1.2.1

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": [

package/oxe/workflows/research.md

@@ -1,25 +1,29 @@
 # OXE — Workflow: research
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-spec`.
+> Use: `/oxe-spec --research` ou `/oxe-spec --deep` para spike/pesquisa explícita.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
-Produzir **notas de pesquisa rastreáveis** em `research/YYYY-MM-DD-<slug>.md` do escopo resolvido e manter `RESEARCH.md` correspondente como **índice e histórico** (ligações, tipo, estado, resumo). Serve para qualquer incerteza antes de um plano pesado: spikes, comparação de tecnologias, due diligence, requisitos ambíguos, **e** — com profundidade quando pedido — compreensão de **sistemas grandes**, **engenharia reversa / brownfield** e **hipóteses de modernização** (sempre ligadas a evidência ou suposições explícitas).
+Produzir **notas de pesquisa rastreáveis** em `research/YYYY-MM-DD-<slug>.md` do escopo resolvido e manter `RESEARCH.md` correspondente como **índice e histórico** (ligações, tipo, estado, resumo). Serve para qualquer incerteza antes de um plano pesado: spikes, comparação de tecnologias, due diligence, requisitos ambíguos, **e** — com profundidade quando pedido — compreensão de **sistemas grandes**, **engenharia reversa / brownfield** e **hipóteses de modernização** (sempre ligadas a evidência ou suposições explícitas).
 
 Não substitui **SPEC** nem **PLAN**; alimenta decisões que depois entram na SPEC ou no PLAN.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-discovery.md`. A investigação deve separar fatos, inferências e lacunas antes de consolidar conclusões.
-- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, research vive em `.oxe/<active_session>/research/`; sem sessão ativa, usar `.oxe/research/`.
-- Tratar pesquisa como **investigação estruturada**, não como nota solta. Cada investigação deve ter objetivo, fontes, modo, profundidade, conclusões e impacto na trilha.
-- **Uma sessão = um ficheiro novo** em `research/`; não sobrescrever notas antigas salvo correção explícita do utilizador.
+<context>
+- Aplicar `oxe/workflows/references/reasoning-discovery.md`. A investigação deve separar fatos, inferências e lacunas antes de consolidar conclusões.
+- Resolver `active_session` conforme `oxe/workflows/references/session-path-resolution.md`. Com sessão ativa, research vive em `.oxe/<active_session>/research/`; sem sessão ativa, usar `.oxe/research/`.
+- Tratar pesquisa como **investigação estruturada**, não como nota solta. Cada investigação deve ter objetivo, fontes, modo, profundidade, conclusões e impacto na trilha.
+- **Uma sessão = um ficheiro novo** em `research/`; não sobrescrever notas antigas salvo correção explícita do utilizador.
 - Nome do ficheiro: **`YYYY-MM-DD-<slug-kebab>.md`** (data ISO do dia acordado na mensagem ou data atual; slug único, curto, ASCII preferível).
-- **Índice:** `RESEARCH.md` do mesmo escopo deve conter tabela **Histórico** (mais recente primeiro) com colunas: **Data** | **Ficheiro** (`research/...`) | **Tema / âmbito** | **Tipo** (ex.: spike, mapa-sistema, reversa, modernização, decisão) | **Estado** (decidido / pendente / parcial) | **Resumo** (uma linha). Opcional: bloco **Última sessão** no topo com link para a nota mais recente.
+- **Índice:** `RESEARCH.md` do mesmo escopo deve conter tabela **Histórico** (mais recente primeiro) com colunas: **Data** | **Ficheiro** (`research/...`) | **Tema / âmbito** | **Tipo** (ex.: spike, mapa-sistema, reversa, modernização, decisão) | **Estado** (decidido / pendente / parcial) | **Resumo** (uma linha). Opcional: bloco **Última sessão** no topo com link para a nota mais recente.
 - Preferir **`.oxe/SPEC.md`** existente; se o pedido for mapear/reverter **antes** de spec, criar a nota mesmo assim com **Contexto** a declarar ausência de SPEC e próximo passo `oxe:spec`.
 - **Progressive disclosure:** sistemas grandes → profundidade por área; várias sessões/notas datadas em vez de um único ficheiro enorme.
-- Template: **`oxe/templates/RESEARCH.template.md`**.
-- Ler `INVESTIGATIONS.md` e investigações anteriores do escopo resolvido antes de abrir nova pesquisa sobre o mesmo assunto.
-- Ler `.oxe/CAPABILITIES.md` quando a investigação depender de capability local, script ou conector já existente.
-- Segurança: não gravar segredos nem valores de variáveis de ambiente.
-</context>
+- Template: **`oxe/templates/RESEARCH.template.md`**.
+- Ler `INVESTIGATIONS.md` e investigações anteriores do escopo resolvido antes de abrir nova pesquisa sobre o mesmo assunto.
+- Ler `.oxe/CAPABILITIES.md` quando a investigação depender de capability local, script ou conector já existente.
+- Segurança: não gravar segredos nem valores de variáveis de ambiente.
+</context>
 
 <thinking_depth>
 ## Profundidade de Raciocínio
@@ -38,25 +42,25 @@ Anotar `thinking_depth: surface | standard | deep` no frontmatter da nota de pes
 </thinking_depth>
 
 <process>
-1. Garantir pastas `.oxe/` e `research/` do escopo resolvido.
+1. Garantir pastas `.oxe/` e `research/` do escopo resolvido.
 2. Escolher `YYYY-MM-DD-<slug>.md` único; se colisão, acrescentar sufixo ao slug (ex. `-b`).
-3. Criar a nota a partir de `RESEARCH.template.md`: preencher secções **base**; preencher secções de **reforço** ou marcar **N/A** com justificação curta quando o âmbito for sistema grande, reversa ou modernização.
-4. Se `RESEARCH.md` do escopo resolvido não existir, criá-lo com título `# OXE — Índice de pesquisa`, parágrafo introdutório, secção **Histórico** com cabeçalho de tabela e primeira linha.
-5. Se já existir, **atualizar** `RESEARCH.md` do escopo resolvido: nova linha no topo da tabela **Histórico** (mais recente primeiro); opcionalmente atualizar **Última sessão** com link para o ficheiro novo.
-6. Atualizar `INVESTIGATIONS.md` do escopo resolvido com objetivo, fontes, modo, profundidade, conclusão e impacto na trilha. Se não existir, criá-lo.
-7. Ler **`.oxe/SPEC.md`**, **`.oxe/codebase/*`** e código alvo (Glob/Grep/Read) conforme âmbito.
-8. Atualizar **`.oxe/STATE.md`**: nota de fase / próximo passo típico `oxe:plan`, ou `oxe:spec` se faltar contrato, ou `oxe:ui-spec` se o foco for UI antes do plano.
-9. Responder no chat em 5–10 linhas, nesta ordem:
-   - **Fatos**
-   - **Inferências**
-   - **Lacunas**
-   - **Próximo passo**
-   Incluir o caminho da nota nova e a confirmação de atualização do índice.
-</process>
+3. Criar a nota a partir de `RESEARCH.template.md`: preencher secções **base**; preencher secções de **reforço** ou marcar **N/A** com justificação curta quando o âmbito for sistema grande, reversa ou modernização.
+4. Se `RESEARCH.md` do escopo resolvido não existir, criá-lo com título `# OXE — Índice de pesquisa`, parágrafo introdutório, secção **Histórico** com cabeçalho de tabela e primeira linha.
+5. Se já existir, **atualizar** `RESEARCH.md` do escopo resolvido: nova linha no topo da tabela **Histórico** (mais recente primeiro); opcionalmente atualizar **Última sessão** com link para o ficheiro novo.
+6. Atualizar `INVESTIGATIONS.md` do escopo resolvido com objetivo, fontes, modo, profundidade, conclusão e impacto na trilha. Se não existir, criá-lo.
+7. Ler **`.oxe/SPEC.md`**, **`.oxe/codebase/*`** e código alvo (Glob/Grep/Read) conforme âmbito.
+8. Atualizar **`.oxe/STATE.md`**: nota de fase / próximo passo típico `oxe:plan`, ou `oxe:spec` se faltar contrato, ou `oxe:ui-spec` se o foco for UI antes do plano.
+9. Responder no chat em 5–10 linhas, nesta ordem:
+   - **Fatos**
+   - **Inferências**
+   - **Lacunas**
+   - **Próximo passo**
+   Incluir o caminho da nota nova e a confirmação de atualização do índice.
+</process>
 
 <success_criteria>
-- [ ] Existe novo ficheiro em `research/YYYY-MM-DD-<slug>.md` no escopo correto com secções base preenchidas de forma útil.
-- [ ] `RESEARCH.md` do mesmo escopo existe e a tabela **Histórico** inclui a nova entrada.
+- [ ] Existe novo ficheiro em `research/YYYY-MM-DD-<slug>.md` no escopo correto com secções base preenchidas de forma útil.
+- [ ] `RESEARCH.md` do mesmo escopo existe e a tabela **Histórico** inclui a nova entrada.
 - [ ] Nenhuma nota anterior foi sobrescrita sem instrução explícita do utilizador.
 - [ ] `STATE.md` reflete o progresso e o próximo passo sugerido.
 </success_criteria>

package/oxe/workflows/retro.md

@@ -1,5 +1,9 @@
 # OXE — Workflow: retro (retrospectiva de ciclo)
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-verify`.
+> A retrospectiva agora é executada automaticamente ao fechar `/oxe-verify` (use `--skip-retro` para desativar).
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Sintetizar os aprendizados de um ciclo completo (spec → verify) em **`.oxe/LESSONS.md`** — um arquivo prescritivo e cumulativo que alimenta automaticamente ciclos futuros.
 

package/oxe/workflows/review-pr.md

@@ -1,12 +1,16 @@
 # OXE — Workflow: review-pr (revisão de diff / PR)
 
+> **[DEPRECATED v1.1.0]** Este comando foi incorporado por `/oxe-verify`.
+> Use: `/oxe-verify --pr` (branch atual) ou `/oxe-verify --diff branchA...branchB`.
+> Este alias continuará funcionando nesta versão por compatibilidade.
+
 <objective>
 Rever alterações como num pull request: **URL do GitHub** (`…/pull/<n>`), **branches** ou **SHAs**. Cobre diff, risco, convenções do projeto e sugestões acionáveis. **Não** substitui CI nem testes manuais; complementa-os.
 </objective>
 
-<context>
-- Aplicar `oxe/workflows/references/reasoning-review.md`. A revisão deve ser findings-first, com severidade e evidência antes de qualquer resumo.
-- **Base** e **head** são nomes de branch, tags ou SHAs (ex.: `main` e `feature/foo`).
+<context>
+- Aplicar `oxe/workflows/references/reasoning-review.md`. A revisão deve ser findings-first, com severidade e evidência antes de qualquer resumo.
+- **Base** e **head** são nomes de branch, tags ou SHAs (ex.: `main` e `feature/foo`).
 - **URL de PR no GitHub** — O usuário pode colar o link (ex.: `https://github.com/org/repo/pull/10` ou atalho `org/repo#10`). O número da PR é o segmento depois de `/pull/`.
 - Em Git, o diff “estilo PR” (só o que a branch introduz) usa o **merge base**: `git diff base...head` (três pontos).
 - Diff literal entre pontas: `git diff base..head` (dois pontos) — útil quando o usuário pede explicitamente.
@@ -29,14 +33,14 @@ Rever alterações como num pull request: **URL do GitHub** (`…/pull/<n>`), **
    Se o sandbox bloquear Git, pedir ao usuário que cole o output de `git diff base...head` ou use o diff da UI do GitHub/GitLab.
    Se o diff já foi obtido no passo 2 (URL da PR), **não** repetir este passo.
 4. **Ler contexto do projeto** — Se existirem, usar trechos relevantes de `.oxe/codebase/CONVENTIONS.md`, `STACK.md`, `OVERVIEW.md` e, se aplicável, `.oxe/SPEC.md` / `.oxe/PLAN.md` para alinhar expectativas (sem assumir que o PR cobre só OXE).
-5. **Analisar** — Estruturar a resposta com:
-   - **Findings** — achados ordenados por severidade, com arquivo/área afetada e evidência.
-   - **Arquivos / áreas** — Agrupar por domínio (API, UI, config, etc.).
-   - **Riscos** — Regressões, breaking changes, segurança (inputs, segredos, auth), desempenho óbvio, migrações.
-   - **Testes** — O que deveria ser coberto ou rodar localmente (comandos sugeridos se conhecidos do repo).
-   - **Perguntas abertas** — pontos que impedem confiança alta na revisão.
-   - **Resumo** — O que muda em 3–6 frases, apenas depois dos achados.
-   - **Checklist PR** — Título sugerido, descrição curta, breaking changes, rollback.
+5. **Analisar** — Estruturar a resposta com:
+   - **Findings** — achados ordenados por severidade, com arquivo/área afetada e evidência.
+   - **Arquivos / áreas** — Agrupar por domínio (API, UI, config, etc.).
+   - **Riscos** — Regressões, breaking changes, segurança (inputs, segredos, auth), desempenho óbvio, migrações.
+   - **Testes** — O que deveria ser coberto ou rodar localmente (comandos sugeridos se conhecidos do repo).
+   - **Perguntas abertas** — pontos que impedem confiança alta na revisão.
+   - **Resumo** — O que muda em 3–6 frases, apenas depois dos achados.
+   - **Checklist PR** — Título sugerido, descrição curta, breaking changes, rollback.
 6. **Opcional em disco** — Se o usuário pedir registro: criar ou atualizar **`.oxe/PR-REVIEW.md`** com data, URL ou refs (base/head), resumo, achados e próximos passos (Markdown legível).
 </process>