oxe-cc 1.2.1 → 1.3.0

package/oxe/templates/CHECKPOINTS.template.md

@@ -1,7 +1,7 @@
-# OXE — Checkpoints
-
-> Índice de checkpoints formais do ciclo atual. Usado para aprovações humanas e gates sensíveis.
-
-| ID | Tipo | Fase | Escopo | Estado | Política | Decisão | Override | Criado em | Resolvido em | Notas |
-|----|------|------|--------|--------|----------|---------|----------|-----------|--------------|-------|
-| CP-01 | approval | spec | definição de escopo | pending_approval | require_approval | — | — | YYYY-MM-DD | — | — |
+# OXE — Checkpoints
+
+> Índice de checkpoints formais do ciclo atual. Usado para aprovações humanas e gates sensíveis.
+
+| ID | Tipo | Fase | Escopo | Estado | Política | Decisão | Override | Criado em | Resolvido em | Notas |
+|----|------|------|--------|--------|----------|---------|----------|-----------|--------------|-------|
+| CP-01 | approval | spec | definição de escopo | pending_approval | require_approval | — | — | YYYY-MM-DD | — | — |

package/oxe/templates/EXECUTION-RUNTIME.template.md

@@ -1,68 +1,68 @@
----
-oxe_doc: execution_runtime
-status: active
-updated: YYYY-MM-DD
----
-
-# OXE — Runtime Operacional
-
-> Estado tático da execução. Este ficheiro complementa `PLAN.md` e `STATE.md`, mas não os substitui.
-
-## Contexto
-
-- **Sessão / escopo:** …
-- **Plano vinculado:** `PLAN.md`
-- **Run ID:** `oxe-run-YYYYMMDD-001`
-- **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
-- **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
-- **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
-- **Limiar de execução:** `70%`
-
-## Onda atual
-
-- **Onda:** —
-- **Estado:** planned | running | paused | waiting_approval | failed | completed | replaying | aborted
-- **Tarefas ativas:** —
-- **Última atualização:** YYYY-MM-DD
-
-## Agentes ativos
-
-| ID | Papel | Tarefas | Estado | Último handoff |
-|----|-------|---------|--------|----------------|
-| … | … | T1, T2 | active | — |
-
-## Checkpoints
-
-| ID | Tipo | Escopo | Estado | Política | Decisão | Evidência |
-|----|------|--------|--------|----------|---------|-----------|
-| CP-01 | approval | Onda 1 | pending_approval | require_approval | — | — |
-
-## Handoffs
-
-- W1 · `agent-a -> agent-b`: …
-
-## Grafo operacional
-
-- **Nós:** agent-a, capability-x, checkpoint-CP-01
-- **Arestas:** handoff, dependency, blocked_by
-
-## Evidências produzidas
-
-- `path/ou/artefato`: resumo curto
-
-## Bloqueios
-
-- (nenhum ou lista)
-
-## Iterações / retries
-
-- Tarefa/onda | Tentativa | Resultado | Nota
-
-## Tracing operacional
-
-- `run_started` → `phase_entered` → `handoff` → `checkpoint_opened` → `checkpoint_resolved` → `verification_completed`
-
-## Próximo movimento operacional
-
-- **Ação:** …
-- **Motivo:** …
+---
+oxe_doc: execution_runtime
+status: active
+updated: YYYY-MM-DD
+---
+
+# OXE — Runtime Operacional
+
+> Estado tático da execução. Este ficheiro complementa `PLAN.md` e `STATE.md`, mas não os substitui.
+
+## Contexto
+
+- **Sessão / escopo:** …
+- **Plano vinculado:** `PLAN.md`
+- **Run ID:** `oxe-run-YYYYMMDD-001`
+- **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
+- **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
+- **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
+- **Limiar de execução:** `70%`
+
+## Onda atual
+
+- **Onda:** —
+- **Estado:** planned | running | paused | waiting_approval | failed | completed | replaying | aborted
+- **Tarefas ativas:** —
+- **Última atualização:** YYYY-MM-DD
+
+## Agentes ativos
+
+| ID | Papel | Tarefas | Estado | Último handoff |
+|----|-------|---------|--------|----------------|
+| … | … | T1, T2 | active | — |
+
+## Checkpoints
+
+| ID | Tipo | Escopo | Estado | Política | Decisão | Evidência |
+|----|------|--------|--------|----------|---------|-----------|
+| CP-01 | approval | Onda 1 | pending_approval | require_approval | — | — |
+
+## Handoffs
+
+- W1 · `agent-a -> agent-b`: …
+
+## Grafo operacional
+
+- **Nós:** agent-a, capability-x, checkpoint-CP-01
+- **Arestas:** handoff, dependency, blocked_by
+
+## Evidências produzidas
+
+- `path/ou/artefato`: resumo curto
+
+## Bloqueios
+
+- (nenhum ou lista)
+
+## Iterações / retries
+
+- Tarefa/onda | Tentativa | Resultado | Nota
+
+## Tracing operacional
+
+- `run_started` → `phase_entered` → `handoff` → `checkpoint_opened` → `checkpoint_resolved` → `verification_completed`
+
+## Próximo movimento operacional
+
+- **Ação:** …
+- **Motivo:** …

