sinapse-ai 7.1.0 → 7.2.0

package/.sinapse-ai/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 7.1.0
-generated_at: "2026-03-26T01:21:15.416Z"
+version: 7.2.0
+generated_at: "2026-03-26T05:43:00.009Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1082
 files:
@@ -1217,9 +1217,9 @@ files:
     type: data
     size: 9586
   - path: data/entity-registry.yaml
-    hash: sha256:b5d51b4bdde59ce778d619c8e7e8c2797f277ba95670983a51b81b3b5811cfe9
+    hash: sha256:a6566bf25cc73144d7fde73b13baacc08ed1c23e917eb42463d19cad97a09d4d
     type: data
-    size: 514036
+    size: 513853
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data

package/bin/cli.js

@@ -48,10 +48,13 @@ function getSquads(baseDir) {
   const squads = [];
   let entries;
   try {
-    entries = fs.readdirSync(baseDir).filter(d =>
-      d.startsWith('squad-') && !d.includes('.deprecated') &&
-      fs.statSync(path.join(baseDir, d)).isDirectory()
-    );
+    entries = fs.readdirSync(baseDir).filter(d => {
+      if (d.includes('.deprecated') || d.startsWith('.')) return false;
+      const dirPath = path.join(baseDir, d);
+      if (!fs.statSync(dirPath).isDirectory()) return false;
+      // Include squad-* dirs OR any dir with a squad.yaml manifest
+      return d.startsWith('squad-') || fs.existsSync(path.join(dirPath, 'squad.yaml'));
+    });
   } catch { return squads; }
 
   for (const dir of entries) {
@@ -124,10 +127,58 @@ function toForwardSlash(p) {
   return p.replace(/\\/g, '/');
 }
 
+/**
+ * Prompt user to select LLM(s) — inquirer checkbox with readline fallback.
+ * @returns {Promise<string>} 'claude-code' | 'codex' | 'both'
+ */
+async function promptLlmChoice() {
+  try {
+    const inquirer = require('inquirer');
+    const { llms } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'llms',
+      message: 'Escolha sua LLM (espaco seleciona, enter confirma):',
+      choices: [
+        { name: 'Claude Code (Recomendado)', value: 'claude-code', checked: true },
+        { name: 'Codex CLI', value: 'codex' },
+      ],
+    }]);
+    if (llms.length === 0) return 'claude-code'; // default if none selected
+    if (llms.length === 2) return 'both';
+    return llms[0];
+  } catch {
+    // Fallback: readline numbered choice
+    const readline = require('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+      console.log(`${CYAN}  Escolha sua LLM:${NC}`);
+      console.log(`    ${GREEN}1${NC}) Claude Code ${DIM}(Recomendado)${NC}`);
+      console.log(`    ${GREEN}2${NC}) Codex CLI`);
+      console.log(`    ${GREEN}3${NC}) Ambos`);
+      console.log('');
+      rl.question(`  ${BOLD}Opcao [1/2/3]:${NC} `, (answer) => {
+        rl.close();
+        const choice = (answer || '1').trim();
+        if (choice === '2') resolve('codex');
+        else if (choice === '3') resolve('both');
+        else resolve('claude-code');
+      });
+    });
+  }
+}
+
 // ── Global Install ───────────────────────────────────────────────────────────
 
