oxe-cc 1.0.0 → 1.2.1

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

@@ -40,6 +40,6 @@ OXE — Perguntar pela situação atual com leitura robusta de STATE, sessão at
 
 Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/ask.md`
+`.oxe/workflows/ask.md`
 
 Usa o texto adicional desta mensagem como pergunta e foco.

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

@@ -40,6 +40,6 @@ OXE — gerir capabilities nativas do projeto
 
 Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/capabilities.md`
+`.oxe/workflows/capabilities.md`
 
 Usa o texto adicional desta mensagem como ação sobre capabilities.

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

@@ -40,6 +40,6 @@ OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
 
 Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/checkpoint.md`
+`.oxe/workflows/checkpoint.md`
 
 O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.

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

@@ -39,6 +39,6 @@ OXE — refresh .oxe/codebase vs repo + CODEBASE-DELTA + RESUME
 
 Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/compact.md`
+`.oxe/workflows/compact.md`
 
 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

@@ -40,6 +40,6 @@ OXE — visualizar runtime, ondas, checkpoints e saúde operacional da trilha
 
 Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/dashboard.md`
+`.oxe/workflows/dashboard.md`
 
 Usa o texto adicional desta mensagem como foco opcional.

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

@@ -40,6 +40,6 @@ OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
 
 Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/debug.md`
+`.oxe/workflows/debug.md`
 
 Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.

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

@@ -40,4 +40,4 @@ OXE — Discussão antes do plano
 
 Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/discuss.md`
+`.oxe/workflows/discuss.md`

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

@@ -40,6 +40,6 @@ OXE — Executar plano (solo ou com agentes): escolha Completo (1 sessão) | Por
 
 Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/execute.md`
+`.oxe/workflows/execute.md`
 
-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).
+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).

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

@@ -40,6 +40,6 @@ OXE — Diagnóstico pós-falha (FORENSICS.md + reingresso scan/plan/execute)
 
 Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/forensics.md`
+`.oxe/workflows/forensics.md`
 
 Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).

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

@@ -39,4 +39,4 @@ 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)
+`.oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -40,6 +40,6 @@ OXE — Loop iterativo por onda com retries automáticos e diagnóstico inline
 
 Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/loop.md`
+`.oxe/workflows/loop.md`
 
 `$ARGUMENTS` = onda alvo e máximo de tentativas (ex.: `onda 2 max:5`). Pré-requisito: `.oxe/PLAN.md`.

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

@@ -40,6 +40,6 @@ OXE — Marcos de entrega (M-NN): new, complete (arquiva em .oxe/milestones/M-NN
 
 Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/milestone.md`
+`.oxe/workflows/milestone.md`
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

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

@@ -39,4 +39,4 @@ 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)
+`.oxe/workflows/next.md` (na raiz do repositório em contexto)

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

@@ -40,6 +40,6 @@ OXE — Observação contextual: registra em .oxe/OBSERVATIONS.md e é incorpora
 
 Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/obs.md`
+`.oxe/workflows/obs.md`
 
 Usa o texto adicional desta mensagem como a observação a registrar.

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

@@ -39,6 +39,6 @@ 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)
+`.oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
 
 Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.

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

@@ -40,6 +40,6 @@ OXE — Gera .oxe/PLAN.md com verificação por tarefa
 
 Executa o workflow **OXE plan**. Lê e aplica **integralmente**:
 
-`oxe/workflows/plan.md` (na raiz do repositório em contexto)
+`.oxe/workflows/plan.md` (na raiz do repositório em contexto)
 
 Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

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

@@ -40,6 +40,6 @@ OXE — Gestão de projeto unificada: milestone, workstream e checkpoint
 
 Executa o workflow **OXE project** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/project.md`
+`.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/.cursor/commands/oxe-quick.md

@@ -40,6 +40,6 @@ OXE — Modo rápido com Plan-Driven Dynamic Agents lean: objetivo → passos
 
 Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/quick.md`
+`.oxe/workflows/quick.md`
 
 Usa o texto adicional desta mensagem como objetivo e contexto.

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

@@ -40,6 +40,6 @@ OXE — Pesquisa exploratória (.oxe/research/ + índice RESEARCH.md)
 
 Executa o workflow **OXE research** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/research.md`
+`.oxe/workflows/research.md`
 
 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

