oxe-cc 0.7.1 → 0.9.0

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

@@ -1,12 +1,45 @@
----
-name: oxe-forensics
-agent: agent
-description: OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)
-argument-hint: "[contexto opcional do sintoma]"
----
-
-Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/forensics.md`
-
-Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).
+---
+name: oxe-forensics
+agent: agent
+description: OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)
+argument-hint: "[contexto opcional do sintoma]"
+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 -->
+
+Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
+
+`oxe/workflows/forensics.md`
+
+Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).

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

@@ -1,9 +1,42 @@
----
-name: oxe-help
-agent: agent
-description: OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
----
-
-Executa o workflow **OXE help**. Lê e segue **integralmente**:
-
-`oxe/workflows/help.md` (na raiz do repositório em contexto)
+---
+name: oxe-help
+agent: agent
+description: OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
+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 -->
+
+Executa o workflow **OXE help**. Lê e segue **integralmente**:
+
+`oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -1,12 +1,45 @@
----
-name: oxe-loop
-agent: agent
-description: OXE — Loop iterativo por onda com retries automáticos e diagnóstico inline
-argument-hint: "onda <N> [max:<tentativas>]"
----
-
-Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/loop.md`
-
-`$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.
+---
+name: oxe-loop
+agent: agent
+description: OXE — Loop iterativo por onda com retries automáticos e diagnóstico inline
+argument-hint: "onda <N> [max:<tentativas>]"
+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 -->
+
+Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
+
+`oxe/workflows/loop.md`
+
+`$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.

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

@@ -1,12 +1,45 @@
----
-name: oxe-milestone
-agent: agent
-description: "OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN/), status, audit"
-argument-hint: "new <nome> | complete | status | audit"
----
-
-Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
-
-`oxe/workflows/milestone.md`
-
-Usa o texto adicional desta mensagem como subcomando e contexto.
+---
+name: oxe-milestone
+agent: agent
+description: "OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN/), status, audit"
+argument-hint: "new <nome> | complete | status | audit"
+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 -->
+
+Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/milestone.md`
+
+Usa o texto adicional desta mensagem como subcomando e contexto.

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

@@ -1,9 +1,42 @@
----
-name: oxe-next
-agent: agent
-description: OXE — Próximo passo (lê STATE.md)
----
-
-Executa o workflow **OXE next**. Lê e aplica **integralmente**:
-
-`oxe/workflows/next.md` (na raiz do repositório em contexto)
+---
+name: oxe-next
+agent: agent
+description: OXE — Próximo passo (lê STATE.md)
+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 -->
+
+Executa o workflow **OXE next**. Lê e aplica **integralmente**:
+
+`oxe/workflows/next.md` (na raiz do repositório em contexto)

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

@@ -1,12 +1,45 @@
----
-name: oxe-obs
-agent: agent
-description: "OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorporada automaticamente no próximo spec/plan/execute (sem re-explicar)"
-argument-hint: "[observação em texto livre]"
----
-
-Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
-
-`oxe/workflows/obs.md`
-
-Usa o texto adicional desta mensagem como a observação a registrar.
+---
+name: oxe-obs
+agent: agent
+description: "OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorporada automaticamente no próximo spec/plan/execute (sem re-explicar)"
+argument-hint: "[observação em texto livre]"
+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 -->
+
+Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/obs.md`
+
+Usa o texto adicional desta mensagem como a observação a registrar.

package/.github/prompts/oxe-plan-agent.prompt.md

@@ -1,10 +1,43 @@
----
-name: oxe-plan-agent
-description: "OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)"
----
-
-Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
-
-`oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
-
-Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.
+---
+name: oxe-plan-agent
+description: "OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)"
+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 -->
+
+Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
+
+`oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
+
+Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.

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

@@ -1,12 +1,45 @@
----
-name: oxe-plan
-agent: agent
-description: OXE — Gera .oxe/PLAN.md com verificação por tarefa
-argument-hint: "[opcional: --replan]"
----
-
-Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
-
-`oxe/workflows/plan.md` (na raiz do repositório em contexto)
-
-Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.
+---
+name: oxe-plan
+agent: agent
+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-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)
+
+Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

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

@@ -1,12 +1,45 @@
----
-name: oxe-project
-agent: agent
-description: OXE — Gestão de projeto unificada: milestone, workstream e checkpoint
-argument-hint: "milestone new <nome> | workstream switch <nome> | checkpoint [slug]"
----
-
-Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/project.md`
-
-`$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.
+---
+name: oxe-project
+agent: agent
+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-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`
+
+`$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.

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

@@ -1,12 +1,45 @@
----
-name: oxe-quick
-agent: agent
-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]"
----
-
-Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
-
-`oxe/workflows/quick.md`
-
-Usa o texto adicional desta mensagem como objetivo e contexto.
+---
+name: oxe-quick
+agent: agent
+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-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`
+
+Usa o texto adicional desta mensagem como objetivo e contexto.

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

@@ -1,12 +1,45 @@
----
-name: oxe-research
-agent: agent
-description: OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)
-argument-hint: "[âmbito, ex. módulo auth, mapa sistema, reversa]"
----
-
-Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/research.md`
-
-Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).
+---
+name: oxe-research
+agent: agent
+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-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`
+
+Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).