-function cmdInstallGlobal() {
+async function cmdInstallGlobal() {
   header();
+  console.log(`${BOLD}  Bem-vindo ao SINAPSE AI!${NC}`);
+  console.log(`${DIM}  Vamos configurar seu copiloto de inteligencia artificial.${NC}`);
+  console.log('');
+
+  // LLM selection (inquirer checkbox with readline fallback)
+  const llmChoice = await promptLlmChoice();
+
+  console.log('');
   console.log(`${BOLD}Installing Sinapse globally...${NC}\n`);
 
   // Validate package — squads live in squads/ subdirectory
@@ -164,7 +215,7 @@ function cmdInstallGlobal() {
     console.log(`  ${GREEN}OK${NC} sinapse (master, ${masterAgents} agents)`);
   }
 
-  // Phase 2: Generate global commands
+  // Phase 2: Generate orqx commands
   console.log(`\n${CYAN}Phase 2:${NC} Generating agent commands`);
   fs.mkdirSync(CLAUDE_COMMANDS_DIR, { recursive: true });
 
@@ -175,23 +226,10 @@ function cmdInstallGlobal() {
     }
   } catch {}
 
-  let cmdCount = 0;
   const sinapseBase = toForwardSlash(SINAPSE_HOME);
+  const writtenAgents = new Set();
 
-  // Also copy framework agent commands (sinapse-orqx, dev, qa, etc.) if they exist in package
-  const frameworkCmdsDir = path.join(ROOT, '.claude', 'commands', 'SINAPSE', 'agents');
-  if (fs.existsSync(frameworkCmdsDir)) {
-    for (const f of fs.readdirSync(frameworkCmdsDir).filter(f => f.endsWith('.md'))) {
-      let content = fs.readFileSync(path.join(frameworkCmdsDir, f), 'utf8');
-      // Update paths to point to ~/.sinapse/
-      content = content.replace(/\.sinapse-core\//g, `${sinapseBase}/.sinapse-core/`);
-      fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, f), content);
-      cmdCount++;
-    }
-    console.log(`  ${GREEN}OK${NC} Framework agents — ${cmdCount} agents`);
-  }
-
-  // Generate commands only for orqx agents (user-facing orchestrators)
+  // Generate commands for orqx agents from squads (dynamic paths, always correct)
   for (const squad of squads) {
     const squadPath = `${sinapseBase}/${squad.name}`;
     const agentsDir = path.join(SINAPSE_HOME, squad.name, 'agents');
@@ -203,7 +241,7 @@ function cmdInstallGlobal() {
       const meta = extractAgentMeta(path.join(agentsDir, file));
       const cmdContent = generateCommandMd(agentId, meta.name, meta.icon, squad.name, squadPath, file);
       fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, `${agentId}.md`), cmdContent);
-      cmdCount++;
+      writtenAgents.add(file);
     }
   }
 
@@ -212,17 +250,36 @@ function cmdInstallGlobal() {
     const masterAgentsDir = path.join(sinapseMasterDest, 'agents');
     if (fs.existsSync(masterAgentsDir)) {
       for (const file of fs.readdirSync(masterAgentsDir).filter(f => f.endsWith('.md'))) {
+        if (writtenAgents.has(file)) continue;
         const agentId = file.replace('.md', '');
-        if (fs.existsSync(path.join(CLAUDE_COMMANDS_DIR, `${agentId}.md`))) continue; // skip if framework version exists
         const meta = extractAgentMeta(path.join(masterAgentsDir, file));
         const squadPath = `${sinapseBase}/sinapse`;
         const cmdContent = generateCommandMd(agentId, meta.name, meta.icon, 'sinapse', squadPath, file);
         fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, `${agentId}.md`), cmdContent);
-        cmdCount++;
+        writtenAgents.add(file);
       }
     }
   }
-  console.log(`  ${GREEN}OK${NC} ${cmdCount} total command files`);
+  console.log(`  ${GREEN}OK${NC} ${writtenAgents.size} total command files`);
+
+  // Phase 2b: Install global agents based on LLM choice
+  if (llmChoice === 'claude-code' || llmChoice === 'both') {
+    const globalAgentsDir = path.join(HOME, '.claude', 'agents');
+    fs.mkdirSync(globalAgentsDir, { recursive: true });
+    for (const f of fs.readdirSync(CLAUDE_COMMANDS_DIR).filter(f => f.endsWith('.md'))) {
+      fs.copyFileSync(path.join(CLAUDE_COMMANDS_DIR, f), path.join(globalAgentsDir, f));
+    }
+    console.log(`  ${GREEN}OK${NC} Claude Code global agents (${writtenAgents.size})`);
+  }
+
+  if (llmChoice === 'codex' || llmChoice === 'both') {
+    const codexAgentsDir = path.join(HOME, '.codex', 'agents');
+    fs.mkdirSync(codexAgentsDir, { recursive: true });
+    for (const f of fs.readdirSync(CLAUDE_COMMANDS_DIR).filter(f => f.endsWith('.md'))) {
+      fs.copyFileSync(path.join(CLAUDE_COMMANDS_DIR, f), path.join(codexAgentsDir, f));
+    }
+    console.log(`  ${GREEN}OK${NC} Codex global agents (${writtenAgents.size})`);
+  }
 
   // Phase 3: Generate squad-awareness.md
   console.log(`\n${CYAN}Phase 3:${NC} Generating squad-awareness rules`);
