oxe-cc 0.7.1 → 0.9.1

package/.cursor/commands/oxe-validate-gaps.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)"
+argument-hint: "[opcional: foco Tn ou A*]"
+oxe_workflow_slug: validate-gaps
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 27d51ac144da4c1c
 ---
 
 OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** validate-gaps
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `27d51ac144da4c1c`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/validate-gaps.md` e `.oxe/context/packs/validate-gaps.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow validate-gaps --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/validate-gaps.md`

package/.cursor/commands/oxe-verify.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Valida implementação (.oxe/VERIFY.md)"
+argument-hint: "[opcional: Tn]"
+oxe_workflow_slug: verify
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 442bb4594208d058
 ---
 
 OXE — Valida implementação (.oxe/VERIFY.md)
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** verify
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `442bb4594208d058`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/verify.md` e `.oxe/context/packs/verify.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow verify --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
 
 `oxe/workflows/verify.md` (na raiz do repositório em contexto)

package/.cursor/commands/oxe-workstream.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/"
+argument-hint: "list | new <nome> | switch <nome> | status | close <nome>"
+oxe_workflow_slug: workstream
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 82d171363381cc0d
 ---
 
 OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** workstream
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `82d171363381cc0d`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/workstream.md` e `.oxe/context/packs/workstream.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow workstream --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/workstream.md`

package/.cursor/commands/oxe.md

@@ -1,9 +1,45 @@
 ---
-description: "OXE — Entrada universal: próximo passo / roteamento de linguagem natural / help dos 8 comandos essenciais"
+description: "OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais"
+argument-hint: "[contexto em linguagem natural | 'help' | vazio para próximo passo]"
+oxe_workflow_slug: oxe
+oxe_reasoning_mode: status
+oxe_question_policy: none
+oxe_output_contract: routing
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: d7f65cd3f77b0abc
 ---
 
+OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** oxe
+- **Modo:** estado / roteamento
+- **Perguntas:** nenhuma
+- **Saída esperada:** roteamento
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `d7f65cd3f77b0abc`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/oxe.md` e `.oxe/context/packs/oxe.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow oxe --json`
+- Responder com leitura curta e orientada a decisão.
+- Dar uma recomendação única e justificar o motivo.
+- Explicitar a confiança quando o estado estiver incompleto ou ambíguo.
+- **Seções esperadas:** Leitura atual · Recomendação · Motivo · Confiança
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-status.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/oxe.md`
 
