oxe-cc 0.3.0

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Discussão antes do plano (.oxe/DISCUSS.md)
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/discuss.md` na raiz do workspace. Usa o texto extra do utilizador como contexto ou respostas a perguntas pendentes.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Executar onda do PLAN ou passos do QUICK
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/execute.md` na raiz do workspace. Se o utilizador indicar uma onda ou tarefas (ex. “onda 2”, “T3”), usa esse foco.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Ajuda (Cursor, Copilot, fluxo e artefatos)
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/help.md`.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Indica o próximo passo (lê .oxe/STATE.md)
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/next.md`.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Gera .oxe/PLAN.md com tarefas e verificação por item
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/plan.md`. Se o utilizador pedir replanejamento, inclui `--replan` na intenção.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Modo rápido (.oxe/QUICK.md + STATE)
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/quick.md` na raiz do workspace. Usa qualquer texto extra do utilizador como objetivo e contexto.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Escaneia o repo e gera .oxe/codebase/ + STATE.md
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/scan.md` na raiz do workspace. Usa qualquer texto extra do utilizador como foco opcional de área (ex. `api`).

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Cria ou atualiza .oxe/SPEC.md a partir do pedido
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/spec.md`. Entrada: mensagem do utilizador e ficheiros anexados.

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

@@ -0,0 +1,5 @@
+---
+description: OXE — Valida contra SPEC/PLAN e grava .oxe/VERIFY.md
+---
+
+Lê e executa **integralmente** o workflow em `oxe/workflows/verify.md`. Se o utilizador indicar `Tn`, focar essa tarefa.

package/.cursor/rules/oxe-workflow.mdc

@@ -0,0 +1,15 @@
+---
+description: OXE — Cursor + Copilot; workflows em oxe/workflows/
+alwaysApply: true
+---
+
+# OXE neste repositório
+
+Alvos principais: **Cursor** (slash em `.cursor/commands/`) e **GitHub Copilot** (`.github/copilot-instructions.md` + `.github/prompts/*.prompt.md`).
+
+- **Fonte única dos passos:** `oxe/workflows/*.md` — ao mudar comportamento, edita primeiro aqui.
+- **Comandos Cursor** (`/oxe-scan`, `/oxe-discuss`, `/oxe-quick`, `/oxe-execute`, …): delegam na leitura e execução integral do workflow homónimo em `oxe/workflows/`.
+- **Artefatos no projeto alvo:** pasta `.oxe/` (STATE, codebase, SPEC, PLAN, VERIFY). Não misturar com `.planning/` do GSD sem decisão explícita.
+- Antes de alterações grandes, preferir ler `.oxe/STATE.md` no repo de trabalho.
+- Cada tarefa em `PLAN.md` deve manter o bloco **Verificar** (comando de teste ou checklist).
+- Opcional: `.oxe/config.json` (template em `oxe/templates/config.template.json`, doc em `oxe/templates/CONFIG.md`).

package/.github/copilot-instructions.md

@@ -0,0 +1,37 @@
+# OXE — fluxo spec-driven (Cursor + Copilot)
+
+Este repositório define o **OXE**: artefatos em `.oxe/` na raiz do projeto alvo e workflows em `oxe/workflows/*.md`.
+
+## Quando aplicar
+
+Se o utilizador mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o projeto”, “criar spec OXE”, “plano OXE com testes”, “verificar OXE”, trata como fluxo OXE e segue o ficheiro de workflow correspondente abaixo.
+
+## Workflows (fonte única)
+
+| Passo | Ficheiro | 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” |
+| 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” |
+| Next | `oxe/workflows/next.md` | “oxe next”, “próximo passo OXE” |
+| Help | `oxe/workflows/help.md` | “oxe help”, “como usar OXE” |
+
+**Regra:** lê o Markdown indicado e executa **todos** os passos e critérios de sucesso descritos nesse ficheiro. Não atalhes: cria ou atualiza os ficheiros em `.oxe/` conforme o workflow.
+
+## 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`
+- Templates: `oxe/templates/`
+
+## Cursor vs Copilot
+
+- **Cursor:** slash commands em `.cursor/commands/oxe-*.md` apontam para os mesmos workflows.
+- **Copilot:** prompt files em `.github/prompts/oxe-*.prompt.md`; cada um indica o workflow em `oxe/workflows/<passo>.md` na raiz do repo.
+
+## Manutenção deste pacote (oxe-build)
+
+Ao alterar comportamento OXE, edita primeiro `oxe/workflows/*.md`; mantém comandos Cursor e prompts Copilot alinhados com essa pasta.

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