@@ -243,7 +300,8 @@ function cmdInstallGlobal() {
     installedAt: new Date().toISOString(),
     squads: squads.length,
     agents: totalAgents,
-    commands: cmdCount,
+    commands: writtenAgents.size,
+    llm: llmChoice,
     platform: process.platform,
   };
   fs.writeFileSync(path.join(SINAPSE_HOME, 'metadata.json'), JSON.stringify(meta, null, 2));
@@ -252,23 +310,23 @@ function cmdInstallGlobal() {
   console.log(`\n${CYAN}Verification:${NC}`);
   verifyInstall();
 
-  // Success
+  // Success message
+  let startCmd;
+  if (llmChoice === 'codex') startCmd = `Run ${CYAN}codex${NC} to start`;
+  else if (llmChoice === 'both') startCmd = `Run ${CYAN}sinapse${NC} or ${CYAN}codex${NC} to start`;
+  else startCmd = `Run ${CYAN}sinapse${NC} to start Claude Code with all agents`;
+
   console.log('');
   console.log(`${GREEN}══════════════════════════════════════════════════════════════${NC}`);
   console.log(`${GREEN}  Sinapse installed successfully!${NC}`);
   console.log(`${GREEN}══════════════════════════════════════════════════════════════${NC}`);
   console.log('');
-  console.log(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${cmdCount} agents${NC} | All under ${CYAN}/SINAPSE:agents:*${NC}`);
-  console.log('');
-  console.log(`  ${BOLD}Next steps:${NC}`);
-  console.log(`    1. Restart your terminal (for PATH changes)`);
-  console.log(`    2. Run ${CYAN}sinapse${NC} to start Claude Code with all agents`);
-  console.log(`    3. Or: ${CYAN}claude --add-dir ~/.sinapse${NC}`);
+  console.log(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${totalAgents} agents${NC} | ${BOLD}${writtenAgents.size} orqx commands${NC}`);
+  console.log(`  ${startCmd}`);
   console.log('');
   console.log(`  ${BOLD}Try an agent:${NC}`);
   console.log(`    ${CYAN}/SINAPSE:agents:sinapse-orqx${NC}`);
   console.log(`    ${CYAN}/SINAPSE:agents:brand-orqx${NC}`);
-  console.log(`    ${CYAN}/SINAPSE:agents:dev${NC}`);
   console.log('');
 }
 
