oxe-cc 0.7.0 → 0.9.0

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Gera .oxe/PLAN.md com verificação por tarefa"
+argument-hint: "[opcional: --replan]"
+oxe_workflow_slug: plan
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: plan
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: db8d30e9106386d1
 ---
 
 OXE — Gera .oxe/PLAN.md com verificação por tarefa
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** plan
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** plano
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** rubrica
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `db8d30e9106386d1`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/plan.md` e `.oxe/context/packs/plan.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 plan --json`
+- Fechar interfaces, validação, riscos, rollback e assumptions relevantes.
+- Não deixar decisões importantes para quem implementar depois.
+- Explicitar confiança e condição objetiva para replanejar.
+- **Seções esperadas:** Objetivo · Plano · Validação · Riscos · Assumptions · Confiança
+- **Bloqueios formais:** missing:state · missing:spec
+- **Referência canónica:** `oxe/workflows/references/reasoning-planning.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
 
 `oxe/workflows/plan.md` (na raiz do repositório em contexto)

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Gestão de projeto unificada: milestone, workstream e checkpoint"
+argument-hint: "milestone new <nome> | workstream switch <nome> | checkpoint [slug]"
+oxe_workflow_slug: project
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: routing
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 88b279f22bfd77ae
 ---
 
 OXE — Gestão de projeto unificada: milestone, workstream e checkpoint
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** project
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** roteamento
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** rubrica
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `88b279f22bfd77ae`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/project.md` e `.oxe/context/packs/project.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 project --json`
+- Fechar interfaces, validação, riscos, rollback e assumptions relevantes.
+- Não deixar decisões importantes para quem implementar depois.
+- Explicitar confiança e condição objetiva para replanejar.
+- **Seções esperadas:** Objetivo · Plano · Validação · Riscos · Assumptions · Confiança
+- **Bloqueios formais:** missing:state · missing:spec
+- **Referência canónica:** `oxe/workflows/references/reasoning-planning.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/project.md`

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar"
+argument-hint: "[objetivo em texto livre] [--agents para forçar PDDA]"
+oxe_workflow_slug: quick
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: plan
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: e3eac1b1bc15a71b
 ---
 
 OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos → agentes por domínio (opcional) → verificar
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** quick
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** plano
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** rubrica
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `e3eac1b1bc15a71b`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/quick.md` e `.oxe/context/packs/quick.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 quick --json`
+- Fechar interfaces, validação, riscos, rollback e assumptions relevantes.
+- Não deixar decisões importantes para quem implementar depois.
+- Explicitar confiança e condição objetiva para replanejar.
+- **Seções esperadas:** Objetivo · Plano · Validação · Riscos · Assumptions · Confiança
+- **Bloqueios formais:** missing:state · missing:spec
+- **Referência canónica:** `oxe/workflows/references/reasoning-planning.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/quick.md`

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)"
+argument-hint: "[âmbito, ex. módulo auth, mapa sistema, reversa]"
+oxe_workflow_slug: research
+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: b697e0409d229d47
 ---
 
 OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** research
+- **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:** `b697e0409d229d47`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/research.md` e `.oxe/context/packs/research.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 research --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 research** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/research.md`

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Retrospectiva de ciclo: 3–5 lições prescritivas em .oxe/LESSONS.md para ciclos futuros"
+argument-hint: "[opcional: contexto extra sobre o ciclo — o que foi mais difícil, o que surpreendeu]"
+oxe_workflow_slug: retro
+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: 5afa357495cad615
 ---
 
 OXE — Retrospectiva de ciclo: 3–5 lições prescritivas em .oxe/LESSONS.md para ciclos futuros
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** retro
+- **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:** `5afa357495cad615`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/retro.md` e `.oxe/context/packs/retro.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 retro --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 retro** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/retro.md`

