oxe-cc 0.7.1 → 0.9.0

package/commands/oxe/milestone.md

@@ -1,16 +1,49 @@
----
-name: oxe:milestone
-description: "Marcos de entrega (M-NN) — new, complete (arquiva SPEC/PLAN/VERIFY em .oxe/milestones/M-NN/), status, audit"
-argument-hint: "new <nome> | complete | status | audit"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/milestone.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como subcomando e contexto (ex.: `new sprint-1`, `complete`, `audit`).
+---
+name: oxe:milestone
+description: "Marcos de entrega (M-NN) — new, complete (arquiva SPEC/PLAN/VERIFY em .oxe/milestones/M-NN/), status, audit"
+argument-hint: "new <nome> | complete | status | audit"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: milestone
+oxe_reasoning_mode: planning
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: mixed
+oxe_confidence_policy: rubric
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 1e1f50e7621c55dd
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** milestone
+- **Modo:** planejamento
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **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:** `1e1f50e7621c55dd`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/milestone.md` e `.oxe/context/packs/milestone.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 milestone --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 -->
+
+**Workflow canónico:** `oxe/workflows/milestone.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como subcomando e contexto (ex.: `new sprint-1`, `complete`, `audit`).

package/commands/oxe/next.md

@@ -1,12 +1,45 @@
----
-name: oxe:next
-description: Lê STATE.md e indica o próximo comando OXE lógico
-argument-hint: ""
-allowed-tools:
-  - Read
-  - Glob
----
-
-**Workflow canónico:** `oxe/workflows/next.md`
-
-Execute integralmente esse ficheiro.
+---
+name: oxe:next
+description: Lê STATE.md e indica o próximo comando OXE lógico
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Glob
+oxe_workflow_slug: next
+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: 6c91889eba921d36
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** next
+- **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:** `6c91889eba921d36`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/next.md` e `.oxe/context/packs/next.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 next --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/next.md`
+
+Execute integralmente esse ficheiro.

package/commands/oxe/obs.md

@@ -1,16 +1,49 @@
----
-name: oxe:obs
-description: "Observação contextual — registra em .oxe/OBSERVATIONS.md, incorporada automaticamente no próximo spec/plan/execute sem re-explicar"
-argument-hint: "[observação: restrição, descoberta, preferência, risco ou decisão]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/obs.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como a observação a registrar.
+---
+name: oxe:obs
+description: "Observação contextual — registra em .oxe/OBSERVATIONS.md, incorporada automaticamente no próximo spec/plan/execute sem re-explicar"
+argument-hint: "[observação: restrição, descoberta, preferência, risco ou decisão]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: obs
+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: 6c653692c8498e71
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** obs
+- **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:** `6c653692c8498e71`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/obs.md` e `.oxe/context/packs/obs.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 obs --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/obs.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como a observação a registrar.

package/commands/oxe/oxe.md

@@ -1,16 +1,49 @@
----
-name: oxe
-description: OXE — Entrada universal: próximo passo, roteamento de linguagem natural ou help dos 8 comandos essenciais
-argument-hint: "[contexto | 'help' | vazio]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/oxe.md`
-
-Execute integralmente esse ficheiro. `$ARGUMENTS`: vazio → próximo passo; texto → roteamento inteligente; "help" → 8 comandos essenciais.
+---
+name: oxe
+description: OXE — Entrada universal: próximo passo, roteamento de linguagem natural ou help dos 8 comandos essenciais
+argument-hint: "[contexto | 'help' | vazio]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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-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 -->
+
+**Workflow canônico:** `oxe/workflows/oxe.md`
+
+Execute integralmente esse ficheiro. `$ARGUMENTS`: vazio → próximo passo; texto → roteamento inteligente; "help" → 8 comandos essenciais.

package/commands/oxe/plan-agent.md

@@ -1,15 +1,48 @@
----
-name: oxe:plan-agent
-description: Gera PLAN.md e plan-agents.json (blueprint de agentes e ondas)
-argument-hint: "[--replan se já existe PLAN.md]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
-  - Bash
----
-
-**Workflow canónico:** `oxe/workflows/plan-agent.md`
-
-Execute integralmente esse ficheiro. Se `$ARGUMENTS` contiver `--replan`, seguir a variante de replanejamento descrita no workflow.
+---
+name: oxe:plan-agent
+description: Gera PLAN.md e plan-agents.json (blueprint de agentes e ondas)
+argument-hint: "[--replan se já existe PLAN.md]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Bash
+oxe_workflow_slug: plan-agent
+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: 0b2f34a325711ad6
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** plan-agent
+- **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:** `0b2f34a325711ad6`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/plan-agent.md` e `.oxe/context/packs/plan-agent.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-agent --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 -->
+
+**Workflow canónico:** `oxe/workflows/plan-agent.md`
+
+Execute integralmente esse ficheiro. Se `$ARGUMENTS` contiver `--replan`, seguir a variante de replanejamento descrita no workflow.