@@ -565,23 +623,8 @@ async function cmdUpdateGlobal() {
   console.log(`${DIM}  Vamos atualizar seu SINAPSE AI para a v${VERSION}.${NC}`);
   console.log('');
 
-  // LLM selection (re-choose on every update)
-  const readline = require('readline');
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  const llmChoice = await new Promise((resolve) => {
-    console.log(`${CYAN}  Escolha sua LLM:${NC}`);
-    console.log(`    ${GREEN}1${NC}) Claude Code ${DIM}(Recomendado)${NC}`);
-    console.log(`    ${GREEN}2${NC}) Codex CLI`);
-    console.log(`    ${GREEN}3${NC}) Ambos`);
-    console.log('');
-    rl.question(`  ${BOLD}Opcao [1/2/3]:${NC} `, (answer) => {
-      rl.close();
-      const choice = (answer || '1').trim();
-      if (choice === '2') resolve('codex');
-      else if (choice === '3') resolve('both');
-      else resolve('claude-code');
-    });
-  });
+  // LLM selection (inquirer checkbox with readline fallback)
+  const llmChoice = await promptLlmChoice();
 
   console.log('');
   console.log(`${BOLD}Atualizando SINAPSE AI...${NC}\n`);
@@ -614,19 +657,9 @@ async function cmdUpdateGlobal() {
   fs.mkdirSync(CLAUDE_COMMANDS_DIR, { recursive: true });
 
   const sinapseBase = toForwardSlash(SINAPSE_HOME);
-  let cmdCount = 0;
-
-  const frameworkCmdsDir = path.join(ROOT, '.claude', 'commands', 'SINAPSE', 'agents');
-  if (fs.existsSync(frameworkCmdsDir)) {
-    for (const f of fs.readdirSync(frameworkCmdsDir).filter(f => f.endsWith('.md'))) {
-      let content = fs.readFileSync(path.join(frameworkCmdsDir, f), 'utf8');
-      content = content.replace(/\.sinapse-core\//g, `${sinapseBase}/.sinapse-core/`);
-      fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, f), content);
-      cmdCount++;
-    }
-  }
+  const writtenAgents = new Set();
 
-  // Count total agents and generate orqx commands (skip if already copied from framework)
+  // Generate commands for orqx agents from squads (dynamic paths)
   let totalAgents = 0;
   for (const squad of squads) {
     const agentsDir = path.join(SINAPSE_HOME, squad.name, 'agents');
@@ -635,21 +668,29 @@ async function cmdUpdateGlobal() {
     totalAgents += allAgents.length;
     const orqxAgents = allAgents.filter(f => f.includes('-orqx'));
     for (const file of orqxAgents) {
-      const destPath = path.join(CLAUDE_COMMANDS_DIR, file);
-      if (fs.existsSync(destPath)) continue; // skip if already from framework
       const agentId = file.replace('.md', '');
       const meta = extractAgentMeta(path.join(agentsDir, file));
       const squadPath = `${sinapseBase}/${squad.name}`;
-      fs.writeFileSync(destPath, generateCommandMd(agentId, meta.name, meta.icon, squad.name, squadPath, file));
-      cmdCount++;
+      fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, file), generateCommandMd(agentId, meta.name, meta.icon, squad.name, squadPath, file));
+      writtenAgents.add(file);
     }
   }
-  // Also count sinapse/ orqx agents
+
+  // Generate commands for sinapse/ orqx squad agents
   const sinapseAgentsDir = path.join(SINAPSE_HOME, 'sinapse', 'agents');
   if (fs.existsSync(sinapseAgentsDir)) {
-    totalAgents += fs.readdirSync(sinapseAgentsDir).filter(f => f.endsWith('.md')).length;
+    const masterAgents = fs.readdirSync(sinapseAgentsDir).filter(f => f.endsWith('.md'));
+    totalAgents += masterAgents.length;
+    for (const file of masterAgents) {
+      if (writtenAgents.has(file)) continue;
+      const agentId = file.replace('.md', '');
+      const meta = extractAgentMeta(path.join(sinapseAgentsDir, file));
+      const squadPath = `${sinapseBase}/sinapse`;
+      fs.writeFileSync(path.join(CLAUDE_COMMANDS_DIR, file), generateCommandMd(agentId, meta.name, meta.icon, 'sinapse', squadPath, file));
+      writtenAgents.add(file);
+    }
   }