@@ -40,6 +40,6 @@ OXE — Retrospectiva de ciclo: 3–5 lições prescritivas em .oxe/LESSONS.md p
 
 Executa o workflow **OXE retro** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/retro.md`
+`.oxe/workflows/retro.md`
 
 Lê VERIFY.md, FORENSICS.md, SUMMARY.md. `$ARGUMENTS` = contexto extra opcional.

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

@@ -40,6 +40,6 @@ OXE — Revisão de PR (link GitHub, branches ou SHAs)
 
 Executa o workflow **OXE review-pr**. Lê e aplica **integralmente**:
 
-`oxe/workflows/review-pr.md` (na raiz do repositório em contexto)
+`.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/.cursor/commands/oxe-route.md

@@ -40,6 +40,6 @@ OXE — Router: um pedido em linguagem natural → um comando/workflow
 
 Executa o workflow **OXE route** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/route.md`
+`.oxe/workflows/route.md`
 
 Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).

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

@@ -40,6 +40,6 @@ OXE — Scan do repositório (.oxe/codebase/)
 
 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)
+`.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/.cursor/commands/oxe-security.md

@@ -40,6 +40,6 @@ OXE — Auditoria de segurança OWASP (.oxe/SECURITY.md): P0/P1/P2 vinculados ao
 
 Executa o workflow **OXE security** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/security.md`
+`.oxe/workflows/security.md`
 
 Lê `.oxe/codebase/STACK.md` para determinar categorias OWASP aplicáveis. `$ARGUMENTS` = foco opcional.

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

@@ -40,6 +40,6 @@ OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
 
 Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/session.md`
+`.oxe/workflows/session.md`
 
-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).
+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).

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

@@ -0,0 +1,45 @@
+---
+description: "OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run"
+argument-hint: "[--message 'mensagem'] [--amend] [--verify-first] [--no-checks] [--dry-run]"
+oxe_workflow_slug: ship
+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: 3893740934e4f82b
+---
+
+OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** ship
+- **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:** `3893740934e4f82b`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/ship.md` e `.oxe/context/packs/ship.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 ship --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:verify_without_override · missing:tracked_changes
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
+
+`.oxe/workflows/ship.md` (na raiz do repositório em contexto)
+
+Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).

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

@@ -40,6 +40,6 @@ OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
 
 Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/skill.md`
+`.oxe/workflows/skill.md`
 
 Usa o texto adicional desta mensagem como subcomando ou invocação de skill.

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

@@ -40,6 +40,6 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
 
 Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
 
-`oxe/workflows/spec.md` (na raiz do repositório em contexto)
+`.oxe/workflows/spec.md` (na raiz do repositório em contexto)
 
 Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

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

@@ -40,6 +40,6 @@ OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
 
 Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/ui-review.md`
+`.oxe/workflows/ui-review.md`
 
 Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.

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

@@ -40,6 +40,6 @@ OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
 
 Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/ui-spec.md`
+`.oxe/workflows/ui-spec.md`
 
 Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.

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

@@ -39,6 +39,6 @@ Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE
 
 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)
+`.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`**.

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

@@ -40,6 +40,6 @@ OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
 
 Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/validate-gaps.md`
+`.oxe/workflows/validate-gaps.md`
 
 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

@@ -40,6 +40,6 @@ OXE — Valida implementação (.oxe/VERIFY.md)
 
 Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
 
-`oxe/workflows/verify.md` (na raiz do repositório em contexto)
+`.oxe/workflows/verify.md` (na raiz do repositório em contexto)
 
 Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.

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

@@ -40,6 +40,6 @@ OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome>
 
 Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/workstream.md`
+`.oxe/workflows/workstream.md`
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

package/.cursor/commands/oxe.md

@@ -1,5 +1,5 @@
 ---
-description: "OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais"
+description: "OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE"
 argument-hint: "[contexto em linguagem natural | 'help' | vazio para próximo passo]"
 oxe_workflow_slug: oxe
 oxe_reasoning_mode: status
@@ -12,7 +12,7 @@ oxe_contract_version: 2.0.0
 oxe_semantics_hash: d7f65cd3f77b0abc
 ---
 
-OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais
+OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE
 
 <!-- oxe-reasoning-contract:start -->
 
@@ -40,6 +40,6 @@ OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos ess
 
 Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/oxe.md`
