oxe-cc 1.4.0 → 1.4.1

package/.cursor/commands/oxe-ask.md

@@ -38,8 +38,10 @@ OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão at
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ask.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ask.md ou oxe/workflows/ask.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como pergunta e foco.

package/.cursor/commands/oxe-capabilities.md

@@ -38,8 +38,10 @@ OXE — gerir capabilities nativas do projeto
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/capabilities.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/capabilities.md ou oxe/workflows/capabilities.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como ação sobre capabilities.

package/.cursor/commands/oxe-checkpoint.md

@@ -38,8 +38,10 @@ OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/checkpoint.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/checkpoint.md ou oxe/workflows/checkpoint.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.

package/.cursor/commands/oxe-compact.md

@@ -37,8 +37,10 @@ OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/compact.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/compact.md ou oxe/workflows/compact.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.

package/.cursor/commands/oxe-dashboard.md

@@ -38,8 +38,10 @@ OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/dashboard.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/dashboard.md ou oxe/workflows/dashboard.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco opcional.

package/.cursor/commands/oxe-debug.md

@@ -38,8 +38,10 @@ OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/debug.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/debug.md ou oxe/workflows/debug.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.

package/.cursor/commands/oxe-discuss.md

@@ -38,6 +38,8 @@ OXE — Discussão antes do plano
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/discuss.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/discuss.md ou oxe/workflows/discuss.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->

package/.cursor/commands/oxe-execute.md

@@ -41,8 +41,10 @@ OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/execute.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/execute.md ou oxe/workflows/execute.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
 
-Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso. Lê `.oxe/workflows/execute.md` na raiz do projeto atual (CWD).
+<!-- oxe-workflow-resolution:end -->
+
+Usa o texto adicional desta mensagem como foco: `A` (Completo), `B` (Por onda), `C` (Por tarefa), `onda N`, `Tn`, ou confirmação de progresso.

package/.cursor/commands/oxe-forensics.md

@@ -38,8 +38,10 @@ OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/forensics.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/forensics.md ou oxe/workflows/forensics.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).

package/.cursor/commands/oxe-help.md

@@ -37,6 +37,8 @@ OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE help**. Lê e segue **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/help.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/help.md ou oxe/workflows/help.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->

package/.cursor/commands/oxe-loop.md