package/oxe/templates/HYPOTHESES.template.md

@@ -1,33 +1,33 @@
----
-oxe_doc: hypotheses
-status: draft
-updated: YYYY-MM-DD
----
-
-<!--
-  Hipóteses Críticas OXE — seção opcional do PLAN.md para tarefas L/XL ou
-  com dependências externas. Cada hipótese deve ser validada antes do
-  checkpoint declarado; se refutada, registrar bloqueio explícito antes de
-  qualquer mutação.
-
-  Formato recomendado: tags XML dentro do MD (para extração pelo context engine)
-  com tabela resumida abaixo para leitura humana.
-
-  Status possíveis: pending | validated | refuted | skipped
--->
-
-## Hipóteses Críticas
-
-<hypothesis id="H1" checkpoint="T2" status="pending">
-  <condition>Descrever a premissa que precisa ser verdadeira para avançar</condition>
-  <validation>Comando ou inspeção que prova/refuta a hipótese (ex: npm install && node test/auth.cjs)</validation>
-  <on_failure>O que fazer se refutada (ex: bloquear T2, abrir pesquisa de alternativa, replanejar)</on_failure>
-</hypothesis>
-
-<!-- Adicionar mais blocos <hypothesis> conforme necessário -->
-
-### Tabela resumida
-
-| ID  | Hipótese               | Checkpoint | Status  |
-|-----|------------------------|------------|---------|
-| H1  | (descrição da premissa)| antes de T?| pending |
+---
+oxe_doc: hypotheses
+status: draft
+updated: YYYY-MM-DD
+---
+
+<!--
+  Hipóteses Críticas OXE — seção opcional do PLAN.md para tarefas L/XL ou
+  com dependências externas. Cada hipótese deve ser validada antes do
+  checkpoint declarado; se refutada, registrar bloqueio explícito antes de
+  qualquer mutação.
+
+  Formato recomendado: tags XML dentro do MD (para extração pelo context engine)
+  com tabela resumida abaixo para leitura humana.
+
+  Status possíveis: pending | validated | refuted | skipped
+-->
+
+## Hipóteses Críticas
+
+<hypothesis id="H1" checkpoint="T2" status="pending">
+  <condition>Descrever a premissa que precisa ser verdadeira para avançar</condition>
+  <validation>Comando ou inspeção que prova/refuta a hipótese (ex: npm install && node test/auth.cjs)</validation>
+  <on_failure>O que fazer se refutada (ex: bloquear T2, abrir pesquisa de alternativa, replanejar)</on_failure>
+</hypothesis>
+
+<!-- Adicionar mais blocos <hypothesis> conforme necessário -->
+
+### Tabela resumida
+
+| ID  | Hipótese               | Checkpoint | Status  |
+|-----|------------------------|------------|---------|
+| H1  | (descrição da premissa)| antes de T?| pending |

package/oxe/templates/LESSONS-METRICS.template.json

