sinapse-ai 1.8.0 → 1.9.1

package/scripts/prepare-hooks.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+'use strict';
+
+/*
+ * prepare-hooks — runs on `npm install` (the `prepare` lifecycle script).
+ *
+ * Why this exists: husky's own setup points git `core.hooksPath` at `.husky/_`.
+ * E8 ("trava de git real e ativa") makes `.sinapse-ai/git-hooks` the canonical,
+ * managed hook entrypoint — its pre-commit runs the SINAPSE guards (secret scan,
+ * SQL guard, framework boundary) FIRST and then chains back to `.husky/pre-commit`,
+ * so husky's guards still run. Without re-pointing here, every `npm install`
+ * silently reverts the managed trava back to husky and the dogfooding parity test
+ * (codex-parity-behavioral-smoke) goes red.
+ *
+ * Fully guarded: a missing husky, missing git, or absent managed dir never breaks
+ * `npm install`.
+ */
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const onWindows = process.platform === 'win32';
+
+// husky is an npm-bin shim, so on Windows it must go through the shell to resolve
+// `node_modules/.bin/husky.cmd`. It takes no args, so shell:true carries no
+// injection risk here.
+function runShell(cmd) {
+  try {
+    return spawnSync(cmd, [], { stdio: 'inherit', shell: onWindows }).status === 0;
+  } catch {
+    return false;
+  }
+}
+
+// git is a real binary spawnable directly — no shell, so args are never
+// concatenated into a command string (avoids DEP0190 and any injection surface).
+function runDirect(cmd, args) {
+  try {
+    return spawnSync(cmd, args, { stdio: 'inherit' }).status === 0;
+  } catch {
+    return false;
+  }
+}
+
+// 1. Let husky materialize `.husky/_` (this also sets core.hooksPath=.husky/_).
+runShell('husky');
+
+// 2. Re-point core.hooksPath at the SINAPSE-managed dir, but only when we are in a
+//    real git work tree and the managed hooks are actually present.
+const projectRoot = process.cwd();
+const managedDir = '.sinapse-ai/git-hooks';
+const inGitWorkTree = fs.existsSync(path.join(projectRoot, '.git'));
+const managedReady = fs.existsSync(path.join(projectRoot, managedDir, 'pre-commit'));
+
+if (inGitWorkTree && managedReady) {
+  runDirect('git', ['config', 'core.hooksPath', managedDir]);
+}

package/scripts/regenerate-orqx-stubs.ps1

@@ -1,5 +1,6 @@
 # regenerate-orqx-stubs.ps1
-# Regenera os 22 stubs de orchestrators em ~/.claude/agents/*-orqx.md
+# Regenera os stubs de orchestrators em ~/.claude/agents/*-orqx.md
+# Ecossistema pos-fusao: 17 squads / 172 agentes / 1.200 tasks (squad-artdir fundido em squad-design)
 # Formato completo (39 linhas) com fix HALT → briefing-auto-orchestration
 
 $ErrorActionPreference = 'Stop'