package/.cursor/commands/oxe-review-pr.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Revisão de PR (link GitHub, branches ou SHAs)"
+argument-hint: "URL ou refs: https://github.com/org/repo/pull/10 | main feature/foo"
+oxe_workflow_slug: review-pr
+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: 1e12e0a92c7d0079
 ---
 
 OXE — Revisão de PR (link GitHub, branches ou SHAs)
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** review-pr
+- **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:** `1e12e0a92c7d0079`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/review-pr.md` e `.oxe/context/packs/review-pr.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 review-pr --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 review-pr**. Lê e aplica **integralmente**:
 
 `oxe/workflows/review-pr.md` (na raiz do repositório em contexto)

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Router: um pedido em linguagem natural → um comando/workflow"
+argument-hint: "[frase do utilizador]"
+oxe_workflow_slug: route
+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: 9d140800451c0ea9
 ---
 
 OXE — Router: um pedido em linguagem natural → um comando/workflow
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** route
+- **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:** `9d140800451c0ea9`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/route.md` e `.oxe/context/packs/route.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 route --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 route** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/route.md`

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Scan do repositório (.oxe/codebase/)"
+argument-hint: "[área opcional, ex. api]"
+oxe_workflow_slug: scan
+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: 899fe6bc3684fc6e
 ---
 
 OXE — Scan do repositório (.oxe/codebase/)
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** scan
+- **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:** `899fe6bc3684fc6e`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/scan.md` e `.oxe/context/packs/scan.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 scan --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 scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
 
 `oxe/workflows/scan.md` (na raiz do repositório em contexto)

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0/P1/P2 vinculados ao stack"
+argument-hint: "[opcional: categoria OWASP, módulo ou arquivo de foco]"
+oxe_workflow_slug: security
+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: 27ebaddfc7191f76
 ---
 
 OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0/P1/P2 vinculados ao stack
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** security
+- **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:** `27ebaddfc7191f76`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/security.md` e `.oxe/context/packs/security.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 security --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 security** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/security.md`

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Gerir sessões: new, list, switch, resume, status, close, migrate"
+argument-hint: "[new <nome> | list | switch <id> | resume <id> | status | close | migrate <nome>]"
+oxe_workflow_slug: session
+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: 4a7e893fe47767a3
 ---
 
 OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** session
+- **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:** `4a7e893fe47767a3`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/session.md` e `.oxe/context/packs/session.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 session --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 session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
 `oxe/workflows/session.md`

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

@@ -0,0 +1,45 @@
+---
+description: "OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)"
+argument-hint: "[list | explain <id> | new <id> | @<skill-id>]"
+oxe_workflow_slug: skill
+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: 64cec6f03fc7cfe6
+---
+
+OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** skill
+- **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:** `64cec6f03fc7cfe6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/skill.md` e `.oxe/context/packs/skill.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 skill --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 skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/skill.md`
+
+Usa o texto adicional desta mensagem como subcomando ou invocação de skill.

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

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan"
+argument-hint: "[descrição da feature ou ideia]"
+oxe_workflow_slug: spec
+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: 482d3eb12fe261ed
 ---
 
 OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** spec
+- **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:** `482d3eb12fe261ed`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.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 spec --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 spec**. Lê e aplica **integralmente**:
 
 `oxe/workflows/spec.md` (na raiz do repositório em contexto)

package/.cursor/commands/oxe-ui-review.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC"
+argument-hint: "[paths ou Tn opcional]"
+oxe_workflow_slug: ui-review
+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: 94c1695de8d9ec7d
 ---
 
 OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ui-review
+- **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:** `94c1695de8d9ec7d`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ui-review.md` e `.oxe/context/packs/ui-review.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 ui-review --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 ui-review** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/ui-review.md`

package/.cursor/commands/oxe-ui-spec.md

@@ -1,9 +1,43 @@
 ---
 description: "OXE — Contrato UI (UI-SPEC.md) a partir da SPEC"
+argument-hint: "[âmbito UI opcional]"
+oxe_workflow_slug: ui-spec
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: plan
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 76ba6d1e0e2f02e6
 ---
 
 OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ui-spec
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** plano
+- **Perfil de ferramentas:** misto
+- **Política de confiança:** rubrica
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `76ba6d1e0e2f02e6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ui-spec.md` e `.oxe/context/packs/ui-spec.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 ui-spec --json`
+- Fechar interfaces, validação, riscos, rollback e assumptions relevantes.
+- Não deixar decisões importantes para quem implementar depois.
+- Explicitar confiança e condição objetiva para replanejar.
+- **Seções esperadas:** Objetivo · Plano · Validação · Riscos · Assumptions · Confiança
+- **Bloqueios formais:** missing:state · missing:spec
+- **Referência canónica:** `oxe/workflows/references/reasoning-planning.md`
+
+<!-- oxe-reasoning-contract:end -->
+
 Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
 
 `oxe/workflows/ui-spec.md`

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

@@ -1,9 +1,42 @@
 ---
 description: "Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor"
+oxe_workflow_slug: update
+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: 49332cbd409f2ac6
 ---
 
 Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor
 
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** update
+- **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:** `49332cbd409f2ac6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/update.md` e `.oxe/context/packs/update.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 update --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 update**. Lê e segue **integralmente**:
 
 `oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)