oxe-cc 0.3.5 → 0.3.7

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

@@ -0,0 +1,9 @@
+---
+description: "OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)"
+---
+
+Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
+
+`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

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+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-debug.md

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.

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

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como contexto do sintoma (falha de verify, doctor, estado incoerente).

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

@@ -1,13 +1,7 @@
 ---
-description: "Comando OXE"
+description: "OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)"
 ---
 
----
-name: oxe-help
-agent: agent
-description: OXE — Ajuda (Cursor, Copilot, artefatos)
----
-
-Executa o workflow **OXE help**. Lê e segue **integralmente**:
-
+Executa o workflow **OXE help**. Lê e segue **integralmente**:
+
 `oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -1,13 +1,7 @@
 ---
-description: "Comando OXE"
+description: "OXE — Próximo passo (lê STATE.md)"
 ---
 
----
-name: oxe-next
-agent: agent
-description: OXE — Próximo passo (lê STATE.md)
----
-
-Executa o workflow **OXE next**. Lê e aplica **integralmente**:
-
+Executa o workflow **OXE next**. Lê e aplica **integralmente**:
+
 `oxe/workflows/next.md` (na raiz do repositório em contexto)

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

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

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

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

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

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como âmbito (paths, perguntas, spike, mapa de sistema, engenharia reversa ou modernização).

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

@@ -1,16 +1,9 @@
 ---
-description: "Comando OXE"
+description: "OXE — Revisão de PR (link GitHub, branches ou SHAs)"
 ---
 
----
-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)
-
+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/.cursor/commands/oxe-route.md

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como intenção a classificar (tabela Router em `help.md`).

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

@@ -1,16 +1,9 @@
 ---
-description: "Comando OXE"
+description: "OXE — Scan do repositório (.oxe/codebase/)"
 ---
 
----
-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)
-
+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/.cursor/commands/oxe-spec.md

@@ -1,16 +1,9 @@
 ---
-description: "Comando OXE"
+description: "OXE — Cria ou atualiza .oxe/SPEC.md"
 ---
 
----
-name: oxe-spec
-agent: agent
-description: OXE — Cria ou atualiza .oxe/SPEC.md
-argument-hint: "[pedido ou contexto da feature]"
----
-
-Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
-
-`oxe/workflows/spec.md` (na raiz do repositório em contexto)
-
+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/.cursor/commands/oxe-ui-review.md

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.

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

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.

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

@@ -0,0 +1,9 @@
+---
+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`**.

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

@@ -0,0 +1,9 @@
+---
+description: "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`
+
+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

@@ -1,16 +1,9 @@
 ---
-description: "Comando OXE"
+description: "OXE — Valida implementação (.oxe/VERIFY.md)"
 ---
 
----
-name: oxe-verify
-agent: agent
-description: OXE — Valida implementação (.oxe/VERIFY.md)
-argument-hint: "[opcional: Tn]"
----
-
-Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
-
-`oxe/workflows/verify.md` (na raiz do repositório em contexto)
-
+Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
+
+`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/.github/copilot-instructions.md

@@ -1,6 +1,6 @@
-# OXE — fluxo spec-driven (Cursor + Copilot)
+# 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).
+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).
 
 ## Quando aplicar
 
@@ -14,17 +14,28 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 | 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` |
 
 **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:** há slash `/oxe-*` para scan…help em `~/.cursor/commands/`; **não** há comando slash dedicado a review-pr no Cursor — use linguagem natural + `oxe/workflows/review-pr.md` em contexto.
+**Cursor:** há slash `/oxe-*` para scan…help, **`/oxe-update`**, **`/oxe-forensics`**, **`/oxe-debug`**, **`/oxe-route`**, **`/oxe-research`**, **`/oxe-validate-gaps`**, **`/oxe-compact`**, **`/oxe-checkpoint`**, **`/oxe-ui-spec`**, **`/oxe-ui-review`** em `~/.cursor/commands/` (gerados a partir de `.github/prompts/` com `npm run sync:cursor` no pacote); **não** há comando slash dedicado a review-pr no Cursor — use linguagem natural + `oxe/workflows/review-pr.md` em contexto.
 
 ## Onde ficam as integrações (após `npx oxe-cc`)
 
@@ -35,19 +46,20 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 
 ## Configuração do projeto
 
-- **`.oxe/config.json`**: fluxo (`discuss_before_plan`, `scan_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`**.
+- **`.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/VERIFY.md`, `.oxe/QUICK.md`, `.oxe/SUMMARY.md` (opcional)
+- `.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`).
+- **`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`).
 
@@ -55,6 +67,6 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
 
 ## Manutenção do pacote oxe-build
 
-Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha comandos Cursor e prompts Copilot alinhados a essa pasta.
+Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`** e comandos Cursor gerados pelo sync alinhados a essa pasta (e as integrações multi-agente coerentes com `oxe-agent-install.cjs`).
 
 **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).

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

@@ -0,0 +1,12 @@
+---
+name: oxe-checkpoint
+agent: agent
+description: OXE — Checkpoint nomeado (.oxe/checkpoints/ + índice)
+argument-hint: "<slug> [nota breve]"
+---
+
+Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
+
+`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