-Sem input: mostra o próximo passo baseado no STATE.md. Com input em linguagem natural: traduz para o comando correto e executa. Com "help": mostra os 8 comandos essenciais.
+`$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → 8 comandos essenciais.

package/.github/copilot-instructions.md

@@ -1,6 +1,8 @@
 # OXE — fluxo spec-driven (multi-IDE / multi-CLI)
 
-Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** (no pacote) ou **`.oxe/workflows/*.md`** / **`oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
+Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** (no pacote) ou **`.oxe/workflows/*.md`** / **`oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
+
+Os prompts OXE carregam metadata cognitiva comum (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`). Essa metadata não substitui o workflow canónico; ela alinha a postura de raciocínio entre runtimes para discovery, planning, execution, review e status.
 
 ## Quando aplicar
 
@@ -44,16 +46,17 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 | Capabilities | `oxe/workflows/capabilities.md` | “oxe capabilities”, “listar capabilities”, “instalar capability” *(prompt: `/oxe-capabilities`)* |
 | Project | `oxe/workflows/project.md` | “oxe project”, “gestão de projeto OXE”, “milestone + workstream + checkpoint” *(prompt: `/oxe-project`)* |
 | Router | `oxe/workflows/oxe.md` | “oxe”, “que comando usar”, entrada universal *(prompt: `/oxe`)* |
+| Skill | `oxe/workflows/skill.md` | “oxe skill”, “@executor”, “@researcher”, “listar skills”, “novo skill” *(prompt: `/oxe-skill`)* |
 
 **Regra:** leia o Markdown indicado e execute **todos** os passos e critérios de sucesso descritos nesse arquivo. Não atalhe: crie ou atualize os arquivos em `.oxe/` conforme o workflow.
 
-**Cursor / Copilot / Claude:** slash `/oxe-*` disponíveis: `/oxe`, `/oxe-ask`, `/oxe-obs`, `/oxe-quick`, `/oxe-scan`, `/oxe-spec`, `/oxe-discuss`, `/oxe-plan`, `/oxe-plan-agent`, `/oxe-execute`, `/oxe-verify`, `/oxe-validate-gaps`, `/oxe-retro`, `/oxe-session`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-project`, `/oxe-checkpoint`, `/oxe-dashboard`, `/oxe-loop`, `/oxe-security`, `/oxe-capabilities`, `/oxe-next`, `/oxe-update`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-compact`, `/oxe-ui-spec`, `/oxe-ui-review` — em `~/.cursor/commands/` (gerados de `.github/prompts/` via `npm run sync:cursor`). **Não** há comando slash dedicado a review-pr — use linguagem natural + `oxe/workflows/review-pr.md` em contexto.
+**Cursor / Copilot / Claude:** slash `/oxe-*` disponíveis: `/oxe`, `/oxe-ask`, `/oxe-obs`, `/oxe-quick`, `/oxe-scan`, `/oxe-spec`, `/oxe-discuss`, `/oxe-plan`, `/oxe-plan-agent`, `/oxe-execute`, `/oxe-verify`, `/oxe-validate-gaps`, `/oxe-retro`, `/oxe-session`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-project`, `/oxe-checkpoint`, `/oxe-dashboard`, `/oxe-loop`, `/oxe-security`, `/oxe-capabilities`, `/oxe-skill`, `/oxe-next`, `/oxe-update`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-compact`, `/oxe-ui-spec`, `/oxe-ui-review` — em `~/.cursor/commands/` (gerados de `.github/prompts/` via `npm run sync:cursor`). **Não** há comando slash dedicado a review-pr — use linguagem natural + `oxe/workflows/review-pr.md` em contexto.
 
 ## Onde ficam as integrações (após `npx oxe-cc`)
 
 - **Cursor:** comandos em **`~/.cursor/commands/`** (slash `/oxe-*`). Diretório alternativo: variável **`CURSOR_CONFIG_DIR`**.
-- **GitHub Copilot (VS Code):** instruções mescladas em **`~/.copilot/copilot-instructions.md`** (bloco OXE) e **prompt files** em **`~/.copilot/prompts/`** (`oxe-*.prompt.md`). **Não** espere `.github/prompts/` no repositório do projeto para o Copilot — o instalador usa **`~/.copilot/`** (`COPILOT_CONFIG_DIR` / `COPILOT_HOME` se definidos).
-- **Copilot CLI:** com `oxe-cc --copilot-cli`, use **agent skills** em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …). Depois de instalar: **`/skills reload`**. Pastas **`~/.claude/commands/`** e **`~/.copilot/commands/`** são cópia legado; **`CLAUDE_CONFIG_DIR`** altera o home Claude.
+- **GitHub Copilot (VS Code):** integração **workspace-first**: instruções em **`.github/copilot-instructions.md`** e **prompt files** em **`.github/prompts/`** (`oxe-*.prompt.md`). Se existir conteúdo em `~/.copilot/prompts/`, trate como **legado detectável**, não como fonte primária da IDE.
+- **Copilot CLI:** com `oxe-cc --copilot-cli`, use **agent skills** em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …). Depois de instalar: **`/skills reload`**. Pastas **`~/.claude/commands/`** e **`~/.copilot/commands/`** são cópia legado; **`CLAUDE_CONFIG_DIR`**, **`COPILOT_CONFIG_DIR`** e **`COPILOT_HOME`** alteram os homes CLI.
 - **Multi-agente:** `oxe-cc --all-agents` (menu **6**) replica fluxos para **OpenCode**, **Gemini CLI** (`/commands reload`), **Codex**, **Windsurf**, **Antigravity**, além de Cursor/Copilot/Claude. **`XDG_CONFIG_HOME`** / **`CODEX_HOME`** afetam caminhos canónicos desses destinos. O núcleo no repo continua **`.oxe/`** (SPEC/PLAN/VERIFY em Markdown).
 
 ## Configuração do projeto
@@ -79,6 +82,6 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 
 ## Manutenção do pacote oxe-build
 
-Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`** e comandos Cursor gerados pelo sync alinhados a essa pasta (e as integrações multi-agente coerentes com `oxe-agent-install.cjs`).
+Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
 
 **Autoria de workflows:** guia em **`oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`oxe/workflows/workflow-authoring.md`** (ou `.oxe/workflows/` no projeto alvo).

package/.github/prompts/oxe-ask.prompt.md

@@ -3,8 +3,41 @@ name: oxe-ask
 agent: agent
 description: "OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão ativa e artefatos relevantes"
 argument-hint: "[pergunta em texto livre]"
+oxe_workflow_slug: ask
+oxe_reasoning_mode: discovery
+oxe_question_policy: explore_first
+oxe_output_contract: situational
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: b3f89121879267f9
 ---
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ask
+- **Modo:** descoberta
+- **Perguntas:** explorar primeiro
+- **Saída esperada:** situacional
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `b3f89121879267f9`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ask.md` e `.oxe/context/packs/ask.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow ask --json`
+- Explorar o repositório e os artefatos antes de perguntar.
+- Separar fatos confirmados, inferências e lacunas.
+- Perguntar apenas ambiguidades que mudem a decisão ou o artefato final.
+- **Seções esperadas:** Fatos · Inferências · Lacunas · Próximo passo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-discovery.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/ask.md`

package/.github/prompts/oxe-capabilities.prompt.md

@@ -3,8 +3,41 @@ name: oxe-capabilities
 agent: agent
 description: "OXE — gerir capabilities nativas do projeto"
 argument-hint: "[list|install <id>|remove <id>|update]"
+oxe_workflow_slug: capabilities
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: mixed
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: c2dbc0e05602cd19
 ---
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** capabilities
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `c2dbc0e05602cd19`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/capabilities.md` e `.oxe/context/packs/capabilities.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow capabilities --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/capabilities.md`

package/.github/prompts/oxe-checkpoint.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-checkpoint
-agent: agent
-description: OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
-argument-hint: "<slug> [nota breve]"
----
-
-Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/checkpoint.md`
-
-O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.
+---
+name: oxe-checkpoint
+agent: agent
+description: OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
+argument-hint: "<slug> [nota breve]"
+oxe_workflow_slug: checkpoint
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 09b26a7ca32729b5
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** checkpoint
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `09b26a7ca32729b5`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/checkpoint.md` e `.oxe/context/packs/checkpoint.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow checkpoint --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
+
+`oxe/workflows/checkpoint.md`
+
+O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.

package/.github/prompts/oxe-compact.prompt.md

@@ -1,11 +1,44 @@
----
-name: oxe-compact
-mode: agent
-description: OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
----
-
-Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/compact.md`
-
-Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.
+---
+name: oxe-compact
+mode: agent
+description: OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
+oxe_workflow_slug: compact
+oxe_reasoning_mode: discovery
+oxe_question_policy: explore_first
+oxe_output_contract: execution
+oxe_tool_profile: mixed
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 05c86e61cfc45177
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** compact
+- **Modo:** descoberta
+- **Perguntas:** explorar primeiro
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `05c86e61cfc45177`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/compact.md` e `.oxe/context/packs/compact.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow compact --json`
+- Explorar o repositório e os artefatos antes de perguntar.
+- Separar fatos confirmados, inferências e lacunas.
+- Perguntar apenas ambiguidades que mudem a decisão ou o artefato final.
+- **Seções esperadas:** Fatos · Inferências · Lacunas · Próximo passo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-discovery.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
+
+`oxe/workflows/compact.md`
+
+Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.

package/.github/prompts/oxe-dashboard.prompt.md

@@ -3,8 +3,41 @@ name: oxe-dashboard
 agent: agent
 description: "OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha"
 argument-hint: "[foco opcional]"
+oxe_workflow_slug: dashboard
+oxe_reasoning_mode: status
+oxe_question_policy: none
+oxe_output_contract: situational
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 590801b870fcbb56
 ---
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** dashboard
+- **Modo:** estado / roteamento
+- **Perguntas:** nenhuma
+- **Saída esperada:** situacional
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `590801b870fcbb56`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`
+- Responder com leitura curta e orientada a decisão.
+- Dar uma recomendação única e justificar o motivo.
+- Explicitar a confiança quando o estado estiver incompleto ou ambíguo.
+- **Seções esperadas:** Leitura atual · Recomendação · Motivo · Confiança
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-status.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/dashboard.md`

package/.github/prompts/oxe-debug.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-debug
-agent: agent
-description: OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
-argument-hint: "[Tn opcional, stack ou comando que falhou]"
----
-
-Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/debug.md`
-
-Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.
+---
+name: oxe-debug
+agent: agent
+description: OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
+argument-hint: "[Tn opcional, stack ou comando que falhou]"
+oxe_workflow_slug: debug
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: ee0c492eabab1723
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** debug
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `ee0c492eabab1723`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/debug.md` e `.oxe/context/packs/debug.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow debug --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
+
+`oxe/workflows/debug.md`
+
+Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.

package/.github/prompts/oxe-discuss.prompt.md

@@ -3,8 +3,41 @@ name: oxe-discuss
 agent: agent
 description: OXE — Discussão antes do plano
 argument-hint: "[contexto ou respostas]"
+oxe_workflow_slug: discuss
+oxe_reasoning_mode: discovery
+oxe_question_policy: explore_first
+oxe_output_contract: situational
+oxe_tool_profile: read_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: fb75dc9cf2963e3c
 ---
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** discuss
+- **Modo:** descoberta
+- **Perguntas:** explorar primeiro
+- **Saída esperada:** situacional
+- **Perfil de ferramentas:** leitura intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `fb75dc9cf2963e3c`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/discuss.md` e `.oxe/context/packs/discuss.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow discuss --json`
+- Explorar o repositório e os artefatos antes de perguntar.
+- Separar fatos confirmados, inferências e lacunas.
+- Perguntar apenas ambiguidades que mudem a decisão ou o artefato final.
+- **Seções esperadas:** Fatos · Inferências · Lacunas · Próximo passo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-discovery.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/discuss.md`

package/.github/prompts/oxe-execute.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-execute
-agent: agent
-description: "OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições"
-argument-hint: "[opcional: A/B/C para modo, onda N, ou Tn]"
----
-
-Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
-
-`oxe/workflows/execute.md`
-
-Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso. Lê `oxe/workflows/execute.md` na raiz do projeto atual (CWD).
+---
+name: oxe-execute
+agent: agent
+description: "OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa para controlar requisições"
+argument-hint: "[opcional: A/B/C para modo, onda N, ou Tn]"
+oxe_workflow_slug: execute
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: a33b293fc6a29a70
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** execute
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `a33b293fc6a29a70`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow execute --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan_or_quick
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/execute.md`
+
+Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso. Lê `oxe/workflows/execute.md` na raiz do projeto atual (CWD).