package/commands/oxe/plan.md

@@ -1,15 +1,48 @@
----
-name: oxe:plan
-description: Gera PLAN.md a partir da SPEC com tarefas atômicas e verificação por item
-argument-hint: "[--replan se já existe PLAN.md]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
-  - Bash
----
-
-**Workflow canónico:** `oxe/workflows/plan.md`
-
-Execute integralmente esse ficheiro. Se `$ARGUMENTS` contiver `--replan`, seguir a variante de replanejamento descrita no workflow.
+---
+name: oxe:plan
+description: Gera PLAN.md a partir da SPEC com tarefas atômicas e verificação por item
+argument-hint: "[--replan se já existe PLAN.md]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Bash
+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-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 -->
+
+**Workflow canónico:** `oxe/workflows/plan.md`
+
+Execute integralmente esse ficheiro. Se `$ARGUMENTS` contiver `--replan`, seguir a variante de replanejamento descrita no workflow.

package/commands/oxe/project.md

@@ -1,16 +1,49 @@
----
-name: oxe:project
-description: OXE — Gestão de projeto: milestone (M-NN), workstream (trilhas paralelas), checkpoint (snapshot)
-argument-hint: "milestone new|complete|status|audit | workstream new|switch|list|close <nome> | checkpoint [slug]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/project.md`
-
-Execute integralmente esse ficheiro. `$ARGUMENTS` = subcomando. Sem argumento: mostra status atual (milestone ativo, workstreams, último checkpoint).
+---
+name: oxe:project
+description: OXE — Gestão de projeto: milestone (M-NN), workstream (trilhas paralelas), checkpoint (snapshot)
+argument-hint: "milestone new|complete|status|audit | workstream new|switch|list|close <nome> | checkpoint [slug]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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-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 -->
+
+**Workflow canônico:** `oxe/workflows/project.md`
+
+Execute integralmente esse ficheiro. `$ARGUMENTS` = subcomando. Sem argumento: mostra status atual (milestone ativo, workstreams, último checkpoint).

package/commands/oxe/quick.md

@@ -1,16 +1,49 @@
----
-name: oxe:quick
-description: "Modo rápido com Plan-Driven Dynamic Agents lean — minispec (objetivo) + mini-plano (passos) + agentes dinâmicos por domínio (opcional) + verificar"
-argument-hint: "[objetivo] [--agents]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/quick.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como objetivo e contexto.
+---
+name: oxe:quick
+description: "Modo rápido com Plan-Driven Dynamic Agents lean — minispec (objetivo) + mini-plano (passos) + agentes dinâmicos por domínio (opcional) + verificar"
+argument-hint: "[objetivo] [--agents]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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-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 -->
+
+**Workflow canónico:** `oxe/workflows/quick.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como objetivo e contexto.

package/commands/oxe/research.md

@@ -1,16 +1,49 @@
----
-name: oxe:research
-description: OXE — Pesquisa exploratória (notas datadas em .oxe/research/ + RESEARCH.md)
-argument-hint: "[âmbito: spike, mapa sistema, reversa, modernização, …]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/research.md`
-
-Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito e perguntas.
+---
+name: oxe:research
+description: OXE — Pesquisa exploratória (notas datadas em .oxe/research/ + RESEARCH.md)
+argument-hint: "[âmbito: spike, mapa sistema, reversa, modernização, …]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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-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 -->
+
+**Workflow canónico:** `oxe/workflows/research.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito e perguntas.

package/commands/oxe/retro.md

@@ -1,16 +1,49 @@
----
-name: oxe:retro
-description: OXE — Retrospectiva de ciclo: sintetiza lições prescritivas em .oxe/LESSONS.md (alimenta ciclos futuros automaticamente)
-argument-hint: "[opcional: contexto sobre o ciclo]"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canônico:** `oxe/workflows/retro.md`
-
-Execute integralmente esse ficheiro. Lê VERIFY.md, FORENSICS.md, SUMMARY.md para sintetizar 3–5 lições prescritivas. `$ARGUMENTS` = contexto extra opcional.
+---
+name: oxe:retro
+description: OXE — Retrospectiva de ciclo: sintetiza lições prescritivas em .oxe/LESSONS.md (alimenta ciclos futuros automaticamente)
+argument-hint: "[opcional: contexto sobre o ciclo]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+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-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 -->
+
+**Workflow canônico:** `oxe/workflows/retro.md`
+
+Execute integralmente esse ficheiro. Lê VERIFY.md, FORENSICS.md, SUMMARY.md para sintetizar 3–5 lições prescritivas. `$ARGUMENTS` = contexto extra opcional.