@@ -38,8 +38,10 @@ OXE — Loop iterativo por onda com retries automáticos e diagnóstico inline
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/loop.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/loop.md ou oxe/workflows/loop.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 `$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.

package/.cursor/commands/oxe-milestone.md

@@ -38,8 +38,10 @@ OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/milestone.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/milestone.md ou oxe/workflows/milestone.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

package/.cursor/commands/oxe-next.md

@@ -37,6 +37,8 @@ OXE — Próximo passo (lê STATE.md)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE next**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/next.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/next.md ou oxe/workflows/next.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->

package/.cursor/commands/oxe-obs.md

@@ -38,8 +38,10 @@ OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorpora
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/obs.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/obs.md ou oxe/workflows/obs.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como a observação a registrar.

package/.cursor/commands/oxe-plan-agent.md

@@ -37,8 +37,10 @@ OXE — PLAN.md + plan-agents.json (plano orientado a agentes / ondas)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/plan-agent.md ou oxe/workflows/plan-agent.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.

package/.cursor/commands/oxe-plan.md

@@ -38,8 +38,10 @@ OXE — Gera .oxe/PLAN.md com verificação por tarefa
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/plan.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/plan.md ou oxe/workflows/plan.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

package/.cursor/commands/oxe-project.md

@@ -38,8 +38,10 @@ OXE — Gestão de projeto unificada: milestone, workstream e checkpoint
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/project.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/project.md ou oxe/workflows/project.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 `$ARGUMENTS` = subcomando: `milestone new|complete|status|audit`, `workstream new|switch|list|close <nome>`, `checkpoint [slug]`, ou vazio para status atual.

package/.cursor/commands/oxe-quick.md

@@ -38,8 +38,10 @@ OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/quick.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/quick.md ou oxe/workflows/quick.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como objetivo e contexto.

package/.cursor/commands/oxe-research.md

@@ -38,8 +38,10 @@ OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/research.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/research.md ou oxe/workflows/research.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).

package/.cursor/commands/oxe-retro.md

@@ -38,8 +38,10 @@ OXE — Retrospectiva de ciclo: 3–5 lições prescritivas em .oxe/LESSONS.md p
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/retro.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/retro.md ou oxe/workflows/retro.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.

package/.cursor/commands/oxe-review-pr.md

@@ -38,8 +38,10 @@ OXE — Revisão de PR (link GitHub, branches ou SHAs)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/review-pr.md ou oxe/workflows/review-pr.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 **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/.cursor/commands/oxe-route.md

@@ -38,8 +38,10 @@ OXE — Router: um pedido em linguagem natural → um comando/workflow
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/route.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/route.md ou oxe/workflows/route.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).

package/.cursor/commands/oxe-scan.md

@@ -38,8 +38,10 @@ OXE — Scan do repositório (.oxe/codebase/)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/scan.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/scan.md ou oxe/workflows/scan.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).

package/.cursor/commands/oxe-security.md

@@ -38,8 +38,10 @@ OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0/P1/P2 vinculados ao
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/security.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/security.md ou oxe/workflows/security.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.

package/.cursor/commands/oxe-session.md

@@ -38,8 +38,10 @@ OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/session.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/session.md ou oxe/workflows/session.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
 
-Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`. Lê `.oxe/workflows/session.md` na raiz do projeto atual (CWD).
+<!-- oxe-workflow-resolution:end -->
+
+Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`.

package/.cursor/commands/oxe-ship.md

@@ -38,8 +38,10 @@ OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Fla
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ship.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ship.md ou oxe/workflows/ship.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).

package/.cursor/commands/oxe-skill.md

@@ -38,8 +38,10 @@ OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/skill.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/skill.md ou oxe/workflows/skill.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando ou invocação de skill.

package/.cursor/commands/oxe-spec.md

@@ -38,8 +38,10 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/spec.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/spec.md ou oxe/workflows/spec.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

package/.cursor/commands/oxe-ui-review.md

@@ -38,8 +38,10 @@ OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ui-review.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ui-review.md ou oxe/workflows/ui-review.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.

package/.cursor/commands/oxe-ui-spec.md

@@ -38,8 +38,10 @@ OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ui-spec.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ui-spec.md ou oxe/workflows/ui-spec.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.

package/.cursor/commands/oxe-update.md

@@ -37,8 +37,10 @@ Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE update**. Lê e segue **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/update.md` (na raiz do repositório em contexto; ou `..oxe/workflows/update.md` se a instalação aninhou os workflows)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/update.md ou oxe/workflows/update.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 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`**.

package/.cursor/commands/oxe-validate-gaps.md

@@ -38,8 +38,10 @@ OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/validate-gaps.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/validate-gaps.md ou oxe/workflows/validate-gaps.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Requer `VERIFY.md` e `PLAN.md` já existentes. Texto adicional: foco opcional em tarefa **Tn** ou critério **A***.

package/.cursor/commands/oxe-verify.md

@@ -41,8 +41,10 @@ OXE — Valida implementação (.oxe/VERIFY.md)
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/verify.md` (na raiz do repositório em contexto)
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/verify.md ou oxe/workflows/verify.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.

package/.cursor/commands/oxe-workstream.md

@@ -38,8 +38,10 @@ OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome>
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/workstream.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/workstream.md ou oxe/workflows/workstream.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

package/.cursor/commands/oxe.md

@@ -38,8 +38,12 @@ OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
+
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/oxe.md ou oxe/workflows/oxe.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
 
-`.oxe/workflows/oxe.md`
+<!-- oxe-workflow-resolution:end -->
+
+Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
 
 `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 4af3aaa3d86aabef
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/ask.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/ask.md ou oxe/workflows/ask.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como pergunta e foco.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 35b244a016d5c65c
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/capabilities.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/capabilities.md ou oxe/workflows/capabilities.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como ação sobre capabilities.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 536e476616b47060
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/checkpoint.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/checkpoint.md ou oxe/workflows/checkpoint.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.

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

@@ -37,8 +37,10 @@ oxe_semantics_hash: ad10e8dc6f83b4fe
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/compact.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/compact.md ou oxe/workflows/compact.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 37f74d8be3442fe1
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/dashboard.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/dashboard.md ou oxe/workflows/dashboard.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como foco opcional.

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

@@ -38,8 +38,10 @@ oxe_semantics_hash: 7912f4caf80c2915
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
+<!-- oxe-workflow-resolution:start -->
 
-`.oxe/workflows/debug.md`
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/debug.md ou oxe/workflows/debug.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
 
 Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.

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

@@ -38,6 +38,10 @@ oxe_semantics_hash: 6994c2427094eff3
 
 <!-- oxe-reasoning-contract:end -->
 
-Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+<!-- oxe-workflow-resolution:start -->
+
+**Resolução do workflow canónico:** a partir do CWD atual, subir diretórios até encontrar .oxe/workflows/discuss.md ou oxe/workflows/discuss.md. Ler e aplicar integralmente o primeiro ficheiro encontrado. Não assumir que o CWD já é a raiz do repositório. Se nenhum existir, reportar os paths tentados e parar.
+
+<!-- oxe-workflow-resolution:end -->
+
 
-`.oxe/workflows/discuss.md`