@@ -1,13 +1,13 @@
-{
-  "schema_version": "1.0.0",
-  "updated": "{{date}}",
-  "lessons": [],
-  "quality_contracts": [],
-  "summary": {
-    "total_lessons": 0,
-    "active": 0,
-    "deprecated": 0,
-    "high_impact": 0,
-    "avg_success_rate": null
-  }
-}
+{
+  "schema_version": "1.0.0",
+  "updated": "{{date}}",
+  "lessons": [],
+  "quality_contracts": [],
+  "summary": {
+    "total_lessons": 0,
+    "active": 0,
+    "deprecated": 0,
+    "high_impact": 0,
+    "avg_success_rate": null
+  }
+}

package/oxe/templates/NOTES.template.md

@@ -1,16 +1,16 @@
----
-oxe_doc: notes
-updated: YYYY-MM-DD
----
-
-# OXE — Notes
-
-Fila leve de anotações do projeto. Cada bullet é consumido em `/oxe-discuss` ou `/oxe-plan` e depois movido para **Notas incorporadas**.
-
-## Notas em aberto
-
-- YYYY-MM-DD — (nota aqui)
-
-## Notas incorporadas
-
-<!-- Notas movidas automaticamente após consumidas pelo discuss ou plan -->
+---
+oxe_doc: notes
+updated: YYYY-MM-DD
+---
+
+# OXE — Notes
+
+Fila leve de anotações do projeto. Cada bullet é consumido em `/oxe-discuss` ou `/oxe-plan` e depois movido para **Notas incorporadas**.
+
+## Notas em aberto
+
+- YYYY-MM-DD — (nota aqui)
+
+## Notas incorporadas
+
+<!-- Notas movidas automaticamente após consumidas pelo discuss ou plan -->

package/oxe/templates/PLAN-REVIEW.template.md

@@ -1,31 +1,31 @@
----
-oxe_doc: plan_review
-status: draft
-updated: YYYY-MM-DD
-plan_ref: PLAN.md
----
-
-# OXE — Revisão do Plano
-
-## Estado
-
-- **Status:** draft
-- **Atualizado em:** YYYY-MM-DDTHH:mm:ssZ
-- **Origem:** dashboard local ou revisão textual
-
-## Decisão
-
-- **Resultado:** pendente
-- **Justificativa:** —
-
-## Comentários abertos
-
-- Nenhum
-
-## Comentários resolvidos
-
-- Nenhum
-
-## Próxima ação recomendada
-
-- `/oxe-dashboard` para revisar visualmente, ou `/oxe-plan --replan` se houver ajustes estruturais.
+---
+oxe_doc: plan_review
+status: draft
+updated: YYYY-MM-DD
+plan_ref: PLAN.md
+---
+
+# OXE — Revisão do Plano
+
+## Estado
+
+- **Status:** draft
+- **Atualizado em:** YYYY-MM-DDTHH:mm:ssZ
+- **Origem:** dashboard local ou revisão textual
+
+## Decisão
+
+- **Resultado:** pendente
+- **Justificativa:** —
+
+## Comentários abertos
+
+- Nenhum
+
+## Comentários resolvidos
+
+- Nenhum
+
+## Próxima ação recomendada
+
+- `/oxe-dashboard` para revisar visualmente, ou `/oxe-plan --replan` se houver ajustes estruturais.

package/oxe/templates/SESSION.template.md