-  console.log(`  ${GREEN}OK${NC} ${cmdCount} command files (${totalAgents} agents total)`);
+  console.log(`  ${GREEN}OK${NC} ${writtenAgents.size} command files (${totalAgents} agents total)`);
 
   // Phase 2b: Install global agents based on LLM choice
   if (llmChoice === 'claude-code' || llmChoice === 'both') {
@@ -659,7 +700,7 @@ async function cmdUpdateGlobal() {
     for (const f of fs.readdirSync(CLAUDE_COMMANDS_DIR).filter(f => f.endsWith('.md'))) {
       fs.copyFileSync(path.join(CLAUDE_COMMANDS_DIR, f), path.join(globalAgentsDir, f));
     }
-    console.log(`  ${GREEN}OK${NC} Claude Code global agents (${cmdCount})`);
+    console.log(`  ${GREEN}OK${NC} Claude Code global agents (${writtenAgents.size})`);
   }
 
   if (llmChoice === 'codex' || llmChoice === 'both') {
@@ -669,7 +710,7 @@ async function cmdUpdateGlobal() {
     for (const f of fs.readdirSync(CLAUDE_COMMANDS_DIR).filter(f => f.endsWith('.md'))) {
       fs.copyFileSync(path.join(CLAUDE_COMMANDS_DIR, f), path.join(codexAgentsDir, f));
     }
-    console.log(`  ${GREEN}OK${NC} Codex global agents (${cmdCount})`);
+    console.log(`  ${GREEN}OK${NC} Codex global agents (${writtenAgents.size})`);
   }
 
   // Phase 3: Regenerate awareness
@@ -682,7 +723,7 @@ async function cmdUpdateGlobal() {
   const meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
   meta.updatedAt = new Date().toISOString();
   meta.squads = squads.length;
-  meta.commands = cmdCount;
+  meta.commands = writtenAgents.size;
   fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
 
   let startCmd;
@@ -695,7 +736,7 @@ async function cmdUpdateGlobal() {
   console.log(`${GREEN}  SINAPSE AI atualizado para v${VERSION}!${NC}`);
   console.log(`${GREEN}══════════════════════════════════════════════════════════════${NC}`);
   console.log('');
-  console.log(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${totalAgents} agents${NC} | ${BOLD}${cmdCount} orqx commands${NC}`);
+  console.log(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${totalAgents} agents${NC} | ${BOLD}${writtenAgents.size} orqx commands${NC}`);
   console.log(`  ${startCmd}`);
   console.log('');
 }
@@ -858,7 +899,7 @@ const command = args[0] || 'help';
 const isLocal = args.includes('--local');
 
 switch (command) {
-  case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal(); break;
+  case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal().catch(e => { console.error(e.message); process.exit(1); }); break;
   case 'update':   isLocal ? cmdUpdateLocal()  : cmdUpdateGlobal().catch(e => { console.error(e.message); process.exit(1); });  break;
   case 'uninstall': cmdUninstall(); break;
   case 'list':     cmdList(); break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 18 squads, 174 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",
@@ -21,6 +21,7 @@
     ".claude/rules/",
     ".claude/hooks/",
     "squads/squad-*/**",
+    "squads/claude-code-mastery/**",
     "squads/sinapse/**",
     "sinapse/**",
     "install-squads.sh",

package/squads/claude-code-mastery/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog — claude-code-mastery
+
+All notable changes to the Claude Code Mastery squad.
+
+## [1.0.0] - 2026-03-02
+
+### Added
+- 8 specialist agents: claude-mastery-chief (Orion), hooks-architect (Latch), mcp-integrator (Piper), swarm-orqx (Nexus), config-engineer (Sigil), skill-craftsman (Anvil), project-integrator (Conduit), roadmap-sentinel (Vigil)
+- 26 executable tasks across all agents
+- 3 multi-phase workflows (wf-project-setup, wf-knowledge-update, wf-audit-complete)
+- 5 knowledge base files (quick-ref, project-type-signatures, hook-patterns, ci-cd-patterns, mcp-catalog)
+- 7 templates (5 CLAUDE.md project templates + 2 GitHub Actions workflows)
+- 8 mind DNA summaries (disler, steipete, kieran-klaassen, reuven-cohen, superclaude-org, bmad-code-org, daniel-miessler, boris-cherny)
+- 1 validation script (validate-setup.js)
+- Tier architecture: Tier 0 (Diagnosis), Tier 1 (Core Mastery), Tier 2 (Strategic & Context)
+- Handoff matrix with full routing between all agents
+- SINAPSE integration bridge (agents, tasks, hooks, config mapping)
+
+### Architecture
+- Entry agent: claude-mastery-chief (Orion) with 7-domain routing matrix
+- Cross-cutting concern: all agents understand SINAPSE architecture
+- Knowledge sources: Claude Code changelog, official docs, community resources

package/squads/claude-code-mastery/README.md

@@ -0,0 +1,146 @@
+# Claude Code Mastery Squad
+
+> Full-spectrum expertise in Claude Code: hooks, skills, subagents, MCP, plugins, agent teams, customization, integration, and roadmap awareness.
+
+**Version:** 1.0.0 | **Created:** 2026-03-01 | **Total:** 8 agents, 6,741 lines
+
+## Squad Architecture
+
+```
+                        Orion (Orchestrator)
+                     claude-mastery-chief [Tier 0]
+                              |
+            ┌─────────┬───────┴───────┬──────────┐
+            |         |               |          |
+    ┌───────┴──┐  ┌───┴────┐  ┌──────┴───┐  ┌───┴──────┐
+    |  Latch   |  | Piper  |  |  Nexus   |  |  Sigil   |
+    |  Hooks   |  |  MCP   |  |  Swarm   |  |  Config  |
+    | Tier 1   |  | Tier 1 |  |  Tier 1  |  |  Tier 1  |
+    └──────────┘  └────────┘  └──────────┘  └──────────┘
+            |         |               |
+    ┌───────┴──┐  ┌───┴────┐  ┌──────┴───┐
+    |  Anvil   |  | Conduit|  |  Vigil   |
+    |  Skills  |  | Project|  | Roadmap  |
+    | Tier 2   |  | Tier 2 |  |  Tier 2  |
+    └──────────┘  └────────┘  └──────────┘
+```
+
+## Agents
+
+| Tier | Agent | Persona | Based On | Lines | Focus |
+|------|-------|---------|----------|-------|-------|
+| 0 | claude-mastery-chief | Orion | Original | 554 | Triage, routing, cross-cutting knowledge |
+| 1 | hooks-architect | Latch | disler (IndyDevDan) | 1,013 | 17 hook events, automation, damage control |
+| 1 | mcp-integrator | Piper | Peter Steinberger (@steipete) | 791 | MCP servers, tool discovery, context budget |
+| 1 | swarm-orqx | Nexus | Kieran Klaassen + Reuven Cohen | 1,008 | Agent teams, subagents, parallel execution |
+| 1 | config-engineer | Sigil | SuperClaude-Org | 663 | Settings, permissions, CLAUDE.md, sandbox |
+| 2 | skill-craftsman | Anvil | BMAD-CODE-ORG | 1,046 | Skills, plugins, commands, context engineering |
+| 2 | project-integrator | Conduit | Daniel Miessler (PAI) | 959 | Project integration, CI/CD, SINAPSE bridge |
+| 2 | roadmap-sentinel | Vigil | Boris Cherny | 707 | Roadmap, changelog, feature adoption |
+
+## Quick Start
+
+### Activate the Orchestrator
+```
+@claude-code-mastery:claude-mastery-chief
+```
+Or use the SINAPSE activation:
+```
+/SINAPSE:agents:claude-mastery-chief
+```
+
+### Direct Specialist Access
+```
+/SINAPSE:agents:hooks-architect        # Hook automation
+/SINAPSE:agents:mcp-integrator         # MCP servers
+/SINAPSE:agents:swarm-orqx     # Multi-agent orchestration
+/SINAPSE:agents:config-engineer        # Settings & permissions
+/SINAPSE:agents:skill-craftsman        # Skills & plugins
+/SINAPSE:agents:project-integrator     # Project integration
+/SINAPSE:agents:roadmap-sentinel       # Updates & roadmap
+```
+
+## Feature Coverage
+
+| Claude Code Feature | Specialist | Key Commands |
+|-------------------|-----------|-------------|
+| Hooks (17 events) | Latch | `*create-hook`, `*audit-hooks`, `*hook-patterns` |
+| MCP Integration | Piper | `*add-server`, `*audit-mcp`, `*create-mcp-server` |
+| Subagents & Teams | Nexus | `*create-agent`, `*create-team`, `*orchestrate` |
+| Settings & Permissions | Sigil | `*configure`, `*permission-strategy`, `*sandbox-setup` |
+| Skills & Plugins | Anvil | `*create-skill`, `*create-plugin`, `*context-strategy` |
+| Project Integration | Conduit | `*integrate-project`, `*brownfield-setup`, `*ci-cd-setup` |
+| Roadmap & Updates | Vigil | `*update-knowledge`, `*feature-radar`, `*migration-guide` |
+| SINAPSE Bridge | Orion + Conduit | `*sinapse-bridge`, `*sinapse-guide` |
+
+## Elite Minds Research Attribution
+
+This squad was created through iterative research with devil's advocate validation (3 iterations). Each agent is based on real people/projects with documented frameworks:
+
+| Mind | Contribution | Source |
+|------|-------------|--------|
+| **disler** (IndyDevDan) | Hooks Mastery framework, meta-agent patterns, damage control | [GitHub](https://github.com/disler/claude-code-hooks-mastery) |
+| **Peter Steinberger** (@steipete) | claude-code-mcp, multi-instance workflow, CLI-first philosophy | [Blog](https://steipete.me/), [GitHub](https://github.com/steipete/claude-code-mcp) |
+| **Kieran Klaassen** | TeammateTool discovery, swarm patterns documentation | [Gists](https://gist.github.com/kieranklaassen) |
+| **Reuven Cohen** (ruvnet) | Ruflo orchestration platform, 54+ agents, WASM kernels | [GitHub](https://github.com/ruvnet/ruflo) |
+| **SuperClaude-Org** | 9 cognitive personas, 5 behavioral modes, pure .md config | [GitHub](https://github.com/SuperClaude-Org/SuperClaude_Framework) |
+| **BMAD-CODE-ORG** | BMAD Method, 21 agents, 50+ workflows, spec-driven development | [Docs](https://docs.bmad-method.org/) |
+| **Daniel Miessler** | Personal AI Infrastructure (PAI), Unix philosophy for AI | [Blog](https://danielmiessler.com/), [GitHub](https://github.com/danielmiessler/Personal_AI_Infrastructure) |
+| **Boris Cherny** | Claude Code creator, plan-first methodology, parallel instances | [Blog](https://boristane.com/), [Pragmatic Engineer](https://newsletter.pragmaticengineer.com/p/how-claude-code-is-built) |
+
+## SINAPSE Integration
+
+This squad understands both Claude Code native capabilities AND the SINAPSE framework:
+
+| SINAPSE Concept | Claude Code Equivalent | Bridge Agent |
+|-------------|----------------------|-------------|
+| Agents (@developer, @qa...) | Subagents (.claude/agents/) | Nexus |
+| Tasks (.sinapse-ai/tasks/) | Skills (.claude/skills/) | Anvil |
+| Workflows | Multi-step sessions | Nexus + Orion |
+| core-config.yaml | .claude/settings.json | Sigil |
+| Python hooks (monitor/) | Native hooks (command/http/prompt/agent) | Latch |
+| Quality gates | Hook-based validation | Latch + Sigil |
+| Entity registry | Tool Search + MCP registry | Piper |
+
+## Directory Structure
+
+```
+squads/claude-code-mastery/
+├── config.yaml                    # Squad configuration and tier architecture
+├── README.md                      # This file
+├── agents/
+│   ├── claude-mastery-chief.md    # Tier 0: Orchestrator (Orion)
+│   ├── hooks-architect.md         # Tier 1: Hooks (Latch)
+│   ├── mcp-integrator.md          # Tier 1: MCP (Piper)
+│   ├── swarm-orqx.md      # Tier 1: Subagents/Teams (Nexus)
+│   ├── config-engineer.md         # Tier 1: Settings/Config (Sigil)
+│   ├── skill-craftsman.md         # Tier 2: Skills/Plugins (Anvil)
+│   ├── project-integrator.md      # Tier 2: Integration (Conduit)
+│   └── roadmap-sentinel.md        # Tier 2: Roadmap (Vigil)
+├── tasks/                         # Squad-specific tasks
+├── workflows/                     # Multi-phase workflows
+├── templates/                     # Output templates
+├── data/                          # Reference data
+├── scripts/                       # Utility scripts
+└── outputs/
+    └── minds/                     # Mind DNA extractions
+```
+
+## Quality Metrics
+
+| Metric | Value |
+|--------|-------|
+| Total agents | 8 |
+| Total lines | 6,741 |
+| Avg lines/agent | 843 |
+| Tier 0 coverage | 1 orchestrator |
+| Tier 1 coverage | 4 core specialists |
+| Tier 2 coverage | 3 strategic specialists |
+| Minds cloned | 8 (from 7 distinct sources) |
+| Research iterations | 3 (with devil's advocate) |
+| Naming collisions fixed | 2 (Piper, Sigil) |
+
+---
+
+*Claude Code Mastery Squad v1.0 — Created by Squad Architect*
+*Philosophy: "Master the tool to master the craft."*