+`.oxe/workflows/oxe.md`
 
-`$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → 8 comandos essenciais.
+`$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.

package/.github/copilot-instructions.md

@@ -84,4 +84,94 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 
 Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
 
-**Autoria de workflows:** guia em **`oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`oxe/workflows/workflow-authoring.md`** (ou `.oxe/workflows/` no projeto alvo).
+**Autoria de workflows:** guia em **`oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`oxe/workflows/workflow-authoring.md`** (ou `.oxe/workflows/` no projeto alvo).
+
+<!-- oxe-cc:install-begin -->
+# OXE — fluxo spec-driven (multi-IDE / multi-CLI)
+
+Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`.oxe/workflows/*.md`** (no pacote) ou **`..oxe/workflows/*.md`** / **`.oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
+
+Os prompts OXE carregam metadata cognitiva comum (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`). Essa metadata não substitui o workflow canónico; ela alinha a postura de raciocínio entre runtimes para discovery, planning, execution, review e status.
+
+## Quando aplicar
+
+Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o projeto”, “criar spec OXE”, “plano OXE com testes”, “verificar OXE”, trate como fluxo OXE e siga o arquivo de workflow correspondente abaixo.
+
+## Workflows (fonte única)
+
+| Passo | Arquivo | Gatilhos naturais (exemplos) |
+|-------|---------|-------------------------------|
+| Scan | `.oxe/workflows/scan.md` | “oxe scan”, “mapear o repo”, “atualizar codebase OXE” |
+| Spec | `.oxe/workflows/spec.md` | “oxe spec”, “escrever SPEC.md”, “requisitos OXE” |
+| Discuss | `.oxe/workflows/discuss.md` | “oxe discuss”, “perguntas antes do plano”, “DISCUSS.md” |
+| Plan | `.oxe/workflows/plan.md` | “oxe plan”, “PLAN.md”, “plano com testes por tarefa”, “replan” |
+| Plan (agentes) | `.oxe/workflows/plan-agent.md` | “plan agent”, “plan-agents.json”, “subagentes”, “ondas por agente”, blueprint de execução *(prompt: `/oxe-plan-agent`)* |
+| Quick | `.oxe/workflows/quick.md` | “oxe quick”, “fix rápido OXE”, “QUICK.md” |
+| Execute | `.oxe/workflows/execute.md` | “oxe execute”, “executar onda”, “onda 2 OXE” |
+| Verify | `.oxe/workflows/verify.md` | “oxe verify”, “validar plano OXE”, “VERIFY.md” |
+| Validate gaps | `.oxe/workflows/validate-gaps.md` | “validate gaps”, “Nyquist-lite”, “cobertura de critérios” após verify *(prompt: `/oxe-validate-gaps`)* |
+| Next | `.oxe/workflows/next.md` | “oxe next”, “próximo passo OXE” |
+| Review PR | `.oxe/workflows/review-pr.md` | “revisar PR”, link `…/pull/10`, “diff entre branches” *(prompt Copilot: `/oxe-review-pr`)* |
+| Help | `.oxe/workflows/help.md` | “oxe help”, “como usar OXE” |
+| Update | `.oxe/workflows/update.md` | “oxe update”, “atualizar oxe-cc”, “há versão nova no npm” *(prompt: `/oxe-update`)* |
+| Forensics | `.oxe/workflows/forensics.md` | “oxe forensics”, “preso após verify”, “doctor falhou”, incoerência STATE/VERIFY *(prompt: `/oxe-forensics`)* |
+| Debug | `.oxe/workflows/debug.md` | “oxe debug”, teste vermelho, stack trace durante implementação *(prompt: `/oxe-debug`)* |
+| Route | `.oxe/workflows/route.md` | “que comando OXE uso”, desambiguar intenção *(prompt: `/oxe-route`)* |
+| Research | `.oxe/workflows/research.md` | “oxe research”, mapa de sistema, spike, engenharia reversa, modernização *(prompt: `/oxe-research`)* |
+| Compact | `.oxe/workflows/compact.md` | “oxe compact”, refresh `.oxe/codebase/` vs repo + `CODEBASE-DELTA.md` + `RESUME.md` *(prompt: `/oxe-compact`)* |
+| Checkpoint | `.oxe/workflows/checkpoint.md` | “oxe checkpoint”, snapshot de sessão `.oxe/checkpoints/` *(prompt: `/oxe-checkpoint`)* |
+| UI spec | `.oxe/workflows/ui-spec.md` | “UI-SPEC”, contrato de interface após spec *(prompt: `/oxe-ui-spec`)* |
+| UI review | `.oxe/workflows/ui-review.md` | “auditoria UI”, UI-REVIEW *(prompt: `/oxe-ui-review`)* |
+| Autoria de workflow | `.oxe/workflows/workflow-authoring.md` | “rever workflow OXE”, “revisar `.oxe/workflows/foo.md` contra o guia”, alinhar passo ao `WORKFLOW_AUTHORING.md` |
+| Ask | `.oxe/workflows/ask.md` | “oxe ask”, “situação atual OXE”, “o que está acontecendo”, “ler STATE” *(prompt: `/oxe-ask`)* |
+| Obs | `.oxe/workflows/obs.md` | “oxe obs”, “registrar observação”, “anotar descoberta”, “restrição encontrada” *(prompt: `/oxe-obs`)* |
+| Session | `.oxe/workflows/session.md` | “oxe session”, “nova sessão”, “alternar sessão”, “retomar sessão”, “fechar sessão” *(prompt: `/oxe-session`)* |
+| Retro | `.oxe/workflows/retro.md` | “oxe retro”, “retrospectiva”, “lições do ciclo”, “LESSONS.md” *(prompt: `/oxe-retro`)* |
+| Dashboard | `.oxe/workflows/dashboard.md` | “oxe dashboard”, “visualizar runtime”, “ondas ativas”, “status visual” *(prompt: `/oxe-dashboard`)* |
+| Loop | `.oxe/workflows/loop.md` | “oxe loop”, “iterar até passar”, “loop de verify” *(prompt: `/oxe-loop`)* |
+| Security | `.oxe/workflows/security.md` | “oxe security”, “auditoria OWASP”, “P0/P1 de segurança” *(prompt: `/oxe-security`)* |
+| Milestone | `.oxe/workflows/milestone.md` | “oxe milestone”, “marco de entrega”, “M-01”, “fechar milestone” *(prompt: `/oxe-milestone`)* |
+| Workstream | `.oxe/workflows/workstream.md` | “oxe workstream”, “trilha paralela”, “alternar workstream” *(prompt: `/oxe-workstream`)* |
+| Capabilities | `.oxe/workflows/capabilities.md` | “oxe capabilities”, “listar capabilities”, “instalar capability” *(prompt: `/oxe-capabilities`)* |
+| Project | `.oxe/workflows/project.md` | “oxe project”, “gestão de projeto OXE”, “milestone + workstream + checkpoint” *(prompt: `/oxe-project`)* |
+| Router | `.oxe/workflows/oxe.md` | “oxe”, “que comando usar”, entrada universal *(prompt: `/oxe`)* |
+| Skill | `.oxe/workflows/skill.md` | “oxe skill”, “@executor”, “@researcher”, “listar skills”, “novo skill” *(prompt: `/oxe-skill`)* |
+
+**Regra:** leia o Markdown indicado e execute **todos** os passos e critérios de sucesso descritos nesse arquivo. Não atalhe: crie ou atualize os arquivos em `.oxe/` conforme o workflow.
+
+**Cursor / Copilot / Claude:** slash `/oxe-*` disponíveis: `/oxe`, `/oxe-ask`, `/oxe-obs`, `/oxe-quick`, `/oxe-scan`, `/oxe-spec`, `/oxe-discuss`, `/oxe-plan`, `/oxe-plan-agent`, `/oxe-execute`, `/oxe-verify`, `/oxe-validate-gaps`, `/oxe-retro`, `/oxe-session`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-project`, `/oxe-checkpoint`, `/oxe-dashboard`, `/oxe-loop`, `/oxe-security`, `/oxe-capabilities`, `/oxe-skill`, `/oxe-next`, `/oxe-update`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-compact`, `/oxe-ui-spec`, `/oxe-ui-review` — em `~/.cursor/commands/` (gerados de `.github/prompts/` via `npm run sync:cursor`). **Não** há comando slash dedicado a review-pr — use linguagem natural + `.oxe/workflows/review-pr.md` em contexto.
+
+## Onde ficam as integrações (após `npx oxe-cc`)
+
+- **Cursor:** comandos em **`~/.cursor/commands/`** (slash `/oxe-*`). Diretório alternativo: variável **`CURSOR_CONFIG_DIR`**.
+- **GitHub Copilot (VS Code):** integração **workspace-first**: instruções em **`.github/copilot-instructions.md`** e **prompt files** em **`.github/prompts/`** (`oxe-*.prompt.md`). Se existir conteúdo em `~/.copilot/prompts/`, trate como **legado detectável**, não como fonte primária da IDE.
+- **Copilot CLI:** com `oxe-cc --copilot-cli`, use **agent skills** em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …). Depois de instalar: **`/skills reload`**. Pastas **`~/.claude/commands/`** e **`~/.copilot/commands/`** são cópia legado; **`CLAUDE_CONFIG_DIR`**, **`COPILOT_CONFIG_DIR`** e **`COPILOT_HOME`** alteram os homes CLI.
+- **Multi-agente:** `oxe-cc --all-agents` (menu **6**) replica fluxos para **OpenCode**, **Gemini CLI** (`/commands reload`), **Codex**, **Windsurf**, **Antigravity**, além de Cursor/Copilot/Claude. **`XDG_CONFIG_HOME`** / **`CODEX_HOME`** afetam caminhos canónicos desses destinos. O núcleo no repo continua **`.oxe/`** (SPEC/PLAN/VERIFY em Markdown).
+
+## Configuração do projeto
+
+- **`.oxe/config.json`**: fluxo (`discuss_before_plan`, `scan_max_age_days`, `compact_max_age_days`, `spec_required_sections`, …) e opcionalmente **`install`** (perfil e layout quando o utilizador corre o instalador **sem** flags IDE explícitas). Referência: `.oxe/templates/CONFIG.md`. Para ignorar o bloco `install` numa corrida: **`--no-install-config`**.
+- **Legado / brownfield** (COBOL, JCL, copybooks, VB6, SQL procedures): seguir também `.oxe/workflows/references/legacy-brownfield.md` quando o repo ou o pedido indicar mainframe ou desktop legado — scan preenche os sete ficheiros sem assumir Node; plan/verify aceitam evidência por Grep/leitura/checklist.
+- Sem TTY (CI): **`OXE_NO_PROMPT=1`** — padrões de layout/integração; o ficheiro `install` em `config.json` aplica-se se existir e as flags não sobrepuserem.
+
+## Artefatos
+
+- `.oxe/STATE.md`, `.oxe/config.json` (opcional), `.oxe/codebase/*.md`, `.oxe/SPEC.md`, `.oxe/DISCUSS.md` (opcional), `.oxe/PLAN.md`, `.oxe/plan-agents.json` (opcional, blueprint plan-agent; schema 2 com `runId` + `lifecycle`; **`/oxe-quick`** invalida), `.oxe/plan-agent-messages/` (opcional, handoffs agente→agente; ver `.oxe/workflows/references/plan-agent-chat-protocol.md`), `.oxe/VERIFY.md`, `.oxe/QUICK.md`, `.oxe/SUMMARY.md` (opcional), `.oxe/NOTES.md`, `.oxe/RESUME.md`, `.oxe/CODEBASE-DELTA.md`, `.oxe/CHECKPOINTS.md`, `.oxe/checkpoints/*.md`, `.oxe/RESEARCH.md`, `.oxe/research/*.md`, `.oxe/VALIDATION-GAPS.md`, `.oxe/FORENSICS.md`, `.oxe/DEBUG.md`, `.oxe/UI-SPEC.md`, `.oxe/UI-REVIEW.md` (opcionais conforme trilha)
+- Templates: `.oxe/templates/` (ou `..oxe/templates/` em layout aninhado)
+
+## CLI e SDK
+
+- **`npx oxe-cc`** ou **`npx oxe-cc install`** — instalação (equivalentes).
+- **`npx oxe-cc doctor`** — validação completa (Node, workflows do pacote vs projeto, JSON, coerência STATE, regras SPEC/PLAN, **avisos** não bloqueantes sobre estrutura dos `.md` de workflow quando aplicável).
+- **`npx oxe-cc status`** — mais leve: coerência `.oxe/` + **um** próximo passo (não exige o mesmo rigor de workflows que o `doctor`). **`status --json`**: saída máquina-legível para CI (`nextStep`, `diagnostics`, `staleScan`, `staleCompact`, …). **`status --hints`**: lembretes de rotina (scan/compact antigos quando configurado); com **`--json --hints`** inclui o array **`hints`**.
+- **`npx oxe-cc init-oxe`**, **`uninstall`**, **`update`** — ver `oxe-cc --help` ou README do pacote.
+- **SDK (Node):** `require('oxe-cc')` expõe `runDoctorChecks`, `health`, `workflows`, `install`, `manifest`, `agents` — útil para CI (`lib/sdk/README.md`, `lib/sdk/index.d.ts`).
+
+**WSL:** usar Node **nativo do WSL**; o `oxe-cc` recusa Node do Windows dentro do WSL (caminhos incorretos).
+
+## Manutenção do pacote oxe-build
+
+Ao alterar comportamento OXE, edite primeiro **`.oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
+
+**Autoria de workflows:** guia em **`.oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`.oxe/workflows/workflow-authoring.md`** (ou `..oxe/workflows/` no projeto alvo).
+<!-- oxe-cc:install-end -->

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: b3f89121879267f9
 
 Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/ask.md`
+`.oxe/workflows/ask.md`
 
 Usa o texto adicional desta mensagem como pergunta e foco.

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: c2dbc0e05602cd19
 
 Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/capabilities.md`