@@ -1,34 +1,34 @@
-# Session sNNN — <nome>
-
-## Metadados
-
-- **ID:** sNNN
-- **Nome:** <nome>
-- **Status:** active
-- **Criada:** YYYY-MM-DD
-- **Última atividade:** YYYY-MM-DD
-- **Resumo:** <uma linha>
-- **Forked from:** —
-- **Forked at:** —
-
-## Índice de artefatos
-
-| Artefato | Caminho | Status |
-|----------|---------|--------|
-| SESSION | `sessions/sNNN-<slug>/SESSION.md` | ativo |
-
-## Dependências cruzadas
-
-- **Estende:** —
-- **Referenciada por:** —
-- **Decisões globais:** `.oxe/STATE.md`, `.oxe/SESSIONS.md`
-
-## Tags
-
-- `<tag>`
-
-## Histórico
-
-| Data | Evento |
-|------|--------|
-| YYYY-MM-DD | Sessão criada |
+# Session sNNN — <nome>
+
+## Metadados
+
+- **ID:** sNNN
+- **Nome:** <nome>
+- **Status:** active
+- **Criada:** YYYY-MM-DD
+- **Última atividade:** YYYY-MM-DD
+- **Resumo:** <uma linha>
+- **Forked from:** —
+- **Forked at:** —
+
+## Índice de artefatos
+
+| Artefato | Caminho | Status |
+|----------|---------|--------|
+| SESSION | `sessions/sNNN-<slug>/SESSION.md` | ativo |
+
+## Dependências cruzadas
+
+- **Estende:** —
+- **Referenciada por:** —
+- **Decisões globais:** `.oxe/STATE.md`, `.oxe/SESSIONS.md`
+
+## Tags
+
+- `<tag>`
+
+## Histórico
+
+| Data | Evento |
+|------|--------|
+| YYYY-MM-DD | Sessão criada |

package/oxe/templates/SKILL.template.md

@@ -1,26 +1,26 @@
----
-oxe_skill: true
-id: <skill-id>
-name: <Human Readable Name>
-version: 1.0.0
-type: persona | capability | composite
-scope: global | project
-description: <one-line description>
-invoke: "@<skill-id>"
-references: []
-tags: []
----
-
-# Skill: <name>
-
-## Descrição
-
-(Quando e como usar este skill. Uma ou duas frases.)
-
-## Ativação
-
-Mencionar `@<skill-id>` no chat ou incluir na atribuição de agente em plan-agents.json (`"persona": "<skill-id>"`).
-
-## Saída esperada
-
-(O que o agente faz ao adotar este skill.)
+---
+oxe_skill: true
+id: <skill-id>
+name: <Human Readable Name>
+version: 1.0.0
+type: persona | capability | composite
+scope: global | project
+description: <one-line description>
+invoke: "@<skill-id>"
+references: []
+tags: []
+---
+
+# Skill: <name>
+
+## Descrição
+
+(Quando e como usar este skill. Uma ou duas frases.)
+
+## Ativação
+
+Mencionar `@<skill-id>` no chat ou incluir na atribuição de agente em plan-agents.json (`"persona": "<skill-id>"`).
+
+## Saída esperada
+
+(O que o agente faz ao adotar este skill.)

package/oxe/templates/STATE.md

@@ -1,15 +1,15 @@
 # OXE — Estado
 
-## Fase atual
-
-`initial` — defina após primeiro scan: `scan_complete` | `spec_ready` | `discuss_complete` | `plan_ready` | `quick_active` | `executing` | `verify_complete` | `verify_failed`
-
-## Sessão ativa (opcional — `/oxe-session`)
-
-- **active_session:** (path relativo a `.oxe/` — ex.: `sessions/s001-auth-redesign` — ou — se nenhuma)
-- **session_id:** (ex.: `s001` — ou —)
-
-## Último scan
+## Fase atual
+
+`initial` — defina após primeiro scan: `scan_complete` | `spec_ready` | `discuss_complete` | `plan_ready` | `quick_active` | `executing` | `verify_complete` | `verify_failed`
+
+## Sessão ativa (opcional — `/oxe-session`)
+
+- **active_session:** (path relativo a `.oxe/` — ex.: `sessions/s001-auth-redesign` — ou — se nenhuma)
+- **session_id:** (ex.: `s001` — ou —)
+
+## Último scan
 
 - **Data:** (use **YYYY-MM-DD** para o `oxe-cc doctor` avisar scan antigo com `scan_max_age_days` em `.oxe/config.json`)
 - **Notas:** (opcional)
@@ -20,32 +20,32 @@
 - **Notas:** (opcional; ex.: "só STRUCTURE e TESTING")
 - **last_retro:** (YYYY-MM-DD — preenchido por **`/oxe-retro`** ao concluir retrospectiva; lido por `oxe-cc doctor` para rastrear ciclos sem lições)
 