@@ -0,0 +1,11 @@
+---
+name: oxe-compact
+mode: agent
+description: 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`
+
+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-debug.prompt.md

@@ -0,0 +1,12 @@
+---
+name: oxe-debug
+agent: agent
+description: OXE — Debug técnico durante execute (DEBUG.md, hipótese/evidência)
+argument-hint: "[Tn opcional, stack ou comando que falhou]"
+---
+
+Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
+
+`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-forensics.prompt.md

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

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

@@ -1,7 +1,7 @@
 ---
 name: oxe-help
 agent: agent
-description: OXE — Ajuda (Cursor, Copilot, artefatos)
+description: OXE — Ajuda (fluxo .oxe/, várias IDEs e CLIs, artefatos)
 ---
 
 Executa o workflow **OXE help**. Lê e segue **integralmente**:

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

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

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

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

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

@@ -0,0 +1,12 @@
+---
+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`).

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

@@ -0,0 +1,12 @@
+---
+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.

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

@@ -0,0 +1,12 @@
+---
+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.

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

@@ -0,0 +1,11 @@
+---
+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`**.

package/.github/prompts/oxe-validate-gaps.prompt.md

@@ -0,0 +1,12 @@
+---
+name: oxe-validate-gaps
+agent: agent
+description: OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
+argument-hint: "[opcional: foco Tn ou A*]"
+---
+
+Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
+
+`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/.github/workflows/ci.yml

@@ -1,18 +1,20 @@
-name: CI
-
-on:
-  push:
-    branches: [main, master]
-  pull_request:
-    branches: [main, master]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm test
-      - run: npm run scan:assets
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+      - run: npm ci
+      - run: npm test
+      - run: npm run scan:assets

package/AGENTS.md

@@ -1,13 +1,13 @@
-# OXE — agentes (GitHub Copilot / compatível)
+# OXE — agentes (multi-IDE / multi-CLI)
 
-Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`).
+Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`). O núcleo é agnóstico; o **`oxe-cc`** integra com **várias IDEs e CLIs** (Cursor e GitHub Copilot como caminho padrão conhecido, mais Claude, OpenCode, Gemini, Codex, Windsurf, Antigravity quando instalado com **`--all-agents`** ou flags granulares).
 
 - **npm:** o nome do pacote é **`oxe-cc`** (`npx oxe-cc@latest` quando estiver publicado; se `npm view oxe-cc` der 404, usar `npm link` a partir deste repo ou `node bin/oxe-cc.js`).
-- **Instruções do repositório:** [.github/copilot-instructions.md](.github/copilot-instructions.md) — aplicadas automaticamente no Copilot Chat quando o repo está em contexto.
-- **Workflows canónicos:** [oxe/workflows/](oxe/workflows/) — editar aqui primeiro; Cursor e Copilot apontam para estes ficheiros (inclui `quick.md`, `execute.md`).
+- **Workflows canónicos:** [oxe/workflows/](oxe/workflows/) — editar aqui primeiro; todas as integrações apontam para estes ficheiros (inclui `quick.md`, `execute.md`). Referência **legado / brownfield:** [oxe/workflows/references/legacy-brownfield.md](oxe/workflows/references/legacy-brownfield.md) (COBOL, JCL, copybooks, VB6, SP).
+- **Instruções do repositório:** [.github/copilot-instructions.md](.github/copilot-instructions.md) — aplicadas automaticamente no **GitHub Copilot Chat** quando o repo está em contexto (outras ferramentas usam os seus próprios homes após `oxe-cc install`).
 - **CLI:** `oxe-cc` instala assets e bootstrap (`.oxe/STATE.md`, `config.json`, `codebase/`); `oxe-cc doctor` valida workflows, JSON de config, coerência STATE vs artefatos e regras opcionais de SPEC/PLAN; `oxe-cc status` mostra coerência `.oxe/` e **um** próximo passo; `oxe-cc init-oxe` só inicializa `.oxe/`.
 - **SDK:** `require('oxe-cc')` expõe `runDoctorChecks`, `health`, `workflows`, `install`, `manifest`, `agents` — ver [lib/sdk/README.md](lib/sdk/README.md).
-- **Prompt files (Copilot / VS Code):** [.github/prompts/*.prompt.md](.github/prompts/) — invocar com `/` no chat (ex. `/oxe-scan`, `/oxe-review-pr` para diff tipo PR) após `chat.promptFiles` estar ativo.
+- **Prompt files (Copilot / VS Code):** [.github/prompts/*.prompt.md](.github/prompts/) — invocar com `/` no chat (ex. `/oxe-scan`, `/oxe-plan-agent`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-validate-gaps`, `/oxe-compact`, `/oxe-checkpoint`, `/oxe-ui-spec`, `/oxe-ui-review`, `/oxe-update`, `/oxe-review-pr` para diff tipo PR) após `chat.promptFiles` estar ativo. Cursor: `npm run sync:cursor` gera `.cursor/commands/` a partir destes prompts.
 - **Copilot CLI:** `oxe-cc --copilot-cli` → skills em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …); após instalar use **`/skills reload`**. Cópia extra em `~/.claude/commands/` para compatibilidade.
 - **Multi-agente:** `oxe-cc --all-agents` replica comandos/skills nos homes de **OpenCode**, **Gemini**, **Codex**, **Windsurf**, **Antigravity** (além de Cursor, Copilot, Claude); ver `README.md` e `bin/lib/oxe-agent-install.cjs`.