+`.oxe/workflows/capabilities.md`
 
 Usa o texto adicional desta mensagem como ação sobre capabilities.

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 09b26a7ca32729b5
 
 Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/checkpoint.md`
+`.oxe/workflows/checkpoint.md`
 
 O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.

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

@@ -39,6 +39,6 @@ oxe_semantics_hash: 05c86e61cfc45177
 
 Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/compact.md`
+`.oxe/workflows/compact.md`
 
 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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 590801b870fcbb56
 
 Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/dashboard.md`
+`.oxe/workflows/dashboard.md`
 
 Usa o texto adicional desta mensagem como foco opcional.

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: ee0c492eabab1723
 
 Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/debug.md`
+`.oxe/workflows/debug.md`
 
 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

@@ -40,4 +40,4 @@ oxe_semantics_hash: fb75dc9cf2963e3c
 
 Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/discuss.md`
+`.oxe/workflows/discuss.md`

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: a33b293fc6a29a70
 
 Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/execute.md`
+`.oxe/workflows/execute.md`
 
-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).
+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).

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 6c54f2a6320ba0e1
 
 Executa o workflow **OXE forensics** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/forensics.md`
+`.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

@@ -39,4 +39,4 @@ oxe_semantics_hash: d6221b02bf643a34
 
 Executa o workflow **OXE help**. Lê e segue **integralmente**:
 