-## Contexto do plano / quick (opcional)
-
-- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
-- **Última onda executada:** (número ou —)
-- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
-
-## Checkpoints de aprovação (opcional)
-
-- **checkpoint_status:** `pending_approval` | `approved` | `rejected` | `overridden` | —
-- **checkpoint_ref:** `.oxe/CHECKPOINTS.md` ou artefato de sessão correspondente
-- **Notas:** (ex.: aguardando aprovação para Onda 2)
-
-## Runtime operacional (opcional)
-
-- **runtime_status:** `planned` | `running` | `paused` | `waiting_approval` | `failed` | `completed` | `replaying` | `aborted` | —
-- **runtime_ref:** `.oxe/EXECUTION-RUNTIME.md` ou artefato de sessão correspondente
-- **active_run_ref:** `.oxe/ACTIVE-RUN.json` ou artefato de sessão correspondente
-- **events_ref:** `.oxe/OXE-EVENTS.ndjson` ou artefato de sessão correspondente
-- **Notas:** (agentes ativos, bloqueio principal, handoff pendente)
-
-## Revisão do plano (opcional — dashboard / aprovação)
-
-- **plan_review_status:** `draft` | `in_review` | `approved` | `rejected` | `needs_revision` | —
-- **plan_review_updated:** (ISO legível — ex.: `2026-04-10T14:22:00-03:00`)
-- **plan_review_ref:** `.oxe/PLAN-REVIEW.md` ou artefato de sessão correspondente
-- **Notas:** (ex.: aprovado para execute; revisão pendente da onda 2)
+## Contexto do plano / quick (opcional)
+
+- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
+- **Última onda executada:** (número ou —)
+- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
+
+## Checkpoints de aprovação (opcional)
+
+- **checkpoint_status:** `pending_approval` | `approved` | `rejected` | `overridden` | —
+- **checkpoint_ref:** `.oxe/CHECKPOINTS.md` ou artefato de sessão correspondente
+- **Notas:** (ex.: aguardando aprovação para Onda 2)
+
+## Runtime operacional (opcional)
+
+- **runtime_status:** `planned` | `running` | `paused` | `waiting_approval` | `failed` | `completed` | `replaying` | `aborted` | —
+- **runtime_ref:** `.oxe/EXECUTION-RUNTIME.md` ou artefato de sessão correspondente
+- **active_run_ref:** `.oxe/ACTIVE-RUN.json` ou artefato de sessão correspondente
+- **events_ref:** `.oxe/OXE-EVENTS.ndjson` ou artefato de sessão correspondente
+- **Notas:** (agentes ativos, bloqueio principal, handoff pendente)
+
+## Revisão do plano (opcional — dashboard / aprovação)
+
+- **plan_review_status:** `draft` | `in_review` | `approved` | `rejected` | `needs_revision` | —
+- **plan_review_updated:** (ISO legível — ex.: `2026-04-10T14:22:00-03:00`)
+- **plan_review_ref:** `.oxe/PLAN-REVIEW.md` ou artefato de sessão correspondente
+- **Notas:** (ex.: aprovado para execute; revisão pendente da onda 2)
 
 ## Blueprint de agentes (sessão) (opcional — `/oxe-plan-agent`)
 
@@ -102,28 +102,28 @@ _(O agente pode preencher após cada onda.)_
 
 - (nome do workstream ativo — ou — para pipeline principal)
 
-## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
+## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
 
 Sidecars de memória persistente por agente/sessão. Armazenados em `.oxe/memory/`.
 
-- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
-
-## Camadas de memória (contrato)
-
-- **memory_read_order:** `runtime_state -> session_memory -> project_memory -> evidence`
-- **session_memory_ref:** `SESSION.md` ou —
-- **project_memory_ref:** `.oxe/global/LESSONS.md`
-- **evidence_ref:** `INVESTIGATIONS.md`, `VERIFY.md` e derivados
-
-## Capabilities nativas (opcional)
-
-- **capabilities_ref:** `.oxe/CAPABILITIES.md`
-- **Capabilities ativas:** (IDs ou —)
-
-## Investigações estruturadas (opcional)
-
-- **investigations_ref:** `.oxe/INVESTIGATIONS.md` ou índice de sessão
-- **Última investigação:** (path ou —)
+- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
+
+## Camadas de memória (contrato)
+
+- **memory_read_order:** `runtime_state -> session_memory -> project_memory -> evidence`
+- **session_memory_ref:** `SESSION.md` ou —
+- **project_memory_ref:** `.oxe/global/LESSONS.md`
+- **evidence_ref:** `INVESTIGATIONS.md`, `VERIFY.md` e derivados
+
+## Capabilities nativas (opcional)
+
+- **capabilities_ref:** `.oxe/CAPABILITIES.md`
+- **Capabilities ativas:** (IDs ou —)
+
+## Investigações estruturadas (opcional)
+
+- **investigations_ref:** `.oxe/INVESTIGATIONS.md` ou índice de sessão
+- **Última investigação:** (path ou —)
 
 ## Decisões persistentes
 

package/oxe/templates/WORKFLOW_AUTHORING.md

@@ -36,7 +36,7 @@ Mantenha tags **abertas e fechadas** explicitamente (evita ambiguidade para leit
 - Template opcional de pasta `docs/` brownfield: [`DOCS_BROWNFIELD_LAYOUT.md`](DOCS_BROWNFIELD_LAYOUT.md) (copiado para `.oxe/templates/` na instalação).
 - O `SKILL.md` principal do passo deve permanecer o **mapa**: objetivo, contexto essencial, sequência, critérios de sucesso.
 
-## 4. Comandos Cursor e prompts Copilot (frontmatter)
+## 4. Comandos Cursor e prompts Copilot (frontmatter)
 
 Ficheiros em `.cursor/commands/` e `.github/prompts/` costumam ter YAML inicial:
 
@@ -49,23 +49,23 @@ description: Resumo de 5–8 palavras. Use quando o utilizador pedir X, Y ou Z.
 - **Resumo:** o que o passo faz.
 - **Gatilhos:** frases ou intenções que devem ativar o comando (evita disparar em tudo).
 
-O corpo do ficheiro deve **apontar** para o workflow em `oxe/workflows/<passo>.md` (ou `.oxe/workflows/`) sem duplicar a lógica por completo.
-
-### Metadata cognitiva multi-runtime
-
-Prompts e wrappers OXE podem carregar metadata adicional para sincronizar a postura de raciocínio entre runtimes:
-
-```yaml
-oxe_reasoning_mode: discovery | planning | execution | review | status
-oxe_question_policy: explore_first | ask_high_impact_only | none
-oxe_output_contract: situational | plan | execution | findings | routing
-oxe_tool_profile: read_heavy | write_bounded | review_heavy | mixed
-oxe_confidence_policy: explicit | rubric | optional
-```
-
-- Use a mesma metadata em `.github/prompts/` e `commands/oxe/`.
-- O corpo do wrapper deve incluir um bloco curto de **Contrato de raciocínio OXE deste comando** consistente com essa metadata.
-- Cursor, Codex e CLIs derivados devem preservar essa semântica; não manter regras cognitivas importantes só numa integração.
+O corpo do ficheiro deve **apontar** para o workflow em `oxe/workflows/<passo>.md` (ou `.oxe/workflows/`) sem duplicar a lógica por completo.
+
+### Metadata cognitiva multi-runtime
+
+Prompts e wrappers OXE podem carregar metadata adicional para sincronizar a postura de raciocínio entre runtimes:
+
+```yaml
+oxe_reasoning_mode: discovery | planning | execution | review | status
+oxe_question_policy: explore_first | ask_high_impact_only | none
+oxe_output_contract: situational | plan | execution | findings | routing
+oxe_tool_profile: read_heavy | write_bounded | review_heavy | mixed
+oxe_confidence_policy: explicit | rubric | optional
+```
+
+- Use a mesma metadata em `.github/prompts/` e `commands/oxe/`.
+- O corpo do wrapper deve incluir um bloco curto de **Contrato de raciocínio OXE deste comando** consistente com essa metadata.
+- Cursor, Codex e CLIs derivados devem preservar essa semântica; não manter regras cognitivas importantes só numa integração.
 
 ## 5. Script vs agente