@@ -0,0 +1,10 @@
+---
+name: oxe-discuss
+agent: agent
+description: OXE — Discussão antes do plano
+argument-hint: "[contexto ou respostas]"
+---
+
+Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/discuss.md`

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

@@ -0,0 +1,12 @@
+---
+name: oxe-execute
+agent: agent
+description: OXE — Executar onda do PLAN ou passos do QUICK
+argument-hint: "[opcional: onda N ou Tn]"
+---
+
+Executa o workflow **OXE execute** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/execute.md`
+
+Usa o texto adicional desta mensagem como foco (onda, tarefa Tn, ou confirmação de progresso).

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

@@ -0,0 +1,9 @@
+---
+name: oxe-help
+agent: agent
+description: OXE — Ajuda (Cursor, Copilot, artefatos)
+---
+
+Executa o workflow **OXE help**. Lê e segue **integralmente**:
+
+`oxe/workflows/help.md` (na raiz do repositório em contexto)

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

@@ -0,0 +1,9 @@
+---
+name: oxe-next
+agent: agent
+description: 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)

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

@@ -0,0 +1,12 @@
+---
+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)
+
+Se o utilizador pedir replanejamento, trata como `--replan` conforme o workflow.

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

@@ -0,0 +1,12 @@
+---
+name: oxe-quick
+agent: agent
+description: OXE — Modo rápido (.oxe/QUICK.md)
+argument-hint: "[objetivo em texto livre]"
+---
+
+Executa o workflow **OXE quick** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
+
+`oxe/workflows/quick.md`
+
+Usa o texto adicional desta mensagem como objetivo e contexto.

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

@@ -0,0 +1,12 @@
+---
+name: oxe-scan
+agent: agent
+description: OXE — Scan do repositório (.oxe/codebase/)
+argument-hint: "[área opcional, ex. api]"
+---
+
+Executa o workflow **OXE scan** no repositório atual. Lê e aplica **integralmente** o ficheiro:
+
+`oxe/workflows/scan.md` (na raiz do repositório em contexto)
+
+Usa o texto adicional desta mensagem como foco opcional de área (pastas/módulos).

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

@@ -0,0 +1,12 @@
+---
+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)
+
+Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.

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

@@ -0,0 +1,12 @@
+---
+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)
+
+Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.

package/.github/workflows/ci.yml

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

package/AGENTS.md

@@ -0,0 +1,11 @@
+# OXE — agentes (GitHub Copilot / compatível)
+
+Este repositório empacota o fluxo **OXE** (spec-driven, artefatos em `.oxe/`).
+
+- **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`).
+- **CLI:** `oxe-cc` instala assets e bootstrap (`.oxe/STATE.md`, `config.json`, `codebase/`); `oxe-cc doctor` valida workflows, JSON de config e mapa scan; `oxe-cc init-oxe` só inicializa `.oxe/`.
+- **Prompt files (Copilot / VS Code):** [.github/prompts/*.prompt.md](.github/prompts/) — invocar com `/` no chat (ex. `/oxe-scan`) após `chat.promptFiles` estar ativo.
+
+Quando o utilizador pedir uma etapa OXE por linguagem natural, segue o ficheiro `oxe/workflows/<passo>.md` correspondente sem atalhar passos.