-`oxe/workflows/help.md` (na raiz do repositório em contexto)
+`.oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 00850336919d1c14
 
 Executa o workflow **OXE loop** no repositório atual. Lê e aplica **integralmente**:
 
-`oxe/workflows/loop.md`
+`.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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 1e1f50e7621c55dd
 
 Executa o workflow **OXE milestone** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/milestone.md`
+`.oxe/workflows/milestone.md`
 
 Usa o texto adicional desta mensagem como subcomando e contexto.

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

@@ -39,4 +39,4 @@ oxe_semantics_hash: 6c91889eba921d36
 
 Executa o workflow **OXE next**. Lê e aplica **integralmente**:
 
-`oxe/workflows/next.md` (na raiz do repositório em contexto)
+`.oxe/workflows/next.md` (na raiz do repositório em contexto)

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

@@ -40,6 +40,6 @@ oxe_semantics_hash: 6c653692c8498e71
 
 Executa o workflow **OXE obs** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
 
-`oxe/workflows/obs.md`
+`.oxe/workflows/obs.md`
 
 Usa o texto adicional desta mensagem como a observação a registrar.

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

@@ -38,6 +38,6 @@ oxe_semantics_hash: 0b2f34a325711ad6
 
 Executa o workflow **OXE plan-agent**. Lê e aplica **integralmente**:
 
-`oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
+`.oxe/workflows/plan-agent.md` (na raiz do repositório em contexto)
 
 Se o utilizador pedir replanejamento, trata como **`--replan`** conforme o workflow.