oxe-cc 0.7.1 → 0.9.1

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

@@ -1,12 +1,45 @@
----
-name: oxe-retro
-agent: agent
-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]"
----
-
-Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/retro.md`
-
-Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.
+---
+name: oxe-retro
+agent: agent
+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-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`
+
+Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.

package/.github/prompts/oxe-review-pr.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-review-pr
-agent: agent
-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"
----
-
-Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
-
-`oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
-
-**Exemplos de entrada:** cola o URL da PR (`https://github.com/org/repo/pull/10`, com ou sem `/files`); ou `org/repo#10`; ou **base** e **head** (branches/tags/SHAs). Sem refs, o agente infere (ex.: `main` vs branch atual).
+---
+name: oxe-review-pr
+agent: agent
+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-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)
+
+**Exemplos de entrada:** cola o URL da PR (`https://github.com/org/repo/pull/10`, com ou sem `/files`); ou `org/repo#10`; ou **base** e **head** (branches/tags/SHAs). Sem refs, o agente infere (ex.: `main` vs branch atual).

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

@@ -1,12 +1,45 @@
----
-name: oxe-route
-agent: agent
-description: OXE — Router: um pedido em linguagem natural → um comando/workflow
-argument-hint: "[frase do utilizador]"
----
-
-Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/route.md`
-
-Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).
+---
+name: oxe-route
+agent: agent
+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-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`
+
+Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).

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

@@ -1,12 +1,45 @@
----
-name: oxe-scan
-agent: agent
-description: OXE — Scan do repositório (.oxe/codebase/)
-argument-hint: "[área opcional, ex. api]"
----
-
-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)
-
-Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).
+---
+name: oxe-scan
+agent: agent
+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-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)
+
+Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).

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

@@ -1,12 +1,45 @@
----
-name: oxe-security
-agent: agent
-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]"
----
-
-Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/security.md`
-
-Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.
+---
+name: oxe-security
+agent: agent
+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-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`
+
+Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.

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

@@ -3,8 +3,41 @@ name: oxe-session
 agent: agent
 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-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/.github/prompts/oxe-skill.prompt.md

@@ -0,0 +1,45 @@
+---
+name: oxe-skill
+agent: agent
+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-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/.github/prompts/oxe-spec.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-spec
-agent: agent
-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]"
----
-
-Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
-
-`oxe/workflows/spec.md` (na raiz do repositório em contexto)
-
-Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
+---
+name: oxe-spec
+agent: agent
+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-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)
+
+Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

package/.github/prompts/oxe-ui-review.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-ui-review
-agent: agent
-description: OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
-argument-hint: "[paths ou Tn opcional]"
----
-
-Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/ui-review.md`
-
-Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.
+---
+name: oxe-ui-review
+agent: agent
+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-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`
+
+Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.

package/.github/prompts/oxe-ui-spec.prompt.md

@@ -1,12 +1,45 @@
----
-name: oxe-ui-spec
-agent: agent
-description: OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
-argument-hint: "[âmbito UI opcional]"
----
-
-Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
-
-`oxe/workflows/ui-spec.md`
-
-Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.
+---
+name: oxe-ui-spec
+agent: agent
+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-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`
+
+Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.

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

@@ -1,11 +1,44 @@
----
-name: oxe-update
-agent: agent
-description: Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor
----
-
-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)
-
-Na prática: na raiz do projeto, correr **`npx oxe-cc update --check`**, depois (se aplicável) **`npx oxe-cc update`** ou **`npx oxe-cc update --if-newer`**, e por fim **`npx oxe-cc doctor`**.
+---
+name: oxe-update
+agent: agent
+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
+---
+
+<!-- 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)
+
+Na prática: na raiz do projeto, correr **`npx oxe-cc update --check`**, depois (se aplicável) **`npx oxe-cc update`** ou **`npx oxe-cc update --if-newer`**, e por fim **`npx oxe-cc doctor`**.