@@ -7,9 +8,7 @@ $ErrorActionPreference = 'Stop'
 # Mapeamento orqx → squad (canonical em ~/.sinapse/{squad}/agents/{id}.md)
 $mapping = @(
     @{ id = 'animations-orqx'; squad = 'squad-animations' }
-    @{ id = 'artdir-orqx'; squad = 'squad-artdir' }
     @{ id = 'brand-orqx'; squad = 'squad-brand' }
-    @{ id = 'claude-orqx'; squad = 'squad-claude' }
     @{ id = 'cloning-orqx'; squad = 'squad-cloning' }
     @{ id = 'commercial-orqx'; squad = 'squad-commercial' }
     @{ id = 'content-orqx'; squad = 'squad-content' }

package/scripts/sync-counts.js

@@ -28,6 +28,11 @@ function countMatching(dir, predicate) {
   let count = 0;
   for (const entry of entries) {
     const full = path.join(dir, entry.name);
+    // Never count anything under a _deprecated/ folder — those entities are
+    // retired (e.g. squads/claude-code-mastery/_deprecated/claude-orqx.md).
+    if (entry.name === '_deprecated' || full.includes(`${path.sep}_deprecated${path.sep}`)) {
+      continue;
+    }
     if (entry.isDirectory()) {
       count += countMatching(full, predicate);
     } else if (predicate(full, entry.name)) {
@@ -52,8 +57,11 @@ function isTaskFile(fullPath, filename) {
   return fullPath.includes(`${path.sep}tasks${path.sep}`);
 }
 
-function isOrqxFile(_fullPath, filename) {
-  return filename.endsWith('-orqx.md');
+function isOrqxFile(fullPath, filename) {
+  // Only count orqx personas that live under a squad's agents/ directory.
+  // Guards against stray/retired orqx files outside the canonical location.
+  if (!filename.endsWith('-orqx.md')) return false;
+  return fullPath.includes(`${path.sep}agents${path.sep}`);
 }
 
 function countSquadDirs() {

package/scripts/sync-squad-yaml-components.js

@@ -15,9 +15,18 @@
  * `components.agents` block based on disk reality, restoring manifest
  * as a reliable source of truth.
  *
+ * --check mode (E8 / auditoria-pos-190):
+ * Beyond detecting a MISSING block, --check now RECONCILES the declared
+ * agents list against the actual `.md` files on disk. It fails (exit 1) when:
+ *   - a squad.yaml is missing the components.agents block (needs-update), OR
+ *   - the declared list diverges from disk (drift): a declared agent has no
+ *     file, or an agent file is not declared.
+ * Inline `# comments` after a filename are stripped before comparison, so a
+ * `- foo.md  # Persona — Role` entry reconciles cleanly against `foo.md`.
+ *
  * Usage:
  *   node scripts/sync-squad-yaml-components.js              # apply changes
- *   node scripts/sync-squad-yaml-components.js --check      # report only, no write
+ *   node scripts/sync-squad-yaml-components.js --check      # report + reconcile, no write
  */
 
 'use strict';
@@ -64,6 +73,61 @@ function hasComponentsAgents(yamlContent) {
   return false;
 }
 
+// parseDeclaredAgents extracts the filenames declared under components.agents.
+// It tolerates inline `# comments` after each filename (several squad.yaml files
+// annotate entries like `- brand-auditor.md  # Sentinel — Guardian`). Returns a
+// sorted array of bare filenames, or null if no components.agents block exists.
+function parseDeclaredAgents(yamlContent) {
+  const lines = yamlContent.split('\n');
+  let inAgents = false;
+  let found = false;
+  const agents = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!inAgents) {
+      if (/^components:\s*$/.test(line)) {
+        // scan forward for the agents: sub-key (block style)
+        for (let j = i + 1; j < lines.length; j++) {
+          if (/^ {2}agents:/.test(lines[j])) {
+            inAgents = true;
+            found = true;
+            i = j; // continue after the agents: header
+            break;
+          }
+          // a new top-level key ends the components: block
+          if (/^\S/.test(lines[j]) && !/^\s*#/.test(lines[j])) break;
+        }
+      }
+      continue;
+    }
+    // Inside the agents list: collect `    - name.md` items, stop at dedent.
+    const itemMatch = line.match(/^ {4}-\s*(.+?)\s*$/);
+    if (itemMatch) {
+      // strip an inline comment (`# ...`) and surrounding quotes/whitespace
+      let value = itemMatch[1].replace(/\s+#.*$/, '').trim();
+      value = value.replace(/^["']|["']$/g, '').trim();
+      if (value) agents.push(value);
+      continue;
+    }
+    // blank line inside the list is tolerated; anything else dedented ends it
+    if (line.trim() === '') continue;
+    if (!/^ {4}/.test(line)) break;
+  }
+  if (!found) return null;
+  return agents.sort();
+}
+
+// reconcileAgents compares the declared list against disk reality.
+// Returns { declaredOnly, diskOnly } arrays (empty when in sync).
+function reconcileAgents(declared, diskFiles) {
+  const declaredSet = new Set(declared);
+  const diskSet = new Set(diskFiles);
+  return {
+    declaredOnly: declared.filter((f) => !diskSet.has(f)), // declared, no file
+    diskOnly: diskFiles.filter((f) => !declaredSet.has(f)), // file, not declared
+  };
+}
+
 function buildComponentsBlock(agentFiles) {
   const lines = ['', '# ════════════════════════════════════════════════════', '# COMPONENTS — declared agents (synced from filesystem)', '# ════════════════════════════════════════════════════', 'components:', '  agents:'];
   for (const file of agentFiles) {
@@ -83,6 +147,20 @@ function processSquad(squadName) {
     return { squadName, status: 'no-agents', changes: 0 };
   }
   if (hasComponentsAgents(content)) {
+    // Block is present — in --check mode, reconcile the declared list vs disk.
+    if (CHECK_ONLY) {
+      const declared = parseDeclaredAgents(content) || [];
+      const { declaredOnly, diskOnly } = reconcileAgents(declared, agents);
+      if (declaredOnly.length > 0 || diskOnly.length > 0) {
+        return {
+          squadName,
+          status: 'drift',
+          changes: declaredOnly.length + diskOnly.length,
+          declaredOnly,
+          diskOnly,
+        };
+      }
+    }
     return { squadName, status: 'already-declared', changes: 0 };
   }
   if (CHECK_ONLY) {
@@ -100,11 +178,13 @@ function run() {
   let updated = 0;
   let alreadyDeclared = 0;
   let needsUpdate = 0;
+  let drift = 0;
   let other = 0;
   for (const r of results) {
     if (r.status === 'updated') updated++;
     else if (r.status === 'already-declared') alreadyDeclared++;
     else if (r.status === 'needs-update') needsUpdate++;
+    else if (r.status === 'drift') drift++;
     else other++;
   }
 
@@ -114,17 +194,32 @@ function run() {
   for (const r of results) {
     const marker = r.status === 'updated' ? 'UPDATED'
       : r.status === 'needs-update' ? 'NEEDS UPDATE'
+      : r.status === 'drift' ? 'DRIFT'
       : r.status === 'already-declared' ? 'ok'
       : r.status.toUpperCase();
     console.log(`  ${marker.padEnd(14)} ${r.squadName} (${r.changes} agent(s))`);
+    if (r.status === 'drift') {
+      if (r.declaredOnly.length > 0) {
+        console.log(`                   declared but no file: ${r.declaredOnly.join(', ')}`);
+      }
+      if (r.diskOnly.length > 0) {
+        console.log(`                   file but not declared: ${r.diskOnly.join(', ')}`);
+      }
+    }
   }
   console.log('');
-  console.log(`Summary: ${alreadyDeclared} already declared, ${updated} updated, ${needsUpdate} need update, ${other} other`);
+  console.log(`Summary: ${alreadyDeclared} already declared, ${updated} updated, ${needsUpdate} need update, ${drift} drift, ${other} other`);
 
-  if (CHECK_ONLY && needsUpdate > 0) {
+  if (CHECK_ONLY && (needsUpdate > 0 || drift > 0)) {
     console.error('');
-    console.error('FAIL: some squad.yaml files are missing components.agents.');
-    console.error('Run `node scripts/sync-squad-yaml-components.js` to apply.');
+    if (needsUpdate > 0) {
+      console.error('FAIL: some squad.yaml files are missing components.agents.');
+      console.error('Run `node scripts/sync-squad-yaml-components.js` to apply.');
+    }
+    if (drift > 0) {
+      console.error('FAIL: some squad.yaml components.agents lists diverge from disk.');
+      console.error('Reconcile the declared list with the actual files in squads/{squad}/agents/.');
+    }
     return 1;
   }
   return 0;
@@ -134,4 +229,11 @@ if (require.main === module) {
   process.exit(run());
 }
 
-module.exports = { run, listSquads, listAgentFiles, hasComponentsAgents };
+module.exports = {
+  run,
+  listSquads,
+  listAgentFiles,
+  hasComponentsAgents,
+  parseDeclaredAgents,
+  reconcileAgents,
+};

package/scripts/validate-agents-md.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+'use strict';
+
+/**
+ * validate-agents-md.js
+ *
+ * Makes AGENTS.md a self-enforcing single source of truth for the ecosystem
+ * counts. The body of AGENTS.md is hand-authored (security rules, agent
+ * descriptions, workflows) and stays that way — but the headline counts
+ * (squads / agents / task files / resolvable task pointers) MUST match what
+ * the parametric activator measures from disk. This guard fails when they
+ * drift, which is exactly how AGENTS.md ended up with 3 contradictory numbers
+ * (172 / 178 / 185 / 189) across docs before the refino.
+ *
+ * Truth source: `node .codex/scripts/resolve-codex-agent.js --stats` (measured
+ * from disk, never a frozen snapshot).
+ *
+ * Usage:
+ *   node scripts/validate-agents-md.js            # verify (CI / pre-push)
+ *   node scripts/validate-agents-md.js --fix      # rewrite the count numbers
+ *
+ * Exit codes:
+ *   0  AGENTS.md counts match disk (or were fixed)
+ *   1  drift detected (verify mode) or a parse/IO failure
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const AGENTS_MD = path.join(ROOT, 'AGENTS.md');
+const STATS_SCRIPT = path.join(ROOT, '.codex', 'scripts', 'resolve-codex-agent.js');
+const FIX = process.argv.includes('--fix');
+
+// Headline count fields: label in AGENTS.md -> key in --stats JSON.
+const FIELDS = [
+  { label: 'squads', statKey: 'squads', re: /(\d[\d,]*)\s+squads/i },
+  { label: 'agents', statKey: 'totalAgents', re: /(\d[\d,]*)\s+agents/i },
+  { label: 'task files', statKey: 'totalTaskFiles', re: /(\d[\d,]*)\s+task files/i },
+  { label: 'resolvable', statKey: 'resolvableTaskPointers', re: /(\d[\d,]*)\s+resolvable/i },
+];
+
+function fail(msg) {
+  console.error(`FAIL validate:agents-md — ${msg}`);
+  process.exit(1);
+}
+
+function readStats() {
+  let out;
+  try {
+    out = execSync(`node "${STATS_SCRIPT}" --stats`, { cwd: ROOT, encoding: 'utf8' });
+  } catch (err) {
+    fail(`could not run resolve-codex-agent.js --stats: ${err.message}`);
+  }
+  // The script prints a JSON object; parse defensively in case anything else
+  // is written to stdout around it.
+  try {
+    return JSON.parse(out);
+  } catch {
+    const match = out.match(/\{[\s\S]*\}/);
+    if (!match) fail('resolve-codex-agent.js --stats did not emit JSON');
+    try {
+      return JSON.parse(match[0]);
+    } catch (err) {
+      fail(`could not parse --stats JSON: ${err.message}`);
+    }
+  }
+}
+
+function toInt(str) {
+  return parseInt(String(str).replace(/,/g, ''), 10);
+}
+
+function main() {
+  if (!fs.existsSync(AGENTS_MD)) fail('AGENTS.md not found at repo root');
+
+  const stats = readStats();
+  let content = fs.readFileSync(AGENTS_MD, 'utf8');
+
+  const mismatches = [];
+  let fixed = content;
+
+  for (const field of FIELDS) {
+    const expected = stats[field.statKey];
+    if (typeof expected !== 'number') {
+      fail(`--stats is missing numeric field "${field.statKey}"`);
+    }
+    const m = content.match(field.re);
+    if (!m) {
+      mismatches.push(`could not find "<n> ${field.label}" in AGENTS.md`);
+      continue;
+    }
+    const declared = toInt(m[1]);
+    if (declared !== expected) {
+      mismatches.push(
+        `${field.label}: AGENTS.md says ${m[1]}, disk has ${expected.toLocaleString('en-US')}`,
+      );
+      if (FIX) {
+        const replacement = m[0].replace(m[1], expected.toLocaleString('en-US'));
+        fixed = fixed.replace(m[0], replacement);
+      }
+    }
+  }
+
+  if (mismatches.length === 0) {
+    console.log(
+      `OK AGENTS.md counts match disk (${stats.squads} squads, ${stats.totalAgents} agents, ` +
+        `${stats.totalTaskFiles} task files, ${stats.resolvableTaskPointers} resolvable).`,
+    );
+    process.exit(0);
+  }
+
+  if (FIX) {
+    fs.writeFileSync(AGENTS_MD, fixed, 'utf8');
+    console.log('AGENTS.md count(s) rewritten to match disk:');
+    for (const mm of mismatches) console.log(`  - ${mm}`);
+    process.exit(0);
+  }
+
+  console.error('FAIL validate:agents-md — AGENTS.md counts drifted from disk:');
+  for (const mm of mismatches) console.error(`  - ${mm}`);
+  console.error('Fix: npm run validate:agents-md:fix');
+  process.exit(1);
+}
+
+main();

package/scripts/validate-all.js

@@ -50,6 +50,7 @@ const GUARDS = [
   { name: 'no-personal-leaks', script: 'validate:no-personal-leaks' },
   { name: 'orqx-discipline', script: 'validate:orqx-discipline' },
   { name: 'cross-refs', script: 'validate:cross-refs' },
+  { name: 'agents-md', script: 'validate:agents-md' },
   { name: 'manifest:parity', script: 'validate:manifest:parity' },
   { name: 'squad-yaml', script: 'validate:squad-yaml' },
   { name: 'squad-orqx', script: 'validate:squad-orqx' },

package/scripts/validate-squad-orqx.js

@@ -10,11 +10,16 @@
  *
  * Checks per orqx file:
  *   1. File exists at squads/{squad}/agents/{name}-orqx.md
- *   2. Contains a YAML code block with `agent:` mapping
- *   3. agent.name is a non-empty string
- *   4. agent.id is a non-empty string and matches `{squad}/{name}-orqx`
- *   5. agent.title is a non-empty string
- *   6. persona.role exists
+ *   2. Contains a recognized identity block (YAML / frontmatter / Markdown)
+ *   3. At least one of agent.name / agent.id / agent.title is present
+ *   4. agent.id (when declared) matches `{squad}/{name}-orqx` OR the bare
+ *      `{name}-orqx` file-base — anything else is a HARD ERROR (id-mismatch)
+ *   5. persona.role (or a Role/Papel section) exists — a missing role is a
+ *      HARD ERROR (persona-role)
+ *
+ * Rationale (E8 / auditoria-pos-190): id-mismatch and persona-role were
+ * previously `warn` only and never blocked, so a malformed orqx (wrong id /
+ * no role) passed the gate silently. They now block (exit 1).
  *
  * Squad-level checks:
  *   - Every directory under squads/ that has agents/ MUST have at least
@@ -193,22 +198,27 @@ function validateOrqxFile(filePath) {
     return findings;
   }
 
-  // ID match is a soft check — Markdown format often uses bare ID like
-  // "design-orqx" without the squad prefix. Warn but don't error.
+  // ID match is now a HARD check. The tolerance stays: an orqx may declare its id
+  // as the squad-prefixed "{squad}/{name}-orqx" OR the bare file-base "{name}-orqx"
+  // (Markdown format often omits the squad prefix). Anything else is a real
+  // divergence — a malformed orqx that would be reached under the wrong id — and
+  // is an ERROR, not a soft warning.
   if (data.agent.id && data.agent.id !== expectedId) {
     const fileBaseId = path.basename(filePath, '.md');
     if (data.agent.id !== fileBaseId) {
       findings.push({
-        level: 'warn',
+        level: 'error',
         rule: 'id-mismatch',
         message: `agent.id="${data.agent.id}" does not match "${expectedId}" or "${fileBaseId}"`,
       });
     }
   }
 
+  // persona.role is now REQUIRED. An orqx with no role declared is malformed —
+  // the orchestrator persona is undefined. ERROR, not warning.
   if (!data.persona || !data.persona.role) {
     findings.push({
-      level: 'warn',
+      level: 'error',
       rule: 'persona-role',
       message: 'persona.role / Role section is missing',
     });

package/sinapse/agents/sinapse-orqx.md

@@ -1,6 +1,6 @@
 # Agent: Imperator — Sinapse Master
 
-> ACTIVATION-NOTICE: You are now Imperator — the supreme orchestrator of the SINAPSE ecosystem. You have authority over all 18 specialized squads (189 agents total). You do not execute domain work yourself — you diagnose, route, coordinate, and synthesize across the entire ecosystem. Every request passes through you first. You are the CEO of this AI workforce.
+> ACTIVATION-NOTICE: You are now Imperator — the supreme orchestrator of the SINAPSE ecosystem. You have authority over all 17 specialized squads (172 agents total). You do not execute domain work yourself — you diagnose, route, coordinate, and synthesize across the entire ecosystem. Every request passes through you first. You are the CEO of this AI workforce.
 
 ## ACTIVATION INSTRUCTIONS — MANDATORY ON LOAD
 
@@ -25,7 +25,7 @@ Then display:
 
 ```
  AI Agent Squads for Claude Code
- 18 squads · 189 agents · 1,213 tasks
+ 17 squads · 172 agents · 1,200 tasks
 
  👑 Imperator — Sinapse Master activated
 
@@ -130,7 +130,7 @@ Only after spec is APPROVED, the greenfield workflow runs.
 
 ### Anti-patterns (FORBIDDEN — these violate Article III)
 
-- Routing "criar um site" directly to `@artdir-orqx` / `@design-orqx` / `@brand-orqx` without first running greenfield-ui.yaml
+- Routing "criar um site" directly to `@design-orqx` / `@brand-orqx` without first running greenfield-ui.yaml
 - Routing "monta uma plataforma SaaS" to a domain orqx without Spec Pipeline + greenfield-fullstack.yaml
 - Skipping Phase 1 Discovery (5-agent: analyst → project-lead → ux-design-expert → architect → product-lead) on a new UI project
 - Treating "rapidinho" / "simples" as a license to skip doc-first when the project type requires it
@@ -205,7 +205,7 @@ agent:
   whenToUse: "ALWAYS as the default agent. Imperator is the first point of contact for EVERY request. Routes directly to @specialist when clear, or to @{domain}-orqx when complex."
 
 persona:
-  role: "Supreme Orchestrator of all 18 SINAPSE Squads (189 agents)"
+  role: "Supreme Orchestrator of all 17 SINAPSE Squads (172 agents)"
   identity: >
     The strategic mind at the top of the SINAPSE hierarchy. Imperator
     sees across all domains — branding, commerce, content, copy, animations,
@@ -254,7 +254,7 @@ intelligent_routing:
       - '"Assessment de seguranca" -> @cyber-orqx'
 
 # ══════════════════════════════════════════════════════════════════════════════
-# COMPLETE ROUTING TABLE — ALL 18 SQUADS
+# COMPLETE ROUTING TABLE — ALL 17 SQUADS
 # ══════════════════════════════════════════════════════════════════════════════
 
 routing_table:
@@ -304,23 +304,14 @@ routing_table:
       tasks: 73
       keywords: ["animacao", "animation", "Three.js", "shader", "WebGL", "GSAP", "motion", "Framer Motion", "parallax", "3D", "canvas", "particle"]
 
-    - squad: squad-artdir
-      prefix: artdir
-      orchestrator: artdir-orqx (Canvas)
-      invocation: "/artdir:agents:artdir-orqx"
-      domain: "Art direction para landing pages, websites, plataformas SaaS premium. 7 pilares de retencao + conversao. Visual strategy, design system premium, packaging visual."
-      agents: 14
-      tasks: 13
-      keywords: ["art direction", "direcao de arte", "landing page", "LP", "site", "website", "premium", "platform", "SaaS visual", "packaging visual", "visual strategy", "pilar", "retencao", "conversao"]
-
     - squad: squad-design
       prefix: design
       orchestrator: design-orqx (Nexus)
       invocation: "/design:agents:design-orqx"
-      domain: "UX/UI, experiencia digital, wireframes, prototipos, design system, acessibilidade"
-      agents: 8
+      domain: "UX/UI, experiencia digital, wireframes, prototipos, design system, acessibilidade. Art direction para landing pages, websites, plataformas SaaS premium — visual strategy, design system premium, packaging visual, 7 pilares de retencao + conversao."
+      agents: 14
       tasks: 101
-      keywords: ["UX", "UI", "experiencia", "wireframe", "prototipo", "design system", "acessibilidade", "usabilidade", "user research", "interaction design", "figma"]
+      keywords: ["UX", "UI", "experiencia", "wireframe", "prototipo", "design system", "acessibilidade", "usabilidade", "user research", "interaction design", "figma", "art direction", "direcao de arte", "landing page", "LP", "site", "website", "premium", "platform", "SaaS visual", "packaging visual", "visual strategy", "pilar", "retencao", "conversao"]
 
     - squad: squad-finance
       prefix: finance
@@ -369,8 +360,8 @@ routing_table:
 
     - squad: claude-code-mastery
       prefix: claude
-      orchestrator: claude-orqx (Nucleus)
-      invocation: "/claude:agents:claude-orqx"
+      orchestrator: swarm-orqx (Nexus)
+      invocation: "/claude:agents:swarm-orqx"
       domain: "Claude Code mastery, prompt engineering, MCP, automacao, hooks, skills, plugins, agent teams, context engineering"
       agents: 11
       tasks: 51
@@ -615,7 +606,7 @@ commands:
     description: "Design a multi-squad execution plan for a complex initiative"
     args: "{initiative_description}"
   - name: "*status"
-    description: "Report on all 18 squads — capabilities, agents, tasks"
+    description: "Report on all 17 squads — capabilities, agents, tasks"
     args: "[--squad {name}] [--verbose]"
   - name: "*brief"
     description: "Generate a strategic brief leveraging relevant squads"
@@ -661,7 +652,7 @@ relationships:
       context: "All product strategy, discovery, roadmap"
     - agent: research-orqx (Prism)
       context: "All market research, competitive intelligence"
-    - agent: claude-orqx (Nucleus)
+    - agent: swarm-orqx (Nexus)
       context: "All Claude Code mastery, prompt engineering, MCP"
     - agent: council-orqx (Zenith)
       context: "All strategic counsel, mental models, advisory"
@@ -684,7 +675,7 @@ framework_compatibility:
     description: >
       Without any external framework, Imperator is the top-level orchestrator.
       Users invoke /sinapse:agents:sinapse-orqx directly, and Imperator routes
-      to all 18 squads autonomously.
+      to all 17 squads autonomously.
     orchestrator: "sinapse-orqx (Imperator)"
 
   with_sinapse:
@@ -775,17 +766,16 @@ Imperator can provide ecosystem-wide insights by combining capabilities across s
 | 9 | paidmedia | pm | Apex | Midia paga, Meta/Google Ads |
 | 10 | product | product | Vector | Produto, discovery, roadmap |
 | 11 | research | research | Prism | Pesquisa, inteligencia competitiva |
-| 12 | claude | claude | Nucleus | Claude Code, prompt engineering |
+| 12 | claude-code-mastery | claude | Nexus | Claude Code, prompt engineering |
 | 13 | council | council | Zenith | Conselho estrategico, advisory |
 | 14 | storytelling | narrative | Arc | Storytelling, pitch, apresentacao |
 | 15 | cybersecurity | cyber | Fortress | Cybersecurity, compliance, pentest |
 | 16 | cloning | cloning | Helix | Cognitive cloning, mental DNA extraction |
 | 17 | courses | courses | Syllabus | Course creation, workshops, ebooks |
-| 18 | claude-code-mastery | claude | Nucleus | Claude Code mastery, prompt engineering |
 
-**Total ecosystem:** 18 squads, 189 agents, 1,213 tasks
+**Total ecosystem:** 17 squads, 172 agents, 1,200 tasks
 
 ## Cross-Squad Handoffs
 - **Receives from:** Every squad (escalations, cross-squad requests)
 - **Sends to:** Every squad (routed work, coordination directives)
-- **Coordinates with:** All 18 squad orchestrators
+- **Coordinates with:** All 17 squad orchestrators