oxe-cc 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
 
 ---
 
+## [1.7.0] — 2026-04-23
+
+### OXE-native Agent Catalog
+
+- adicionada a fonte canónica `oxe/agents/` com agentes especializados para plan, execute, verify, debug, research, codebase mapping, integração, validação e UI
+- o instalador multi-runtime agora distribui agentes OXE para Claude Code (`.claude/agents`) e Codex/Antigravity (`.agents/skills` / skills compatíveis), além dos comandos já existentes
+- uninstall e smoke matrix passaram a validar e remover os agentes gerados pelo OXE
+
+### Rational Execution Artifacts
+
+- templates de `PLAN`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK` e `SUMMARY` foram endurecidos com contratos goal-backward, write-set, símbolos, sequência mínima, rollback, fixtures e evidência
+- `/oxe-plan`, `/oxe-execute`, `/oxe-verify`, `/oxe-debug`, `/oxe-forensics`, `/oxe-ui-spec` e `/oxe-ui-review` agora referenciam explicitamente os agentes e gates racionais compatíveis com runtime enterprise
+
+### Public Surface Hygiene
+
+- `scan:assets` agora bloqueia referências públicas a namespaces, paths e nomes de origem legada
+- criado `docs/CONTENT-MIGRATION-AUDIT.md` como trilha interna de incorporação, sem exposição nas superfícies instaladas
+
 ## [1.6.0] — 2026-04-23
 
 ### Product Reconciliation

package/README.md

@@ -7,7 +7,7 @@
 [![npm](https://img.shields.io/npm/v/oxe-cc.svg?style=flat-square)](https://www.npmjs.com/package/oxe-cc)
 [![license](https://img.shields.io/npm/l/oxe-cc.svg?style=flat-square)](LICENSE)
 
-**Versão:** `1.6.0` · [package.json](package.json)
+**Versão:** `1.7.0` · [package.json](package.json)
 
 **Framework OXE — Orchestrated eXperience Engineering**
 
@@ -52,7 +52,7 @@ O OXE agora distingue cinco famílias de raciocínio:
 - `review` — findings primeiro, severidade, evidência e risco residual
 - `status` — leitura curta do estado, recomendação única e motivo
 
-Essas regras vivem no núcleo canónico em `oxe/workflows/references/reasoning-*.md`, sobem para os workflows em `oxe/workflows/` e são renderizadas para cada runtime em `.github/prompts/`, `.cursor/commands/`, `commands/oxe/`, `.codex/prompts/` e skills multiagente. Nesta linha, `oxe/workflows/**` e `workflow-runtime-contracts.json` voltam a ser o contrato obrigatório da release; superfícies geradas permanecem derivadas e sincronizadas.
+Essas regras vivem no núcleo canónico em `oxe/workflows/references/reasoning-*.md`, sobem para os workflows em `oxe/workflows/` e são renderizadas para cada runtime em `.github/prompts/`, `.cursor/commands/`, `commands/oxe/`, `.codex/prompts/` e skills multiagente. Agentes especializados vivem em `oxe/agents/` e são instalados como agentes/skills OXE-native quando o runtime suporta esse conceito. Nesta linha, `oxe/workflows/**`, `oxe/agents/**` e `workflow-runtime-contracts.json` são contratos obrigatórios da release; superfícies geradas permanecem derivadas e sincronizadas.
 
 ---
 
@@ -536,7 +536,9 @@ npx oxe-cc@latest
 
 </details>
 
-GitHub Copilot no VS Code é **workspace-first**: o OXE instala prompt files em `.github/prompts/*.prompt.md` e mescla instruções em `.github/copilot-instructions.md`. `~/.copilot/` fica reservado ao legado detectável e ao runtime do Copilot CLI.
+GitHub Copilot no VS Code é **workspace-first**: o OXE instala prompt files em `.github/prompts/*.prompt.md` e mescla instruções em `.github/copilot-instructions.md`. `~/.copilot/` fica reservado ao legado detectável e ao runtime do Copilot CLI.
+
+Claude Code recebe comandos em `.claude/commands` e agentes especializados em `.claude/agents`. Codex recebe prompts em `.codex/prompts` e skills OXE em `.agents/skills`, incluindo os agentes especializados derivados de `oxe/agents/`.
 
 <details>
 <summary><strong>Atualizar e desinstalar</strong></summary>

package/bin/lib/oxe-agent-install.cjs

@@ -34,10 +34,11 @@ function expandTilde(p) {
  *   opencodeCommandDirs: string[],
  *   geminiCommandsBase: string,
  *   windsurfWorkflowsDir: string,
- *   codexPromptsDir: string,
- *   codexAgentsSkillsRoot: string,
- *   antigravitySkillsRoot: string,
- * }} AgentInstallPaths
+ *   codexPromptsDir: string,
+ *   codexAgentsSkillsRoot: string,
+ *   antigravitySkillsRoot: string,
+ *   claudeAgentsDir: string,
+ * }} AgentInstallPaths
  */
 
 /**
@@ -56,21 +57,23 @@ function buildAgentInstallPaths(ideGlobal, projectRoot) {
       opencodeCommandDirs: [path.join(xdg, 'opencode', 'commands'), path.join(home, '.opencode', 'commands')],
       geminiCommandsBase: path.join(home, '.gemini', 'commands'),
       windsurfWorkflowsDir: path.join(home, '.codeium', 'windsurf', 'global_workflows'),
-      codexPromptsDir: path.join(codexHome, 'prompts'),
-      codexAgentsSkillsRoot: path.join(home, '.agents', 'skills'),
-      antigravitySkillsRoot: path.join(home, '.gemini', 'antigravity', 'skills'),
-    };
-  }
+      codexPromptsDir: path.join(codexHome, 'prompts'),
+      codexAgentsSkillsRoot: path.join(home, '.agents', 'skills'),
+      antigravitySkillsRoot: path.join(home, '.gemini', 'antigravity', 'skills'),
+      claudeAgentsDir: path.join(home, '.claude', 'agents'),
+    };
+  }
   return {
     ideGlobal: false,
     opencodeCommandDirs: [path.join(root, '.opencode', 'commands')],
     geminiCommandsBase: path.join(root, '.gemini', 'commands'),
     windsurfWorkflowsDir: path.join(root, '.windsurf', 'global_workflows'),
-    codexPromptsDir: path.join(root, '.codex', 'prompts'),
-    codexAgentsSkillsRoot: path.join(root, '.agents', 'skills'),
-    antigravitySkillsRoot: path.join(root, '.gemini', 'antigravity', 'skills'),
-  };
-}
+    codexPromptsDir: path.join(root, '.codex', 'prompts'),
+    codexAgentsSkillsRoot: path.join(root, '.agents', 'skills'),
+    antigravitySkillsRoot: path.join(root, '.gemini', 'antigravity', 'skills'),
+    claudeAgentsDir: path.join(root, '.claude', 'agents'),
+  };
+}
 
 /** @param {string} content */
 function adjustWorkflowPathsForNestedLayout(content) {
@@ -113,7 +116,7 @@ function parseCursorCommandFrontmatter(text) {
  * @param {string} body
  * @param {Record<string, string>} [metadata]
  */
-function buildAgentSkillMarkdown(skillName, description, body, metadata) {
+function buildAgentSkillMarkdown(skillName, description, body, metadata) {
   const desc = description.trim() || `Comando OXE — ${skillName}`;
   const meta = metadata ? runtimeSemantics.pickRuntimeMetadata(metadata) : {};
   const metaLines = Object.keys(meta).length
@@ -128,11 +131,91 @@ function buildAgentSkillMarkdown(skillName, description, body, metadata) {
     `---\n\n` +
     `${OXE_MANAGED_HTML}\n\n` +
     `${body}\n`
-  );
-}
-
-/**
- * @returns {string[]}
+  );
+}
+
+/** @param {string} name */
+function isOxeAgentMarkdownName(name) {
+  return name.startsWith('oxe-') && name.endsWith('.md');
+}
+
+/**
+ * @param {string} text
+ * @returns {{ name: string, description: string, body: string, frontmatter: Record<string, string> }}
+ */
+function parseCanonicalAgentMarkdown(text) {
+  const parsed = parseCursorCommandFrontmatter(text);
+  return {
+    name: parsed.frontmatter.name || '',
+    description: parsed.description || parsed.frontmatter.description || '',
+    body: parsed.body,
+    frontmatter: parsed.frontmatter,
+  };
+}
+
+/**
+ * Instala agentes especializados OXE como markdown nativo para runtimes que suportam agentes.
+ * @param {string} agentsSrc
+ * @param {string} destDir
+ * @param {{ dryRun: boolean, force: boolean }} opts
+ * @param {(s: string) => void} [logOmitido]
+ * @param {(s: string) => void} [logWrite]
+ */
+function installCanonicalAgentMarkdowns(agentsSrc, destDir, opts, logOmitido, logWrite) {
+  if (!fs.existsSync(agentsSrc)) return;
+  for (const name of fs.readdirSync(agentsSrc)) {
+    if (!isOxeAgentMarkdownName(name)) continue;
+    const src = path.join(agentsSrc, name);
+    const dest = path.join(destDir, name);
+    if (opts.dryRun) {
+      if (logWrite) logWrite(`${src} → ${dest}`);
+      continue;
+    }
+    if (fs.existsSync(dest) && !opts.force) {
+      if (logOmitido) logOmitido(dest);
+      continue;
+    }
+    const raw = fs.readFileSync(src, 'utf8');
+    const out = raw.includes(OXE_MANAGED_HTML) ? raw : raw.replace(/\n?$/, `\n\n${OXE_MANAGED_HTML}\n`);
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(dest, out, 'utf8');
+  }
+}
+
+/**
+ * Instala agentes especializados OXE como skills Codex/Antigravity.
+ * @param {string} agentsSrc
+ * @param {string} skillsRoot
+ * @param {{ dryRun: boolean, force: boolean }} opts
+ * @param {(s: string) => void} [logOmitido]
+ * @param {(s: string) => void} [logWrite]
+ */
+function installCanonicalAgentSkills(agentsSrc, skillsRoot, opts, logOmitido, logWrite) {
+  if (!fs.existsSync(agentsSrc)) return;
+  for (const name of fs.readdirSync(agentsSrc)) {
+    if (!isOxeAgentMarkdownName(name)) continue;
+    const src = path.join(agentsSrc, name);
+    const raw = fs.readFileSync(src, 'utf8');
+    const parsed = parseCanonicalAgentMarkdown(raw);
+    const skillName = parsed.name || name.replace(/\.md$/i, '');
+    const md = buildAgentSkillMarkdown(skillName, parsed.description, parsed.body, parsed.frontmatter);
+    const destDir = path.join(skillsRoot, skillName);
+    const dest = path.join(destDir, 'SKILL.md');
+    if (opts.dryRun) {
+      if (logWrite) logWrite(`${src} → ${dest}`);
+      continue;
+    }
+    if (fs.existsSync(dest) && !opts.force) {
+      if (logOmitido) logOmitido(dest);
+      continue;
+    }
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(dest, md, 'utf8');
+  }
+}
+
+/**
+ * @returns {string[]}
  */
 function opencodeCommandDirs() {
   return buildAgentInstallPaths(true, process.cwd()).opencodeCommandDirs;
@@ -499,6 +582,21 @@ function cleanupMarkedUnifiedArtifacts(u, paths) {
     }
   }
 
+  if (shouldClean('claude')) {
+    const clAgents = p.claudeAgentsDir;
+    if (fs.existsSync(clAgents)) {
+      for (const name of fs.readdirSync(clAgents)) {
+        if (!isOxeAgentMarkdownName(name)) continue;
+        const filePath = path.join(clAgents, name);
+        try {
+          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+  }
+
   if (shouldClean('antigravity')) {
     const agRoot = p.antigravitySkillsRoot;
     if (fs.existsSync(agRoot)) {
@@ -531,15 +629,18 @@ module.exports = {
   buildAgentSkillMarkdown,
   installSkillTreeFromCursorCommands,
   installOpenCodeCommands,
-  installGeminiTomlCommands,
-  installWindsurfGlobalWorkflows,
-  installCodexPrompts,
-  opencodeCommandDirs,
+  installGeminiTomlCommands,
+  installWindsurfGlobalWorkflows,
+  installCodexPrompts,
+  installCanonicalAgentMarkdowns,
+  installCanonicalAgentSkills,
+  opencodeCommandDirs,
   windsurfGlobalWorkflowsDir,
   geminiUserDir,
   codexAgentsSkillsRoot,
   codexPromptsDir,
   antigravitySkillsRoot,
   isOxeCommandMarkdownName,
+  isOxeAgentMarkdownName,
   cleanupMarkedUnifiedArtifacts,
 };

package/bin/lib/oxe-release.cjs

@@ -271,6 +271,7 @@ function loadRuntimeSmokeReport(projectRoot) {
       && item.workflow_resolution_ok
       && item.wrapper_drift_ok !== false
       && item.extra_checks_ok !== false
+      && item.agent_checks_ok !== false
       && item.uninstall_ok
     );
   });

package/bin/oxe-cc.js

@@ -2730,10 +2730,14 @@ function runInstall(opts) {
     copyDir(path.join(PKG_ROOT, 'oxe', 'templates'), path.join(nested, 'templates'), copyOpts, true);
     // Personas: copiar para .oxe/personas/ (não sobrescreve personalizações do projeto)
     const personasSrc = path.join(PKG_ROOT, 'oxe', 'personas');
-    if (fs.existsSync(personasSrc)) {
-      copyDir(personasSrc, path.join(nested, 'personas'), copyOpts, false);
-    }
-    // Schemas: copiar para .oxe/schemas/ (ex.: plan-agents.schema.json para validação local)
+    if (fs.existsSync(personasSrc)) {
+      copyDir(personasSrc, path.join(nested, 'personas'), copyOpts, false);
+    }
+    const agentsSrc = path.join(PKG_ROOT, 'oxe', 'agents');
+    if (fs.existsSync(agentsSrc)) {
+      copyDir(agentsSrc, path.join(nested, 'agents'), copyOpts, false);
+    }
+    // Schemas: copiar para .oxe/schemas/ (ex.: plan-agents.schema.json para validação local)
     const schemasSrc = path.join(PKG_ROOT, 'oxe', 'schemas');
     if (fs.existsSync(schemasSrc)) {
       copyDir(schemasSrc, path.join(nested, 'schemas'), copyOpts, false);
@@ -2748,10 +2752,11 @@ function runInstall(opts) {
     if (fs.existsSync(cRules)) copyDir(cRules, path.join(cursorBase, 'rules'), copyOpts, idePathRewrite);
   }
 
-  const doAgentClis = opts.copilotCli || opts.allAgents;
-  if (doAgentClis) {
-    const cCmd = path.join(PKG_ROOT, '.cursor', 'commands');
-    const clBase = installClaudeBase(opts);
+  const doAgentClis = opts.copilotCli || opts.allAgents;
+  if (doAgentClis) {
+    const cCmd = path.join(PKG_ROOT, '.cursor', 'commands');
+    const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
+    const clBase = installClaudeBase(opts);
     const cpHome = installCopilotCliHome(opts);
     const clDest = path.join(clBase, 'commands');
     const cpCmdDest = path.join(cpHome, 'commands');
@@ -2760,16 +2765,24 @@ function runInstall(opts) {
       console.log(
         `  ${c ? green : ''}cli${c ? reset : ''}   ${c ? dim : ''}Claude/Copilot: skills em${c ? reset : ''} ${c ? cyan : ''}${cpSkills}${c ? reset : ''} ${c ? dim : ''}(/oxe, /oxe-scan, …); comandos .md:${c ? reset : ''} ${c ? cyan : ''}${clDest}${c ? reset : ''} ${c ? dim : ''}+${c ? reset : ''} ${c ? cyan : ''}${cpCmdDest}${c ? reset : ''}`
       );
-      installOxeCopilotCliSkills(cCmd, cpHome, copyOpts, idePathRewrite);
-      copyDir(cCmd, clDest, copyOpts, idePathRewrite);
-      copyDir(cCmd, cpCmdDest, copyOpts, idePathRewrite);
-    } else {
+      installOxeCopilotCliSkills(cCmd, cpHome, copyOpts, idePathRewrite);
+      copyDir(cCmd, clDest, copyOpts, idePathRewrite);
+      copyDir(cCmd, cpCmdDest, copyOpts, idePathRewrite);
+      if (fs.existsSync(canonicalAgents)) {
+        oxeAgentInstall.installCanonicalAgentMarkdowns(
+          canonicalAgents,
+          agentPaths.claudeAgentsDir,
+          copyOpts
+        );
+      }
+    } else {
       console.warn(`${yellow}aviso:${reset} pasta ausente ${cCmd} — ignorando comandos CLI`);
     }
   }
 
-  const cCmdAgents = path.join(PKG_ROOT, '.cursor', 'commands');
-  if (fs.existsSync(cCmdAgents) && (opts.allAgents || anyGranularAgent(opts))) {
+  const cCmdAgents = path.join(PKG_ROOT, '.cursor', 'commands');
+  const canonicalAgents = path.join(PKG_ROOT, 'oxe', 'agents');
+  if (fs.existsSync(cCmdAgents) && (opts.allAgents || anyGranularAgent(opts))) {
     const logO = (d) => console.log(`${dim}omitido${reset} ${d} (já existe — use --force)`);
     const logW = (msg) => console.log(`${dim}agents${reset}  ${msg}`);
     console.log(
@@ -2787,27 +2800,41 @@ function runInstall(opts) {
     if (opts.agentCodex || opts.allAgents) {
       oxeAgentInstall.installCodexPrompts(cCmdAgents, agentPaths, copyOpts, idePathRewrite, logO, logW);
     }
-    if (opts.agentAntigravity || opts.allAgents) {
-      oxeAgentInstall.installSkillTreeFromCursorCommands(
+    if (opts.agentAntigravity || opts.allAgents) {
+      oxeAgentInstall.installSkillTreeFromCursorCommands(
         cCmdAgents,
         agentPaths.antigravitySkillsRoot,
         copyOpts,
         idePathRewrite,
         logO,
-        logW
-      );
-    }
-    if (opts.agentCodex || opts.allAgents) {
-      oxeAgentInstall.installSkillTreeFromCursorCommands(
+        logW
+      );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.antigravitySkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
+    }
+    if (opts.agentCodex || opts.allAgents) {
+      oxeAgentInstall.installSkillTreeFromCursorCommands(
         cCmdAgents,
         agentPaths.codexAgentsSkillsRoot,
         copyOpts,
         idePathRewrite,
         logO,
-        logW
-      );
-    }
-  }
+        logW
+      );
+      oxeAgentInstall.installCanonicalAgentSkills(
+        canonicalAgents,
+        agentPaths.codexAgentsSkillsRoot,
+        copyOpts,
+        logO,
+        logW
+      );
+    }
+  }
 
   if (opts.copilot) {
     const gh = path.join(PKG_ROOT, '.github');
@@ -2897,10 +2924,11 @@ function runInstall(opts) {
       addTracked(copilotPromptsDirPath(opts), (n) => n.startsWith('oxe-'));
       trackFile(copilotWorkspaceManifestPath(opts));
     }
-    trackFile(runtimeSemanticsManifestPath(opts));
-    if (opts.copilotCli || opts.allAgents) {
-      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
-      addTracked(path.join(cpCliHome, 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+    trackFile(runtimeSemanticsManifestPath(opts));
+    if (opts.copilotCli || opts.allAgents) {
+      addTracked(path.join(installClaudeBase(opts), 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
+      addTracked(agentPaths.claudeAgentsDir, (n) => oxeAgentInstall.isOxeAgentMarkdownName(n));
+      addTracked(path.join(cpCliHome, 'commands'), (n) => oxeAgentInstall.isOxeCommandMarkdownName(n));
       const skRoot = path.join(cpCliHome, 'skills');
       if (fs.existsSync(skRoot)) {
         for (const sub of fs.readdirSync(skRoot, { withFileTypes: true })) {
@@ -3036,8 +3064,8 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
     track(manifest);
   }
 
-  if (u.copilotCli || u.allAgents) {
-    for (const base of [path.join(proj, '.claude'), path.join(proj, '.copilot')]) {
+  if (u.copilotCli || u.allAgents) {
+    for (const base of [path.join(proj, '.claude'), path.join(proj, '.copilot')]) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
@@ -3046,9 +3074,19 @@ function uninstallLocalIdeFromProject(u, removedPaths) {
           unlinkQuiet(p, u);
           track(p);
         }
-      }
-    }
-    const skillsRoot = path.join(proj, '.copilot', 'skills');
+      }
+    }
+    const claudeAgentsDir = path.join(proj, '.claude', 'agents');
+    if (fs.existsSync(claudeAgentsDir)) {
+      for (const name of fs.readdirSync(claudeAgentsDir)) {
+        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
+          const p = path.join(claudeAgentsDir, name);
+          unlinkQuiet(p, u);
+          track(p);
+        }
+      }
+    }
+    const skillsRoot = path.join(proj, '.copilot', 'skills');
     if (fs.existsSync(skillsRoot)) {
       for (const ent of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
         if (!ent.isDirectory() || !/^oxe($|-)/.test(ent.name)) continue;
@@ -3371,8 +3409,8 @@ function runUninstall(u) {
     cleanupLegacyCopilotVsCode(ideOpts, u, removedPaths);
   }
 
-  if (u.copilotCli) {
-    for (const base of [claudeUserDir(ideOpts), copilotUserDir(ideOpts)]) {
+  if (u.copilotCli) {
+    for (const base of [claudeUserDir(ideOpts), copilotUserDir(ideOpts)]) {
       const cmdDir = path.join(base, 'commands');
       if (!fs.existsSync(cmdDir)) continue;
       for (const name of fs.readdirSync(cmdDir)) {
@@ -3381,9 +3419,19 @@ function runUninstall(u) {
           unlinkQuiet(p, u);
           removedPaths.push(p);
         }
-      }
-    }
-    const skillsRoot = path.join(copilotUserDir(ideOpts), 'skills');
+      }
+    }
+    const claudeAgentsDir = path.join(claudeUserDir(ideOpts), 'agents');
+    if (fs.existsSync(claudeAgentsDir)) {
+      for (const name of fs.readdirSync(claudeAgentsDir)) {
+        if (oxeAgentInstall.isOxeAgentMarkdownName(name)) {
+          const p = path.join(claudeAgentsDir, name);
+          unlinkQuiet(p, u);
+          removedPaths.push(p);
+        }
+      }
+    }
+    const skillsRoot = path.join(copilotUserDir(ideOpts), 'skills');
     if (fs.existsSync(skillsRoot)) {
       for (const ent of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
         if (!ent.isDirectory() || !/^oxe($|-)/.test(ent.name)) continue;

package/commands/oxe/debug.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:debug
-description: "[DEPRECATED v1.1.0] Incorporado por /oxe-execute. Use: /oxe-execute --debug"
+description: >
+  Diagnóstica falhas com metodologia RCA: hipóteses explícitas → evidência → reprodução controlada
+  → causa raiz → hotfix mínimo. Não corrige sintomas — rasteia até a causa raiz antes de propor
+  qualquer mudança. Documenta o diagnóstico completo em DEBUG.md (sintoma, hipóteses testadas,
+  root cause, hotfix aplicado, evidência de resolução). Após o hotfix, orienta execução de
+  /oxe-verify para confirmar que os critérios A* afetados ainda passam.
 argument-hint: "[Tn ou erro/stack]"
 allowed-tools:
   - Read

package/commands/oxe/discuss.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:discuss
-description: Perguntas objetivas antes do plano — .oxe/DISCUSS.md
-argument-hint: "[contexto ou respostas]"
+description: >
+  Conduz sessão estruturada de resolução de decisões técnicas antes do planejamento. Identifica
+  trade-offs relevantes, apresenta alternativas com critérios objetivos, registra a decisão
+  escolhida com motivo e impacto em DISCUSS.md como D-NN. Cada D-NN fechado aqui é vinculado a
+  tarefas Tn no PLAN.md e verificado pelo Verificador após execução. Usar quando: `discuss_before_plan`
+  está ativo no config, há decisão arquitetural aberta, ou o Arquiteto sinalizou bloqueio.
+argument-hint: "[decisão a tomar | contexto do trade-off | D-NN a reabrir]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/execute.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:execute
-description: "Executar plano A/B/C. Flags: --note (obs), --debug, --deep-diagnosis, --checkpoint '<nome>', --iterative"
-argument-hint: "[A|B|C | --note 'texto' | --debug | --deep-diagnosis | --checkpoint '<nome>' | --iterative]"
+description: >
+  Executa as tarefas do PLAN.md onda por onda, com write set mínimo e verificação obrigatória
+  antes de avançar. Compila o grafo de execução via LlmTaskExecutor, respeita dependências entre
+  tarefas, particiona tools idempotentes (paralelas) e mutáveis (seriais), e registra evidência
+  auditável por Tn. Modo --debug ativa diagnóstico de falha inline. --checkpoint '<nome>' cria
+  ponto de restauração antes de ondas de alto risco.
+argument-hint: "[onda|Tn | --debug | --deep-diagnosis | --checkpoint '<nome>' | --note 'texto' | --iterative]"
 allowed-tools:
   - Read
   - Bash

package/commands/oxe/plan-agent.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:plan-agent
-description: Gera PLAN.md e plan-agents.json (blueprint de agentes e ondas)
-argument-hint: "[--replan se já existe PLAN.md]"
+description: >
+  Gera PLAN.md e plan-agents.json — blueprint de execução multi-agente com ondas paralelas.
+  Cada agente recebe persona (executor, db-specialist, ui-specialist, etc.), escopo de tarefas,
+  dependências entre agentes e lifecycle state rastreável. Ideal para planos com 3+ domínios
+  distintos (backend, frontend, banco) onde paralelismo real de agentes é possível. --replan
+  regenera o runId, preserva tarefas concluídas e alinha STATE.md.
+argument-hint: "[--replan | <contexto adicional de domínios>]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/plan.md

@@ -1,7 +1,12 @@
 ---
 name: oxe:plan
-description: Gera PLAN.md a partir da SPEC com tarefas atômicas e verificação por item
-argument-hint: "[--replan se já existe PLAN.md]"
+description: >
+  Decompõe os critérios A* da SPEC em tarefas GraphNode com mutation_scope explícito, action_type
+  correto e verify command determinístico. Projeta ondas que maximizam paralelismo respeitando
+  dependências e mutation_scope disjunto. Aplica rubrica de confiança em 6 dimensões e quality gate
+  de 19 itens. Gera IMPLEMENTATION-PACK, REFERENCE-ANCHORS e FIXTURE-PACK junto com o PLAN.md.
+  --replan preserva histórico e atualiza tarefas sem apagar o trabalho anterior.
+argument-hint: "[--replan | --agents (gera blueprint de agentes junto)]"
 allowed-tools:
   - Read
   - Write

package/commands/oxe/scan.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:scan
-description: "[DEPRECATED v1.1.0] Incorporado por /oxe-spec. Use: /oxe-spec --refresh (incremental) ou /oxe-spec --full (completo)"
+description: >
+  Analisa o codebase e produz os sete documentos em .oxe/codebase/ (OVERVIEW, STACK, STRUCTURE,
+  TESTING, INTEGRATIONS, CONVENTIONS, CONCERNS). Detecta padrão arquitetural dominante, domínios
+  funcionais e sugere profile scale-adaptive. Modo bootstrap (do zero) ou refresh (incremental).
+  Cada documento passa por gate de qualidade com critérios e anti-padrões por tipo. O mapa
+  resultante alimenta spec, plan e o contexto do LlmTaskExecutor.
 argument-hint: "[área opcional, ex. auth, api]"
 allowed-tools:
   - Read

package/commands/oxe/spec.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:spec
-description: "Spec em 5 fases. Flags: --refresh (scan incremental), --full (scan completo), --research (spike), --ui (gera UI-SPEC)"
+description: >
+  Conduz as 5 fases do processo de especificação: perguntas (blocos coesos por domínio), pesquisa
+  (investigação de incertezas técnicas), requisitos (tabela R-ID com v1/v2/fora e critérios A*
+  verificáveis), elevação de robustez (checklist de segurança por domínio AUTH/API/DB/FRONTEND/FILE),
+  e aprovação com roteiro ROADMAP.md. Flags: --refresh (atualiza codebase/ antes), --full (scan
+  completo), --research (Fase 2 explícita), --ui (gera UI-SPEC.md ao final).
 argument-hint: "[descrição da feature | --refresh | --full | --research | --ui]"
 allowed-tools:
   - Read

package/commands/oxe/verify.md

@@ -1,6 +1,11 @@
 ---
 name: oxe:verify
-description: "Valida e fecha o ciclo (retro automática). Flags: --gaps, --security, --ui, --pr, --diff, --skip-retro"
+description: >
+  Audita a implementação em quatro camadas: pré-execução (ambiente e commits), por tarefa Tn
+  (verify command de cada task), por critério A* (cobertura completa da SPEC), e fidelidade de
+  decisões D-NN. Produz VERIFY.md com evidência observável por critério, classifica findings por
+  severidade, gera checklist UAT para validação humana, e fecha o ciclo com retro automática.
+  --security adiciona auditoria de segurança baseline. --gaps foca em A* sem cobertura.
 argument-hint: "[Tn | --gaps | --security | --ui | --pr | --diff branchA...branchB | --skip-retro]"
 allowed-tools:
   - Read

package/docs/CONTENT-MIGRATION-AUDIT.md

@@ -0,0 +1,49 @@
+# Content Migration Audit
+
+Este documento registra a triagem interna de conteúdo usado como insumo para fortalecer o OXE. Ele não é instalado em projetos de usuário e não deve ser referenciado por templates, workflows, comandos, README ou agentes finais.
+
+## Rules
+
+- Public artifacts must use OXE naming, paths, commands and runtime contracts only.
+- No public template/workflow/command/agent may reference legacy product names, paths, tool commands or command namespaces.
+- Source material is reauthored, not copied literally.
+
+## Templates
+
+| Source theme | Decision | OXE target |
+|--------------|----------|------------|
+| Detailed phase plan contract | merge | `PLAN.template.md`, `IMPLEMENTATION-PACK.*`, `/oxe-plan` |
+| Context and discovery templates | merge | context packs, `RESEARCH.template.md`, `INVESTIGATION.template.md`, `REFERENCE-ANCHORS.template.md` |
+| Requirements, project, roadmap, state | merge | `SPEC.template.md`, `ROADMAP.template.md`, `STATE.md` |
+| Validation, verification and UAT | merge | `/oxe-verify`, runtime evidence, `VERIFY.md` projection |
+| UI contract | merge | `/oxe-spec --ui`, `/oxe-ui-spec`, `/oxe-ui-review` |
+| Debug templates | merge | `/oxe-debug`, `/oxe-forensics`, `oxe-debugger` |
+| Session summaries and setup | merge | `SUMMARY.template.md`, `RESUME.template.md`, checkpoints |
+| Runtime-specific instruction files | inspiration_only | OXE multi-runtime generators |
+| Developer profile/preferences | reject | future consented profile feature only |
+
+## Workflows
+
+| Source theme | Decision | OXE target |
+|--------------|----------|------------|
+| New project and milestone discovery | merge | `/oxe-spec`, `/oxe-plan` |
+| Phase planning and review loop | merge | `/oxe-plan`, rationality gate |
+| Plan execution by wave/task | merge | `/oxe-execute` |
+| Verification, validation gaps and UAT | merge | `/oxe-verify` |
+| Codebase mapping and research | merge | `/oxe-scan`, `/oxe-spec --research` |
+| Debug and incident diagnosis | merge | `/oxe-debug`, `/oxe-forensics` |
+| UI design and review | merge | `/oxe-spec --ui`, `/oxe-ui-review` |
+| Progress, next, pause and resume | merge | `/oxe`, `/oxe-next`, `/oxe-session` |
+| Workstreams and isolated workspace concepts | merge | `/oxe-workstream`, runtime agents |
+| Autonomous workflow | reject | OXE keeps governed execution |
+| PR branch/ship workflow | inspiration_only | OXE keeps local commit and separate `runtime promote` |
+| Community/settings/update flows | reject | OXE already has administrative UX |
+
+## Commands
+
+Legacy command wrappers are not copied. They are used only as intent inventory and mapped into canonical OXE workflows before generated surfaces are regenerated.
+
+## Agents
+
+Specialized agents were reauthored as OXE-native contracts in `oxe/agents/`. They use `.oxe/`, OXE workflows, runtime enterprise, evidence store, personas and `plan-agents.json` only.
+

package/docs/RUNTIME-SMOKE-MATRIX.md

@@ -1,6 +1,6 @@
 # OXE — Runtime Smoke Matrix
 
-> Estado de suporte por runtime de IA. Atualizado em v1.6.0.
+> Estado de suporte por runtime de IA. Atualizado em v1.7.0.
 >
 > `✓` = suportado e testado | `~` = suportado parcialmente | `✗` = não suportado | `?` = não testado