oxe-cc 0.7.0 → 0.9.0

package/commands/oxe/ask.md

@@ -7,8 +7,41 @@ allowed-tools:
   - Bash
   - Glob
   - Grep
+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 -->
+
 **Workflow canónico:** `oxe/workflows/ask.md`
 
 Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como pergunta e foco.

package/commands/oxe/capabilities.md

@@ -6,8 +6,41 @@ allowed-tools:
   - Read
   - Bash
   - Glob
+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 -->
+
 **Workflow canónico:** `oxe/workflows/capabilities.md`
 
 Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como ação sobre capabilities.

package/commands/oxe/checkpoint.md

@@ -1,16 +1,49 @@
----
-name: oxe:checkpoint
-description: OXE — Marco em .oxe/checkpoints/ + CHECKPOINTS.md
-argument-hint: "<slug> [nota]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/checkpoint.md`
-
-Execute integralmente. `$ARGUMENTS` = slug obrigatório + nota opcional.
+---
+name: oxe:checkpoint
+description: OXE — Marco em .oxe/checkpoints/ + CHECKPOINTS.md
+argument-hint: "<slug> [nota]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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 -->
+
+**Workflow canónico:** `oxe/workflows/checkpoint.md`
+
+Execute integralmente. `$ARGUMENTS` = slug obrigatório + nota opcional.

package/commands/oxe/compact.md

@@ -1,10 +1,43 @@
----
-name: oxe:compact
-description: OXE — refresh codebase vs repo + CODEBASE-DELTA + RESUME (rotina de projeto)
----
-
-# OXE — compact
-
-**Workflow canónico:** `oxe/workflows/compact.md`
-
-Execute integralmente. Atualiza **`.oxe/codebase/*.md`**, **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. `$ARGUMENTS` = foco opcional (ex. módulo) ou notas para Decisões/Bloqueios no RESUME.
+---
+name: oxe:compact
+description: OXE — refresh codebase vs repo + CODEBASE-DELTA + RESUME (rotina de projeto)
+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 -->
+
+# OXE — compact
+
+**Workflow canónico:** `oxe/workflows/compact.md`
+
+Execute integralmente. Atualiza **`.oxe/codebase/*.md`**, **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. `$ARGUMENTS` = foco opcional (ex. módulo) ou notas para Decisões/Bloqueios no RESUME.

package/commands/oxe/dashboard.md

@@ -7,8 +7,41 @@ allowed-tools:
   - Bash
   - Glob
   - Grep
+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 -->
+
 **Workflow canónico:** `oxe/workflows/dashboard.md`
 
 Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como foco opcional.

package/commands/oxe/debug.md

@@ -1,16 +1,49 @@
----
-name: oxe:debug
-description: OXE — Debug técnico durante execute (.oxe/DEBUG.md)
-argument-hint: "[Tn ou erro/stack]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/debug.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como sintoma ou tarefa **Tn**.
+---
+name: oxe:debug
+description: OXE — Debug técnico durante execute (.oxe/DEBUG.md)
+argument-hint: "[Tn ou erro/stack]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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 -->
+
+**Workflow canónico:** `oxe/workflows/debug.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como sintoma ou tarefa **Tn**.

package/commands/oxe/discuss.md

@@ -9,8 +9,41 @@ allowed-tools:
   - Grep
   - Write
   - Task
+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 -->
+
 **Workflow canónico:** `oxe/workflows/discuss.md`
 
 Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como contexto ou respostas.

package/commands/oxe/execute.md

@@ -1,16 +1,49 @@
----
-name: oxe:execute
-description: "Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa — controle explícito de requisições"
-argument-hint: "[A=completo | B=por-onda | C=por-tarefa | onda N | Tn]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/execute.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como foco (onda, tarefa, confirmação).
+---
+name: oxe:execute
+description: "Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por onda | Por tarefa — controle explícito de requisições"
+argument-hint: "[A=completo | B=por-onda | C=por-tarefa | onda N | Tn]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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 -->
+
+**Workflow canónico:** `oxe/workflows/execute.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa `$ARGUMENTS` como foco (onda, tarefa, confirmação).

package/commands/oxe/forensics.md

@@ -1,16 +1,49 @@
----
-name: oxe:forensics
-description: OXE — Forensics pós-falha (.oxe/FORENSICS.md + próximo passo scan/plan/execute)
-argument-hint: "[sintoma opcional]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/forensics.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como contexto do sintoma.
+---
+name: oxe:forensics
+description: OXE — Forensics pós-falha (.oxe/FORENSICS.md + próximo passo scan/plan/execute)
+argument-hint: "[sintoma opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: forensics
+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: 6c54f2a6320ba0e1
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** forensics
+- **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:** `6c54f2a6320ba0e1`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/forensics.md` e `.oxe/context/packs/forensics.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 forensics --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 -->
+
+**Workflow canónico:** `oxe/workflows/forensics.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como contexto do sintoma.

package/commands/oxe/help.md

@@ -1,11 +1,44 @@
----
-name: oxe:help
-description: Lista comandos OXE e o fluxo recomendado
-argument-hint: ""
-allowed-tools:
-  - Read
----
-
-**Workflow canónico:** `oxe/workflows/help.md`
-
-Execute integralmente esse ficheiro (inclui Cursor vs Copilot).
+---
+name: oxe:help
+description: Lista comandos OXE e o fluxo recomendado
+argument-hint: ""
+allowed-tools:
+  - Read
+oxe_workflow_slug: help
+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: d6221b02bf643a34
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** help
+- **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:** `d6221b02bf643a34`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/help.md` e `.oxe/context/packs/help.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 help --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 -->
+
+**Workflow canónico:** `oxe/workflows/help.md`
+
+Execute integralmente esse ficheiro (inclui Cursor vs Copilot).

package/commands/oxe/loop.md

@@ -1,17 +1,50 @@
----
-name: oxe:loop
-description: OXE — Execução iterativa de onda com retries automáticos e diagnóstico inline
-argument-hint: "onda <N> [max:<tentativas>]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Edit
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/loop.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. `$ARGUMENTS` = onda alvo e máximo de tentativas. Pré-requisito: `.oxe/PLAN.md`.
+---
+name: oxe:loop
+description: OXE — Execução iterativa de onda com retries automáticos e diagnóstico inline
+argument-hint: "onda <N> [max:<tentativas>]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Edit
+  - Task
+oxe_workflow_slug: loop
+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: 00850336919d1c14
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** loop
+- **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:** `00850336919d1c14`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/loop.md` e `.oxe/context/packs/loop.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 loop --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 -->
+
+**Workflow canônico:** `oxe/workflows/loop.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. `$ARGUMENTS` = onda alvo e máximo de tentativas. Pré-requisito: `.oxe/PLAN.md`.