π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
fix(scaffold): add dead-reference guard + deterministic CLI remap (ADR-382 Part C) (#2974)
rUv83e536396f68
diff --git a/.github/workflows/v3-ci.yml b/.github/workflows/v3-ci.ymlindex dd7c58b240..d456dec47f 100644--- a/.github/workflows/v3-ci.yml+++ b/.github/workflows/v3-ci.yml@@ -123,6 +123,11 @@ on:- 'plugins/*/skills/**'- 'plugins/*/commands/**'- 'scripts/smoke-init-bundle-invariants.mjs'+ # Init-scaffold content-drift guard (ADR-382 Part C, #2971) β dead+ # CLI/tool refs, plugin MCP-launch pinning, marketplace completeness.+ - 'plugins/*/.mcp.json'+ - '.claude-plugin/marketplace.json'+ - 'scripts/smoke-init-scaffold-references.mjs'# ADR-129 β rvagent full integration (P1-P4)- 'v3/@claude-flow/cli/src/ruvector/agent-wasm.ts'- 'v3/@claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts'@@ -241,6 +246,11 @@ on:- 'plugins/*/skills/**'- 'plugins/*/commands/**'- 'scripts/smoke-init-bundle-invariants.mjs'+ # Init-scaffold content-drift guard (ADR-382 Part C, #2971) β dead+ # CLI/tool refs, plugin MCP-launch pinning, marketplace completeness.+ - 'plugins/*/.mcp.json'+ - '.claude-plugin/marketplace.json'+ - 'scripts/smoke-init-scaffold-references.mjs'# ADR-129 β rvagent full integration (P1-P4)- 'v3/@claude-flow/cli/src/ruvector/agent-wasm.ts'- 'v3/@claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts'@@ -2235,6 +2245,39 @@ jobs:- name: Run init-bundle invariants smokerun: node scripts/smoke-init-bundle-invariants.mjs+ init-scaffold-references-smoke:+ # Regression guard for ruvnet/ruflo#2971 β ADR-382 Part C.+ #+ # Statically scans the @claude-flow/cli init scaffold and the+ # plugin/marketplace surface for four content-drift classes:+ #+ # 1. Dead `npx claude-flow` (bare) CLI invocations.+ # 2. Dead `mcp__claude-flow__<tool>` references not in the live+ # tool registry (derived from mcp-client.ts's own imports).+ # 3. Plugin .mcp.json launches that regress to a bare unpinned+ # `@latest` npx call with no local-bin-first resolver.+ # 4. plugins/* directories missing from .claude-plugin/marketplace.json.+ #+ # Ships warn-only (no --strict) until the deterministic remap (ADR-382+ # Part C step 2) clears the dead-reference backlog and ADR-382 Part A+ # lands the .mcp.json resolver + marketplace entries.+ #+ # Zero runtime deps; pure Node.js readFileSync + readdirSync.+ name: init-scaffold references smoke (#2971, ADR-382 Part C)+ runs-on: ubuntu-latest++ steps:+ - name: Checkout code+ uses: actions/checkout@v4++ - name: Setup Node.js+ uses: actions/setup-node@v4+ with:+ node-version: '22'++ - name: Run init-scaffold references smoke+ run: node scripts/smoke-init-scaffold-references.mjs+wasm-provider-bridge-smoke:# ADR-129 Phase 1 β JsModelProvider routes WasmAgent through the v3# provider system. Pre-P1: set_model_provider() was never called anddiff --git a/scripts/smoke-init-scaffold-references.mjs b/scripts/smoke-init-scaffold-references.mjsnew file mode 100644index 0000000000..b1e7369573--- /dev/null+++ b/scripts/smoke-init-scaffold-references.mjs@@ -0,0 +1,359 @@+#!/usr/bin/env node+/**+ * Init-scaffold content-drift guard β ADR-382 Part C (#2971).+ *+ * Four static assertions over the shipped @claude-flow/cli init scaffold and+ * the marketplace/plugin surface it depends on:+ *+ * 1. DEAD CLI INVOCATION β `npx claude-flow` (bare, unscoped, unpinned) in+ * v3/@claude-flow/cli/.claude/**. The canonical form is derived from+ * that package's own package.json `name`, not hand-maintained, so this+ * check tracks a future rename automatically. `npx claude-flow@alpha` /+ * `@v3alpha` are intentionally NOT flagged β those are the maintained+ * legacy dist-tags (see root CLAUDE.md Publishing section), not dead.+ *+ * 2. DEAD MCP TOOL REFERENCES β `mcp__claude-flow__<name>` (or the+ * `mcp__claude_flow__` underscore typo) where <name> is not present in+ * the live tool registry. The live set is derived by statically+ * parsing mcp-client.ts's own import list and extracting every+ * `name: '...'` tool declaration from each imported module β the same+ * registry the running MCP server assembles at startup (mcp-client.ts+ * TOOL_REGISTRY), just read without executing TypeScript. Wildcard doc+ * references like `mcp__claude-flow__swarm_*` are not flagged.+ *+ * 3. PLUGIN MCP-LAUNCH PINNING REGRESSION β any plugins/*\/.mcp.json whose+ * server launches a bare `npx ... <pkg>@latest` with no local-bin-first+ * resolver in front of it (ADR-382 Part A fixes this for ruflo-core by+ * mirroring resolveCliBinForHook() in .claude/helpers/hook-handler.cjs;+ * this check guards the fix from regressing and catches any other+ * plugin with the same unpinned pattern).+ *+ * 4. MARKETPLACE COMPLETENESS β every directory under plugins/ has a+ * matching entry in .claude-plugin/marketplace.json. Guards the+ * regression that let ruflo-agntcy / ruflo-bbs-federation /+ * ruflo-business-pods silently go unlisted (ADR-382 Gap 4).+ *+ * Ships in WARN-ONLY mode: violations are always printed, but the process+ * exits 0 unless `--strict` is passed, in which case it exits 1 on any+ * violation. Run `--strict` once the deterministic remap (ADR-382 Part C+ * step 2) has driven checks 1-2's backlog to zero; checks 3-4 can go+ * `--strict` as soon as Part A lands.+ *+ * Zero runtime dependencies beyond Node built-ins β pure readFileSync /+ * readdirSync / regex, following the smoke-deprecated-actions.mjs /+ * smoke-init-bundle-invariants.mjs pattern.+ *+ * Usage:+ * node scripts/smoke-init-scaffold-references.mjs # warn-only, always exit 0+ * node scripts/smoke-init-scaffold-references.mjs --strict # exit 1 on any violation+ * node scripts/smoke-init-scaffold-references.mjs --help # this text+ */++import { readFileSync, readdirSync, existsSync } from 'node:fs';+import { join } from 'node:path';++const REPO_ROOT = process.cwd();+const STRICT = process.argv.includes('--strict');+const HELP = process.argv.includes('--help') || process.argv.includes('-h');++const USAGE = `smoke-init-scaffold-references.mjs β ADR-382 Part C dead-reference guard++Checks the @claude-flow/cli init scaffold (v3/@claude-flow/cli/.claude/**)+and the plugin/marketplace surface for stale CLI invocations, dead MCP tool+references, unpinned plugin MCP launches, and marketplace registry gaps.++Modes:+ (default) warn-only β prints every violation, always exits 0+ --strict blocking β prints every violation, exits 1 if any are found++This ships warn-only in the PR that introduces it (ADR-382 Part C), because+the dead-reference backlog (checks 1-2) is nonzero until the deterministic+remap lands. Flip CI to --strict once that backlog clears; checks 3-4 can go+--strict independently once ADR-382 Part A merges.++Flags:+ --strict exit 1 on any violation (see above)+ --help,-h print this message and exit 0+`;++if (HELP) {+ console.log(USAGE);+ process.exit(0);+}++const CLI_ROOT = join(REPO_ROOT, 'v3', '@claude-flow', 'cli');+const CLI_SRC = join(CLI_ROOT, 'src');+const MCP_CLIENT_TS = join(CLI_SRC, 'mcp-client.ts');+const SCAFFOLD_DIR = join(CLI_ROOT, '.claude');+const PLUGINS_DIR = join(REPO_ROOT, 'plugins');+const MARKETPLACE_JSON = join(REPO_ROOT, '.claude-plugin', 'marketplace.json');++// ---------------------------------------------------------------------------+// Helpers+// ---------------------------------------------------------------------------++function walkFiles(dir) {+ if (!existsSync(dir)) return [];+ const out = [];+ for (const entry of readdirSync(dir, { withFileTypes: true })) {+ const full = join(dir, entry.name);+ if (entry.isDirectory()) {+ out.push(...walkFiles(full));+ } else if (entry.isFile()) {+ out.push(full);+ }+ }+ return out;+}++function rel(p) {+ return p.startsWith(REPO_ROOT + '/') ? p.slice(REPO_ROOT.length + 1) : p;+}++function readText(p) {+ try {+ return readFileSync(p, 'utf-8');+ } catch {+ return null;+ }+}++// ---------------------------------------------------------------------------+// Live-registry derivation (checks 1-2)+// ---------------------------------------------------------------------------++// Statically parses mcp-client.ts's own `from './mcp-tools/foo.js'` imports+// and extracts every `name: '...'` MCPTool declaration from each resolved+// .ts source β the exact set TOOL_REGISTRY assembles at runtime, derived+// without executing TypeScript.+function deriveLiveToolNames() {+ const names = new Set();+ const src = readText(MCP_CLIENT_TS);+ if (!src) return names;++ const modules = new Set();+ for (const m of src.matchAll(/from\s+'(\.\/[^']+)\.js'/g)) {+ modules.add(m[1].replace(/^\.\//, ''));+ }++ for (const mod of modules) {+ const modSrc = readText(join(CLI_SRC, `${mod}.ts`));+ if (!modSrc) continue;+ for (const m of modSrc.matchAll(/^\s*name:\s*'([a-zA-Z0-9_-]+)'/gm)) {+ names.add(m[1]);+ }+ }+ return names;+}++// Derives the canonical `npx <pkg>@latest` form from the CLI package's own+// package.json `name` field rather than hand-maintaining the string, so a+// future rename doesn't silently desync the guard from reality.+function deriveCanonicalCliInvocation() {+ const pkgSrc = readText(join(CLI_ROOT, 'package.json'));+ if (!pkgSrc) return 'npx @claude-flow/cli@latest';+ try {+ const pkg = JSON.parse(pkgSrc);+ return `npx ${pkg.name}@latest`;+ } catch {+ return 'npx @claude-flow/cli@latest';+ }+}++const LIVE_TOOL_NAMES = deriveLiveToolNames();+const CANONICAL_CLI_INVOCATION = deriveCanonicalCliInvocation();++// ---------------------------------------------------------------------------+// Check 1 β dead `npx claude-flow` (bare) invocation+// ---------------------------------------------------------------------------++// Negative lookahead excludes `@version` (maintained legacy dist-tags),+// word chars, `/` and `-` so we never match inside `@claude-flow/cli` or a+// hypothetical `claude-flow-codex` β only the bare, unscoped, unpinned form.+const DEAD_CLI_PATTERN = /npx claude-flow(?![\w@/-])/g;++function checkDeadCliInvocations(files) {+ const violations = [];+ for (const file of files) {+ const content = readText(file);+ if (!content) continue;+ const lines = content.split('\n');+ for (let i = 0; i < lines.length; i++) {+ if (DEAD_CLI_PATTERN.test(lines[i])) {+ violations.push({+ file: rel(file),+ line: i + 1,+ text: lines[i].trim(),+ message: `'npx claude-flow' (bare) β supersede with '${CANONICAL_CLI_INVOCATION}'`,+ });+ }+ DEAD_CLI_PATTERN.lastIndex = 0;+ }+ }+ return violations;+}++// ---------------------------------------------------------------------------+// Check 2 β dead `mcp__claude-flow__<tool>` references+// ---------------------------------------------------------------------------++const TOOL_REF_PATTERN = /mcp__claude[-_]flow__([A-Za-z][A-Za-z0-9_-]*)/g;++function checkDeadToolReferences(files) {+ const violations = [];+ for (const file of files) {+ const content = readText(file);+ if (!content) continue;+ const lines = content.split('\n');+ for (let i = 0; i < lines.length; i++) {+ const line = lines[i];+ for (const m of line.matchAll(TOOL_REF_PATTERN)) {+ const name = m[1];+ const endIdx = m.index + m[0].length;+ if (line[endIdx] === '*') continue; // wildcard family doc, e.g. swarm_*+ if (LIVE_TOOL_NAMES.has(name)) continue;+ violations.push({+ file: rel(file),+ line: i + 1,+ text: line.trim(),+ message: `mcp__claude-flow__${name} β not in the live ${LIVE_TOOL_NAMES.size}-tool registry`,+ });+ }+ }+ }+ return violations;+}++// ---------------------------------------------------------------------------+// Check 3 β plugin MCP-launch pinning regression+// ---------------------------------------------------------------------------++// Matches an npx arg that is a bare `@latest`-tagged launch of one of the+// three public release-train packages (root CLAUDE.md), with no local-bin+// resolver indirection in front of it.+const UNPINNED_LATEST_ARG = /^(?:@claude-flow\/cli|claude-flow|ruflo)@latest$/;++function findPluginMcpJsonFiles() {+ if (!existsSync(PLUGINS_DIR)) return [];+ const out = [];+ for (const entry of readdirSync(PLUGINS_DIR, { withFileTypes: true })) {+ if (!entry.isDirectory()) continue;+ const p = join(PLUGINS_DIR, entry.name, '.mcp.json');+ if (existsSync(p)) out.push(p);+ }+ return out;+}++function checkPluginMcpPinning() {+ const violations = [];+ for (const file of findPluginMcpJsonFiles()) {+ const src = readText(file);+ if (!src) continue;+ let json;+ try {+ json = JSON.parse(src);+ } catch (e) {+ violations.push({ file: rel(file), message: `invalid JSON: ${e.message}` });+ continue;+ }+ const servers = json.mcpServers || {};+ for (const [serverName, cfg] of Object.entries(servers)) {+ const args = Array.isArray(cfg.args) ? cfg.args : [];+ const bareLatestArg = args.find((a) => typeof a === 'string' && UNPINNED_LATEST_ARG.test(a));+ if (cfg.command === 'npx' && bareLatestArg) {+ violations.push({+ file: rel(file),+ message: `server '${serverName}' launches bare 'npx -y ${bareLatestArg}' β no local-bin-first ` ++ `resolver in front of it (mirror resolveCliBinForHook() in .claude/helpers/hook-handler.cjs, ADR-382 Part A)`,+ });+ }+ }+ }+ return violations;+}++// ---------------------------------------------------------------------------+// Check 4 β marketplace completeness+// ---------------------------------------------------------------------------++function checkMarketplaceCompleteness() {+ const violations = [];+ if (!existsSync(PLUGINS_DIR) || !existsSync(MARKETPLACE_JSON)) return violations;++ const pluginDirs = readdirSync(PLUGINS_DIR, { withFileTypes: true })+ .filter((e) => e.isDirectory())+ .map((e) => e.name);++ const marketplaceSrc = readText(MARKETPLACE_JSON);+ let marketplace;+ try {+ marketplace = JSON.parse(marketplaceSrc);+ } catch (e) {+ violations.push({ file: rel(MARKETPLACE_JSON), message: `invalid JSON: ${e.message}` });+ return violations;+ }++ const registered = new Set(+ (marketplace.plugins || [])+ .map((p) => (typeof p.source === 'string' ? p.source.replace(/^\.\/plugins\//, '').replace(/\/$/, '') : null))+ .filter(Boolean)+ );++ for (const dir of pluginDirs) {+ if (!registered.has(dir)) {+ violations.push({+ file: `plugins/${dir}`,+ message: `directory has no entry in .claude-plugin/marketplace.json (plugin uninstallable via marketplace)`,+ });+ }+ }+ return violations;+}++// ---------------------------------------------------------------------------+// Run all checks+// ---------------------------------------------------------------------------++const scaffoldFiles = walkFiles(SCAFFOLD_DIR);++const results = [+ { id: 1, name: 'dead CLI invocation (npx claude-flow bare)', violations: checkDeadCliInvocations(scaffoldFiles) },+ { id: 2, name: 'dead MCP tool references (mcp__claude-flow__*)', violations: checkDeadToolReferences(scaffoldFiles) },+ { id: 3, name: 'plugin MCP-launch pinning regression', violations: checkPluginMcpPinning() },+ { id: 4, name: 'marketplace completeness', violations: checkMarketplaceCompleteness() },+];++const totalViolations = results.reduce((sum, r) => sum + r.violations.length, 0);++console.log(`init-scaffold-references: scanned ${scaffoldFiles.length} scaffold files, ` ++ `${LIVE_TOOL_NAMES.size} live MCP tools derived, canonical CLI form '${CANONICAL_CLI_INVOCATION}'`);+console.log(STRICT ? 'mode: --strict (blocking)' : 'mode: warn-only (pass --strict to block on violations)');+console.log();++for (const { id, name, violations } of results) {+ if (violations.length === 0) {+ console.log(`ok: check ${id} (${name}) β 0 violations`);+ continue;+ }+ console.log(`FAIL: check ${id} (${name}) β ${violations.length} violation(s)`);+ for (const v of violations) {+ if (v.line) {+ console.log(` ${v.file}:${v.line} ${v.text}`);+ console.log(` ${v.message}`);+ } else {+ console.log(` ${v.file}`);+ console.log(` ${v.message}`);+ }+ }+}++console.log();+console.log(`total: ${totalViolations} violation(s) across 4 checks`);+console.log('ADR-382: https://github.com/ruvnet/ruflo/blob/main/v3/docs/adr/ADR-382-init-scaffold-content-drift-remediation.md');+console.log('Issue: https://github.com/ruvnet/ruflo/issues/2971');++if (totalViolations > 0 && !STRICT) {+ console.log('\nwarn-only mode: exiting 0 despite violations above. Pass --strict to make this blocking.');+}++process.exit(totalViolations > 0 && STRICT ? 1 : 0);diff --git a/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md b/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.mdindex d8bd93617f..ac8c90c680 100644--- a/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md+++ b/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md@@ -75,7 +75,7 @@ hooks:# 4. Train neural patterns for high-quality reviewsif [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; thenecho "π§ Training neural pattern from successful code review"- npx claude-flow neural train \+ npx @claude-flow/cli@latest neural train \--pattern-type "coordination" \--training-data "$REVIEW_OUTPUT" \--epochs 50diff --git a/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md b/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.mdindex 10168208b6..0885870262 100644--- a/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md+++ b/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md@@ -79,7 +79,7 @@ hooks:# 4. Train neural patterns for successful issue managementif [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; thenecho "π§ Training neural pattern from successful issue management"- npx claude-flow neural train \+ npx @claude-flow/cli@latest neural train \--pattern-type "coordination" \--training-data "$ISSUE_OUTPUT" \--epochs 50diff --git a/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md b/v3/@claude-flow/cli/.claude/agents/github/pr-manager.mdindex 65dadbca2a..b43c12a623 100644--- a/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md+++ b/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md@@ -83,7 +83,7 @@ hooks:# 4. Train neural patterns for successful PRs (optional)if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; thenecho "π§ Training neural pattern from successful PR management"- npx claude-flow neural train \+ npx @claude-flow/cli@latest neural train \--pattern-type "coordination" \--training-data "$PR_OUTPUT" \--epochs 50diff --git a/v3/@claude-flow/cli/.claude/agents/github/release-manager.md b/v3/@claude-flow/cli/.claude/agents/github/release-manager.mdindex be50d51077..af4c1725f5 100644--- a/v3/@claude-flow/cli/.claude/agents/github/release-manager.md+++ b/v3/@claude-flow/cli/.claude/agents/github/release-manager.md@@ -72,7 +72,7 @@ hooks:# 3. Train neural patterns for successful releasesif [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; thenecho "π§ Training neural pattern from successful release"- npx claude-flow neural train \+ npx @claude-flow/cli@latest neural train \--pattern-type "coordination" \--training-data "$RELEASE_OUTPUT" \--epochs 50@@ -587,7 +587,7 @@ jobs:cd claude-code-flow/claude-code-flow && npm install && npm testcd ../../ruv-swarm/npm && npm install && npm test:all- name: Validate Release- run: npx claude-flow release validate+ run: npx @claude-flow/cli@latest release validate```## Monitoring and Metricsdiff --git a/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md b/v3/@claude-flow/cli/.claude/agents/github/repo-architect.mdindex 32e6619bc1..0501e3907a 100644--- a/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md+++ b/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md@@ -144,9 +144,9 @@ mcp__github__push_files {## Quick Start\`\`\`bash-npx claude-flow init --sparc+npx @claude-flow/cli@latest init --sparcnpm install-npx claude-flow start --ui+npx @claude-flow/cli@latest start --ui\`\`\`## Featuresdiff --git a/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md b/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.mdindex 3091519265..34230f8048 100644--- a/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md+++ b/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md@@ -83,7 +83,7 @@ hooks:# 4. Train neural patterns for successful workflowsif [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; thenecho "π§ Training neural pattern from successful workflow"- npx claude-flow neural train \+ npx @claude-flow/cli@latest neural train \--pattern-type "coordination" \--training-data "$WORKFLOW_OUTPUT" \--epochs 50diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md b/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.mdindex ea7dd580dd..bcf6dedd70 100644--- a/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md+++ b/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md@@ -577,31 +577,31 @@ const benchmarkIntegration = {### Benchmarking Commands```bash# Run comprehensive benchmark suite-npx claude-flow benchmark-run --suite comprehensive --duration 300+npx @claude-flow/cli@latest benchmark-run --suite comprehensive --duration 300# Execute specific benchmark-npx claude-flow benchmark-run --suite throughput --iterations 10+npx @claude-flow/cli@latest benchmark-run --suite throughput --iterations 10# Compare with baseline-npx claude-flow benchmark-compare --current <results> --baseline <baseline>+npx @claude-flow/cli@latest benchmark-compare --current <results> --baseline <baseline># Quality assessment-npx claude-flow quality-assess --target swarm-performance --criteria throughput,latency+npx @claude-flow/cli@latest quality-assess --target swarm-performance --criteria throughput,latency# Performance validation-npx claude-flow validate-performance --results <file> --criteria <file>+npx @claude-flow/cli@latest validate-performance --results <file> --criteria <file>```### Regression Detection Commands```bash# Detect performance regressions-npx claude-flow detect-regression --current <results> --historical <data>+npx @claude-flow/cli@latest detect-regression --current <results> --historical <data># Set up automated regression monitoring-npx claude-flow regression-monitor --enable --sensitivity 0.95+npx @claude-flow/cli@latest regression-monitor --enable --sensitivity 0.95# Analyze error patterns-npx claude-flow error-analysis --logs <log-files>+npx @claude-flow/cli@latest error-analysis --logs <log-files>```## Integration Pointsdiff --git a/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md b/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.mdindex 3d293384d9..ab95c77842 100644--- a/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md+++ b/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md@@ -353,28 +353,28 @@ class CircuitBreaker {### Load Balancing Commands```bash# Initialize load balancer-npx claude-flow agent spawn load-balancer --type coordinator+npx @claude-flow/cli@latest agent spawn load-balancer --type coordinator# Start load balancing-npx claude-flow load-balance --swarm-id <id> --strategy adaptive+npx @claude-flow/cli@latest load-balance --swarm-id <id> --strategy adaptive# Monitor load distribution-npx claude-flow agent-metrics --type load-balancer+npx @claude-flow/cli@latest agent-metrics --type load-balancer# Adjust balancing parameters-npx claude-flow config-manage --action update --config '{"stealThreshold": 5, "agingBoost": 10}'+npx @claude-flow/cli@latest config-manage --action update --config '{"stealThreshold": 5, "agingBoost": 10}'```### Performance Monitoring```bash# Real-time load monitoring-npx claude-flow performance-report --format detailed+npx @claude-flow/cli@latest performance-report --format detailed# Bottleneck analysis-npx claude-flow bottleneck-analyze --component swarm-coordination+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination# Resource utilization tracking-npx claude-flow metrics-collect --components ["load-balancer", "task-queue"]+npx @claude-flow/cli@latest metrics-collect --components ["load-balancer", "task-queue"]```## Integration Pointsdiff --git a/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md b/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.mdindex 0c4d233d3b..89ef394ec5 100644--- a/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md+++ b/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md@@ -582,31 +582,31 @@ class DashboardProvider {### Monitoring Commands```bash# Start comprehensive monitoring-npx claude-flow performance-report --format detailed --timeframe 24h+npx @claude-flow/cli@latest performance-report --format detailed --timeframe 24h# Real-time bottleneck analysis-npx claude-flow bottleneck-analyze --component swarm-coordination+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination# Health check all components-npx claude-flow health-check --components ["swarm", "agents", "coordination"]+npx @claude-flow/cli@latest health-check --components ["swarm", "agents", "coordination"]# Collect specific metrics-npx claude-flow metrics-collect --components ["cpu", "memory", "network"]+npx @claude-flow/cli@latest metrics-collect --components ["cpu", "memory", "network"]# Monitor SLA compliance-npx claude-flow sla-monitor --service swarm-coordination --threshold 99.9+npx @claude-flow/cli@latest sla-monitor --service swarm-coordination --threshold 99.9```### Alert Configuration```bash# Configure performance alerts-npx claude-flow alert-config --metric cpu_usage --threshold 80 --severity warning+npx @claude-flow/cli@latest alert-config --metric cpu_usage --threshold 80 --severity warning# Set up anomaly detection-npx claude-flow anomaly-setup --models ["statistical", "ml", "time_series"]+npx @claude-flow/cli@latest anomaly-setup --models ["statistical", "ml", "time_series"]# Configure notification channels-npx claude-flow notification-config --channels ["slack", "email", "webhook"]+npx @claude-flow/cli@latest notification-config --channels ["slack", "email", "webhook"]```## Integration Pointsdiff --git a/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md b/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.mdindex 5a5b5c688b..e56abfdf01 100644--- a/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md+++ b/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md@@ -600,34 +600,34 @@ const resourceIntegration = {### Resource Management Commands```bash# Analyze resource usage-npx claude-flow metrics-collect --components ["cpu", "memory", "network"]+npx @claude-flow/cli@latest metrics-collect --components ["cpu", "memory", "network"]# Optimize resource allocation-npx claude-flow daa-resource-alloc --resources <resource-config>+npx @claude-flow/cli@latest daa-resource-alloc --resources <resource-config># Predictive scaling-npx claude-flow swarm-scale --swarm-id <id> --target-size <size>+npx @claude-flow/cli@latest swarm-scale --swarm-id <id> --target-size <size># Performance profiling-npx claude-flow performance-report --format detailed --timeframe 24h+npx @claude-flow/cli@latest performance-report --format detailed --timeframe 24h# Circuit breaker configuration-npx claude-flow fault-tolerance --strategy circuit-breaker --config <config>+npx @claude-flow/cli@latest fault-tolerance --strategy circuit-breaker --config <config>```### Optimization Commands```bash# Run performance optimization-npx claude-flow optimize-performance --swarm-id <id> --strategy adaptive+npx @claude-flow/cli@latest optimize-performance --swarm-id <id> --strategy adaptive# Generate resource forecasts-npx claude-flow forecast-resources --time-horizon 3600 --confidence 0.95+npx @claude-flow/cli@latest forecast-resources --time-horizon 3600 --confidence 0.95# Profile system performance-npx claude-flow profile-performance --duration 60000 --components all+npx @claude-flow/cli@latest profile-performance --duration 60000 --components all# Analyze bottlenecks-npx claude-flow bottleneck-analyze --component swarm-coordination+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination```## Integration Pointsdiff --git a/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md b/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.mdindex 39721989b1..1fecb66aa9 100644--- a/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md+++ b/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md@@ -726,31 +726,31 @@ class SimulatedAnnealingOptimizer {### Topology Optimization Commands```bash# Analyze current topology-npx claude-flow topology-analyze --swarm-id <id> --metrics performance+npx @claude-flow/cli@latest topology-analyze --swarm-id <id> --metrics performance# Optimize topology automatically-npx claude-flow topology-optimize --swarm-id <id> --strategy adaptive+npx @claude-flow/cli@latest topology-optimize --swarm-id <id> --strategy adaptive# Compare topology configurations-npx claude-flow topology-compare --topologies ["hierarchical", "mesh", "hybrid"]+npx @claude-flow/cli@latest topology-compare --topologies ["hierarchical", "mesh", "hybrid"]# Generate topology recommendations-npx claude-flow topology-recommend --workload-profile <file> --constraints <file>+npx @claude-flow/cli@latest topology-recommend --workload-profile <file> --constraints <file># Monitor topology performance-npx claude-flow topology-monitor --swarm-id <id> --interval 60+npx @claude-flow/cli@latest topology-monitor --swarm-id <id> --interval 60```### Agent Placement Commands```bash# Optimize agent placement-npx claude-flow placement-optimize --algorithm genetic --agents <agent-list>+npx @claude-flow/cli@latest placement-optimize --algorithm genetic --agents <agent-list># Analyze placement efficiency-npx claude-flow placement-analyze --current-placement <config>+npx @claude-flow/cli@latest placement-analyze --current-placement <config># Generate placement recommendations-npx claude-flow placement-recommend --communication-patterns <file>+npx @claude-flow/cli@latest placement-recommend --communication-patterns <file>```## Integration Pointsdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/README.md b/v3/@claude-flow/cli/.claude/commands/agents/README.mdindex cf86089b5f..65352e61b6 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/README.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/README.md@@ -28,16 +28,16 @@ Complete agent management commands for Claude Flow V3.```bash# Spawn a coder agent-npx claude-flow agent spawn -t coder --name my-coder+npx @claude-flow/cli@latest agent spawn -t coder --name my-coder# List all active agents-npx claude-flow agent list+npx @claude-flow/cli@latest agent list# Check agent health-npx claude-flow agent health+npx @claude-flow/cli@latest agent health# View metrics-npx claude-flow agent metrics --period 24h+npx @claude-flow/cli@latest agent metrics --period 24h```## V3 Agent Categoriesdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.mdindex e8bb3eed7b..b857d9c035 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md@@ -105,7 +105,7 @@ release-manager: mcp__github__*, mcp__claude-flow__workflow_*```bash# List all capabilities for an agent type-npx claude-flow agent spawn -t coder --help+npx @claude-flow/cli@latest agent spawn -t coder --help# View agent definitioncat .claude/agents/core/coder.mddiff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.mdindex 704a6dc1e5..28dafb9ad4 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md@@ -7,19 +7,19 @@ Coordination patterns for multi-agent collaboration.### HierarchicalQueen-led with worker specialization```bash-npx claude-flow swarm init --topology hierarchical+npx @claude-flow/cli@latest swarm init --topology hierarchical```### MeshPeer-to-peer collaboration```bash-npx claude-flow swarm init --topology mesh+npx @claude-flow/cli@latest swarm init --topology mesh```### AdaptiveDynamic topology based on workload```bash-npx claude-flow swarm init --topology adaptive+npx @claude-flow/cli@latest swarm init --topology adaptive```## Best Practicesdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-types.mdindex 83c04307b7..27d1bf4e00 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md@@ -203,10 +203,10 @@ Complete guide to all 87 available agent types in Claude Flow V3.```bash# List all agent types-npx claude-flow agent spawn --help+npx @claude-flow/cli@latest agent spawn --help# Spawn any agent-npx claude-flow agent spawn -t <agent-type>+npx @claude-flow/cli@latest agent spawn -t <agent-type>```## See Alsodiff --git a/v3/@claude-flow/cli/.claude/commands/agents/health.md b/v3/@claude-flow/cli/.claude/commands/agents/health.mdindex 1794668d7f..9a1bc021e5 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/health.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/health.md@@ -11,7 +11,7 @@ Monitor agent health status, resource usage, and detect issues.## Usage```bash-npx claude-flow agent health [agent-id] [options]+npx @claude-flow/cli@latest agent health [agent-id] [options]```## Options@@ -26,19 +26,19 @@ npx claude-flow agent health [agent-id] [options]```bash# Overall health check-npx claude-flow agent health+npx @claude-flow/cli@latest agent health# Specific agent health-npx claude-flow agent health coder-lx7m9k2+npx @claude-flow/cli@latest agent health coder-lx7m9k2# Continuous monitoring-npx claude-flow agent health --watch+npx @claude-flow/cli@latest agent health --watch# Custom interval-npx claude-flow agent health -w -i 10+npx @claude-flow/cli@latest agent health -w -i 10# JSON output-npx claude-flow agent health --format json+npx @claude-flow/cli@latest agent health --format json```## Output@@ -99,7 +99,7 @@ RecommendationsContinuous monitoring with real-time updates:```bash-npx claude-flow agent health --watch+npx @claude-flow/cli@latest agent health --watch# Output updates every 5 seconds:# [10:30:15] Agent Health: 3 healthy, 0 warning, 0 critical@@ -134,6 +134,6 @@ Press `Ctrl+C` to stop watching.## Related Commands-- `npx claude-flow agent status` - Detailed agent info-- `npx claude-flow agent metrics` - Performance metrics-- `npx claude-flow doctor` - System-wide health+- `npx @claude-flow/cli@latest agent status` - Detailed agent info+- `npx @claude-flow/cli@latest agent metrics` - Performance metrics+- `npx @claude-flow/cli@latest doctor` - System-wide healthdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/list.md b/v3/@claude-flow/cli/.claude/commands/agents/list.mdindex 1ed7c0b20c..3bc507ce9e 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/list.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/list.md@@ -12,8 +12,8 @@ List all active agents in the Claude Flow system with filtering options.## Usage```bash-npx claude-flow agent list [options]-npx claude-flow agent ls [options] # Alias+npx @claude-flow/cli@latest agent list [options]+npx @claude-flow/cli@latest agent ls [options] # Alias```## Options@@ -29,22 +29,22 @@ npx claude-flow agent ls [options] # Alias```bash# List all active agents-npx claude-flow agent list+npx @claude-flow/cli@latest agent list# List all agents including inactive-npx claude-flow agent list --all+npx @claude-flow/cli@latest agent list --all# Filter by type-npx claude-flow agent list -t coder+npx @claude-flow/cli@latest agent list -t coder# Filter by status-npx claude-flow agent list -s idle+npx @claude-flow/cli@latest agent list -s idle# JSON output for scripting-npx claude-flow agent list --format json+npx @claude-flow/cli@latest agent list --format json# Combined filters-npx claude-flow agent list -t researcher -s active+npx @claude-flow/cli@latest agent list -t researcher -s active```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/logs.md b/v3/@claude-flow/cli/.claude/commands/agents/logs.mdindex e0a90b2819..6fb0274098 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/logs.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/logs.md@@ -11,7 +11,7 @@ View activity logs and history for agents.## Usage```bash-npx claude-flow agent logs <agent-id> [options]+npx @claude-flow/cli@latest agent logs <agent-id> [options]```## Options@@ -28,23 +28,23 @@ npx claude-flow agent logs <agent-id> [options]```bash# View last 50 lines-npx claude-flow agent logs coder-lx7m9k2+npx @claude-flow/cli@latest agent logs coder-lx7m9k2# View last 100 lines-npx claude-flow agent logs coder-lx7m9k2 -n 100+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 -n 100# Follow logs (live)-npx claude-flow agent logs coder-lx7m9k2 --follow+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --follow# Filter by level-npx claude-flow agent logs coder-lx7m9k2 -l error+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 -l error# Logs since time-npx claude-flow agent logs coder-lx7m9k2 --since "1h"-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "1h"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"# JSON output-npx claude-flow agent logs coder-lx7m9k2 --format json+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --format json```## Output@@ -77,7 +77,7 @@ Logs for coder-lx7m9k2Real-time log streaming:```bash-npx claude-flow agent logs coder-lx7m9k2 --follow+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --follow# New logs appear as they occur:# 2026-01-08 10:40:15 [INFO] Task received: refactor-auth@@ -91,16 +91,16 @@ Press `Ctrl+C` to stop following.```bash# Last hour-npx claude-flow agent logs coder-lx7m9k2 --since "1h"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "1h"# Last 30 minutes-npx claude-flow agent logs coder-lx7m9k2 --since "30m"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "30m"# Specific timestamp-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"# Today's logs-npx claude-flow agent logs coder-lx7m9k2 --since "today"+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "today"```## JSON Output@@ -125,6 +125,6 @@ npx claude-flow agent logs coder-lx7m9k2 --since "today"## Related Commands-- `npx claude-flow agent status` - Current agent status-- `npx claude-flow agent health` - Health monitoring-- `npx claude-flow agent metrics` - Performance metrics+- `npx @claude-flow/cli@latest agent status` - Current agent status+- `npx @claude-flow/cli@latest agent health` - Health monitoring+- `npx @claude-flow/cli@latest agent metrics` - Performance metricsdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/metrics.md b/v3/@claude-flow/cli/.claude/commands/agents/metrics.mdindex b923c07694..c761cd789a 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/metrics.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/metrics.md@@ -11,7 +11,7 @@ Display comprehensive performance metrics for agents including V3 performance ga## Usage```bash-npx claude-flow agent metrics [agent-id] [options]+npx @claude-flow/cli@latest agent metrics [agent-id] [options]```## Options@@ -25,19 +25,19 @@ npx claude-flow agent metrics [agent-id] [options]```bash# Overall metrics for last 24 hours-npx claude-flow agent metrics+npx @claude-flow/cli@latest agent metrics# Metrics for specific agent-npx claude-flow agent metrics coder-lx7m9k2+npx @claude-flow/cli@latest agent metrics coder-lx7m9k2# Last hour-npx claude-flow agent metrics -p 1h+npx @claude-flow/cli@latest agent metrics -p 1h# Last 7 days-npx claude-flow agent metrics --period 7d+npx @claude-flow/cli@latest agent metrics --period 7d# JSON output-npx claude-flow agent metrics --format json+npx @claude-flow/cli@latest agent metrics --format json```## Output@@ -117,6 +117,6 @@ V3 Performance Gains## Related Commands-- `npx claude-flow agent status` - Individual agent metrics-- `npx claude-flow performance benchmark` - Full performance suite-- `npx claude-flow status` - System-wide status+- `npx @claude-flow/cli@latest agent status` - Individual agent metrics+- `npx @claude-flow/cli@latest performance benchmark` - Full performance suite+- `npx @claude-flow/cli@latest status` - System-wide statusdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/pool.md b/v3/@claude-flow/cli/.claude/commands/agents/pool.mdindex 75ff21fbb1..9494759a9d 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/pool.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/pool.md@@ -11,7 +11,7 @@ Manage the agent pool for automatic scaling and resource optimization.## Usage```bash-npx claude-flow agent pool [options]+npx @claude-flow/cli@latest agent pool [options]```## Options@@ -28,19 +28,19 @@ npx claude-flow agent pool [options]```bash# View current pool status-npx claude-flow agent pool+npx @claude-flow/cli@latest agent pool# Set pool size-npx claude-flow agent pool --size 5+npx @claude-flow/cli@latest agent pool --size 5# Configure auto-scaling-npx claude-flow agent pool --min 2 --max 15 --auto-scale+npx @claude-flow/cli@latest agent pool --min 2 --max 15 --auto-scale# Pre-warm agents for fast response-npx claude-flow agent pool --warmup+npx @claude-flow/cli@latest agent pool --warmup# Disable auto-scaling-npx claude-flow agent pool --auto-scale false+npx @claude-flow/cli@latest agent pool --auto-scale false```## Output@@ -89,7 +89,7 @@ Auto-Scale RulesPre-warm agents to reduce cold-start latency:```bash-npx claude-flow agent pool --warmup+npx @claude-flow/cli@latest agent pool --warmup# Pre-warms default agent types:# - coder (2 instances)@@ -122,6 +122,6 @@ agent:## Related Commands-- `npx claude-flow agent spawn` - Manual agent spawning-- `npx claude-flow agent list` - View active agents-- `npx claude-flow swarm scale` - Swarm-level scaling+- `npx @claude-flow/cli@latest agent spawn` - Manual agent spawning+- `npx @claude-flow/cli@latest agent list` - View active agents+- `npx @claude-flow/cli@latest swarm scale` - Swarm-level scalingdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/spawn.md b/v3/@claude-flow/cli/.claude/commands/agents/spawn.mdindex 30b87d2cd9..361256549d 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/spawn.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/spawn.md@@ -11,7 +11,7 @@ Spawn a new agent with full V3 capabilities including neural patterns, memory in## Usage```bash-npx claude-flow agent spawn [options]+npx @claude-flow/cli@latest agent spawn [options]```## Options@@ -30,74 +30,74 @@ npx claude-flow agent spawn [options]### Core Development```bash-npx claude-flow agent spawn -t coder # Code implementation-npx claude-flow agent spawn -t reviewer # Code review-npx claude-flow agent spawn -t tester # Testing-npx claude-flow agent spawn -t planner # Planning-npx claude-flow agent spawn -t researcher # Research+npx @claude-flow/cli@latest agent spawn -t coder # Code implementation+npx @claude-flow/cli@latest agent spawn -t reviewer # Code review+npx @claude-flow/cli@latest agent spawn -t tester # Testing+npx @claude-flow/cli@latest agent spawn -t planner # Planning+npx @claude-flow/cli@latest agent spawn -t researcher # Research```### V3 Specialized```bash-npx claude-flow agent spawn -t security-architect # Security design-npx claude-flow agent spawn -t security-auditor # CVE remediation-npx claude-flow agent spawn -t memory-specialist # AgentDB (150x-12,500x faster)-npx claude-flow agent spawn -t performance-engineer # 2.49x-7.47x optimization-npx claude-flow agent spawn -t core-architect # DDD design+npx @claude-flow/cli@latest agent spawn -t security-architect # Security design+npx @claude-flow/cli@latest agent spawn -t security-auditor # CVE remediation+npx @claude-flow/cli@latest agent spawn -t memory-specialist # AgentDB (150x-12,500x faster)+npx @claude-flow/cli@latest agent spawn -t performance-engineer # 2.49x-7.47x optimization+npx @claude-flow/cli@latest agent spawn -t core-architect # DDD design```### Swarm Coordination```bash-npx claude-flow agent spawn -t hierarchical-coordinator # Queen-led-npx claude-flow agent spawn -t mesh-coordinator # P2P network-npx claude-flow agent spawn -t adaptive-coordinator # Dynamic topology-npx claude-flow agent spawn -t collective-intelligence-coordinator+npx @claude-flow/cli@latest agent spawn -t hierarchical-coordinator # Queen-led+npx @claude-flow/cli@latest agent spawn -t mesh-coordinator # P2P network+npx @claude-flow/cli@latest agent spawn -t adaptive-coordinator # Dynamic topology+npx @claude-flow/cli@latest agent spawn -t collective-intelligence-coordinator```### Consensus Agents```bash-npx claude-flow agent spawn -t byzantine-coordinator # BFT consensus-npx claude-flow agent spawn -t raft-manager # Leader-based-npx claude-flow agent spawn -t gossip-coordinator # Eventual consistency-npx claude-flow agent spawn -t crdt-synchronizer # CRDT replication-npx claude-flow agent spawn -t quorum-manager # Quorum-based+npx @claude-flow/cli@latest agent spawn -t byzantine-coordinator # BFT consensus+npx @claude-flow/cli@latest agent spawn -t raft-manager # Leader-based+npx @claude-flow/cli@latest agent spawn -t gossip-coordinator # Eventual consistency+npx @claude-flow/cli@latest agent spawn -t crdt-synchronizer # CRDT replication+npx @claude-flow/cli@latest agent spawn -t quorum-manager # Quorum-based```### GitHub Integration```bash-npx claude-flow agent spawn -t pr-manager # PR lifecycle-npx claude-flow agent spawn -t code-review-swarm # Multi-agent review-npx claude-flow agent spawn -t issue-tracker # Issue management-npx claude-flow agent spawn -t release-manager # Release coordination-npx claude-flow agent spawn -t workflow-automation # CI/CD automation+npx @claude-flow/cli@latest agent spawn -t pr-manager # PR lifecycle+npx @claude-flow/cli@latest agent spawn -t code-review-swarm # Multi-agent review+npx @claude-flow/cli@latest agent spawn -t issue-tracker # Issue management+npx @claude-flow/cli@latest agent spawn -t release-manager # Release coordination+npx @claude-flow/cli@latest agent spawn -t workflow-automation # CI/CD automation```### SPARC Methodology```bash-npx claude-flow agent spawn -t sparc-coordinator # SPARC orchestration-npx claude-flow agent spawn -t specification # Requirements-npx claude-flow agent spawn -t pseudocode # Algorithm design-npx claude-flow agent spawn -t architecture # System design-npx claude-flow agent spawn -t refinement # Iterative improvement+npx @claude-flow/cli@latest agent spawn -t sparc-coordinator # SPARC orchestration+npx @claude-flow/cli@latest agent spawn -t specification # Requirements+npx @claude-flow/cli@latest agent spawn -t pseudocode # Algorithm design+npx @claude-flow/cli@latest agent spawn -t architecture # System design+npx @claude-flow/cli@latest agent spawn -t refinement # Iterative improvement```## Examples```bash# Spawn with custom name-npx claude-flow agent spawn -t coder --name feature-bot+npx @claude-flow/cli@latest agent spawn -t coder --name feature-bot# Spawn with initial task-npx claude-flow agent spawn -t researcher --task "Research React 19 features"+npx @claude-flow/cli@latest agent spawn -t researcher --task "Research React 19 features"# Spawn with specific model-npx claude-flow agent spawn -t architect -m claude-3-opus-20240229+npx @claude-flow/cli@latest agent spawn -t architect -m claude-3-opus-20240229# Spawn with custom timeout-npx claude-flow agent spawn -t tester --timeout 600+npx @claude-flow/cli@latest agent spawn -t tester --timeout 600# Spawn using OpenRouter-npx claude-flow agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet+npx @claude-flow/cli@latest agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet```## Using Claude Code's Task Tooldiff --git a/v3/@claude-flow/cli/.claude/commands/agents/status.md b/v3/@claude-flow/cli/.claude/commands/agents/status.mdindex fc4804c29e..7ab66db6c7 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/status.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/status.md@@ -11,8 +11,8 @@ Display comprehensive status information for a specific agent including metrics,## Usage```bash-npx claude-flow agent status <agent-id>-npx claude-flow agent status --id <agent-id>+npx @claude-flow/cli@latest agent status <agent-id>+npx @claude-flow/cli@latest agent status --id <agent-id>```## Options@@ -26,13 +26,13 @@ npx claude-flow agent status --id <agent-id>```bash# Get status by ID-npx claude-flow agent status coder-lx7m9k2+npx @claude-flow/cli@latest agent status coder-lx7m9k2# Using --id flag-npx claude-flow agent status --id researcher-abc123+npx @claude-flow/cli@latest agent status --id researcher-abc123# JSON output-npx claude-flow agent status coder-lx7m9k2 --format json+npx @claude-flow/cli@latest agent status coder-lx7m9k2 --format json```## Output@@ -109,7 +109,7 @@ The status command provides:## Related Commands-- `npx claude-flow agent list` - Find agent IDs-- `npx claude-flow agent metrics` - Aggregate metrics-- `npx claude-flow agent health` - Health check-- `npx claude-flow agent logs <id>` - Activity logs+- `npx @claude-flow/cli@latest agent list` - Find agent IDs+- `npx @claude-flow/cli@latest agent metrics` - Aggregate metrics+- `npx @claude-flow/cli@latest agent health` - Health check+- `npx @claude-flow/cli@latest agent logs <id>` - Activity logsdiff --git a/v3/@claude-flow/cli/.claude/commands/agents/stop.md b/v3/@claude-flow/cli/.claude/commands/agents/stop.mdindex a590840fc3..10c6157078 100644--- a/v3/@claude-flow/cli/.claude/commands/agents/stop.md+++ b/v3/@claude-flow/cli/.claude/commands/agents/stop.md@@ -12,8 +12,8 @@ Stop a running agent with graceful or forced shutdown options.## Usage```bash-npx claude-flow agent stop <agent-id> [options]-npx claude-flow agent kill <agent-id> [options] # Alias+npx @claude-flow/cli@latest agent stop <agent-id> [options]+npx @claude-flow/cli@latest agent kill <agent-id> [options] # Alias```## Options@@ -27,16 +27,16 @@ npx claude-flow agent kill <agent-id> [options] # Alias```bash# Graceful stop (completes current task)-npx claude-flow agent stop coder-lx7m9k2+npx @claude-flow/cli@latest agent stop coder-lx7m9k2# Force stop (immediate termination)-npx claude-flow agent stop coder-lx7m9k2 --force+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force# Custom shutdown timeout-npx claude-flow agent stop coder-lx7m9k2 --timeout 60+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --timeout 60# Using kill alias-npx claude-flow agent kill researcher-abc123 -f+npx @claude-flow/cli@latest agent kill researcher-abc123 -f```## Graceful vs Force Stop@@ -48,7 +48,7 @@ npx claude-flow agent kill researcher-abc123 -f4. Notifies swarm coordinator```bash-npx claude-flow agent stop coder-lx7m9k2+npx @claude-flow/cli@latest agent stop coder-lx7m9k2# Output:# Stopping agent coder-lx7m9k2...@@ -64,7 +64,7 @@ npx claude-flow agent stop coder-lx7m9k23. May leave tasks incomplete```bash-npx claude-flow agent stop coder-lx7m9k2 --force+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force# Output:# Stopping agent coder-lx7m9k2...@@ -85,18 +85,18 @@ To stop multiple agents:```bash# Stop all agents of a type-npx claude-flow agent list -t coder --format json | \+npx @claude-flow/cli@latest agent list -t coder --format json | \jq -r '.agents[].id' | \- xargs -I {} npx claude-flow agent stop {} -f+ xargs -I {} npx @claude-flow/cli@latest agent stop {} -f# Stop all idle agents-npx claude-flow agent list -s idle --format json | \+npx @claude-flow/cli@latest agent list -s idle --format json | \jq -r '.agents[].id' | \- xargs -I {} npx claude-flow agent stop {}+ xargs -I {} npx @claude-flow/cli@latest agent stop {}```## Related Commands-- `npx claude-flow agent list` - Find agent IDs-- `npx claude-flow agent status` - Check status before stopping-- `npx claude-flow swarm destroy` - Stop all agents in swarm+- `npx @claude-flow/cli@latest agent list` - Find agent IDs+- `npx @claude-flow/cli@latest agent status` - Check status before stopping+- `npx @claude-flow/cli@latest swarm destroy` - Stop all agents in swarmdiff --git a/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md b/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.mdindex 79ab8bea35..b601da9ccd 100644--- a/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md+++ b/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md@@ -3,7 +3,7 @@## OverviewReviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:- `mcp__claude-flow__*` tools (preferred)-- `npx claude-flow` commands (as fallback)+- `npx @claude-flow/cli@latest` commands (as fallback)- No direct implementation calls## Files Revieweddiff --git a/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md b/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.mdindex 85c8595eb6..d584fcfc50 100644--- a/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md+++ b/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md@@ -5,7 +5,7 @@ Analyze performance bottlenecks in swarm operations and suggest optimizations.## Usage```bash-npx claude-flow bottleneck detect [options]+npx @claude-flow/cli@latest bottleneck detect [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow bottleneck detect [options]### Basic bottleneck detection```bash-npx claude-flow bottleneck detect+npx @claude-flow/cli@latest bottleneck detect```### Analyze specific swarm```bash-npx claude-flow bottleneck detect --swarm-id swarm-123+npx @claude-flow/cli@latest bottleneck detect --swarm-id swarm-123```### Last 24 hours with export```bash-npx claude-flow bottleneck detect -t 24h -e bottlenecks.json+npx @claude-flow/cli@latest bottleneck detect -t 24h -e bottlenecks.json```### Auto-fix detected issues```bash-npx claude-flow bottleneck detect --fix --threshold 15+npx @claude-flow/cli@latest bottleneck detect --fix --threshold 15```## Metrics Analyzeddiff --git a/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md b/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.mdindex 04b8d9e9ac..8a4a136922 100644--- a/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md+++ b/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md@@ -4,7 +4,7 @@ Generate comprehensive performance reports for swarm operations.## Usage```bash-npx claude-flow analysis performance-report [options]+npx @claude-flow/cli@latest analysis performance-report [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow analysis performance-report [options]## Examples```bash# Generate HTML report-npx claude-flow analysis performance-report --format html+npx @claude-flow/cli@latest analysis performance-report --format html# Compare swarms-npx claude-flow analysis performance-report --compare swarm-123+npx @claude-flow/cli@latest analysis performance-report --compare swarm-123# Full metrics report-npx claude-flow analysis performance-report --include-metrics --format markdown+npx @claude-flow/cli@latest analysis performance-report --include-metrics --format markdown```diff --git a/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md b/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.mdindex 5d6f2b9cff..a6a90d80b4 100644--- a/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md+++ b/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md@@ -4,7 +4,7 @@ Analyze token usage patterns and optimize for efficiency.## Usage```bash-npx claude-flow analysis token-usage [options]+npx @claude-flow/cli@latest analysis token-usage [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow analysis token-usage [options]## Examples```bash# Last 24 hours token usage-npx claude-flow analysis token-usage --period 24h+npx @claude-flow/cli@latest analysis token-usage --period 24h# By agent breakdown-npx claude-flow analysis token-usage --by-agent+npx @claude-flow/cli@latest analysis token-usage --by-agent# Export detailed report-npx claude-flow analysis token-usage --period 7d --export tokens.csv+npx @claude-flow/cli@latest analysis token-usage --period 7d --export tokens.csv```diff --git a/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md b/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.mdindex d064e6f4c5..2ed2ac4ee6 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md@@ -5,7 +5,7 @@ Automatically spawn and manage agents based on task requirements.## Usage```bash-npx claude-flow auto agent [options]+npx @claude-flow/cli@latest auto agent [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow auto agent [options]### Basic auto-spawning```bash-npx claude-flow auto agent --task "Build a REST API with authentication"+npx @claude-flow/cli@latest auto agent --task "Build a REST API with authentication"```### Constrained spawning```bash-npx claude-flow auto agent -t "Debug performance issue" --max-agents 3+npx @claude-flow/cli@latest auto agent -t "Debug performance issue" --max-agents 3```### Analysis only```bash-npx claude-flow auto agent -t "Refactor codebase" --no-spawn+npx @claude-flow/cli@latest auto agent -t "Refactor codebase" --no-spawn```### Minimal strategy```bash-npx claude-flow auto agent -t "Fix bug in login" -s minimal+npx @claude-flow/cli@latest auto agent -t "Fix bug in login" -s minimal```## How It Worksdiff --git a/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md b/v3/@claude-flow/cli/.claude/commands/automation/self-healing.mdindex db86b6dca9..aee0b95d55 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md@@ -94,7 +94,7 @@ mcp__claude-flow__task_orchestrate({{"PostToolUse": [{"matcher": "^Bash$",- "command": "npx claude-flow hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"+ "command": "npx @claude-flow/cli@latest hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"}]}```diff --git a/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md b/v3/@claude-flow/cli/.claude/commands/automation/session-memory.mdindex f556e7fec1..ad68611a39 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md@@ -30,7 +30,7 @@ mcp__claude-flow__context_restore({**Fallback with npx:**```bash-npx claude-flow hook session-restore --session-id "sess-123"+npx @claude-flow/cli@latest hook session-restore --session-id "sess-123"```### 3. Memory Typesdiff --git a/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md b/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.mdindex 8960ab201e..de3c67c53e 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md@@ -63,7 +63,7 @@ mcp__claude-flow__agent_spawn({### Fallback ConfigurationIf MCP tools are unavailable:```bash-npx claude-flow hook pre-task --auto-spawn-agents+npx @claude-flow/cli@latest hook pre-task --auto-spawn-agents```## Benefitsdiff --git a/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md b/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.mdindex f78c2a9c19..efdb681a64 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md@@ -4,7 +4,7 @@ Intelligently spawn agents based on workload analysis.## Usage```bash-npx claude-flow automation smart-spawn [options]+npx @claude-flow/cli@latest automation smart-spawn [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow automation smart-spawn [options]## Examples```bash# Smart spawn with analysis-npx claude-flow automation smart-spawn --analyze+npx @claude-flow/cli@latest automation smart-spawn --analyze# Set spawn threshold-npx claude-flow automation smart-spawn --threshold 5+npx @claude-flow/cli@latest automation smart-spawn --threshold 5# Force topology-npx claude-flow automation smart-spawn --topology hierarchical+npx @claude-flow/cli@latest automation smart-spawn --topology hierarchical```diff --git a/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md b/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.mdindex 9ae59a70ef..2c3a6bda07 100644--- a/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md+++ b/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md@@ -4,7 +4,7 @@ Automatically select optimal workflow based on task type.## Usage```bash-npx claude-flow automation workflow-select [options]+npx @claude-flow/cli@latest automation workflow-select [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow automation workflow-select [options]## Examples```bash# Select workflow for task-npx claude-flow automation workflow-select --task "Deploy to production"+npx @claude-flow/cli@latest automation workflow-select --task "Deploy to production"# With constraints-npx claude-flow automation workflow-select --constraints "no-downtime,rollback"+npx @claude-flow/cli@latest automation workflow-select --constraints "no-downtime,rollback"# Preview mode-npx claude-flow automation workflow-select --task "Database migration" --preview+npx @claude-flow/cli@latest automation workflow-select --task "Database migration" --preview```diff --git a/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md b/v3/@claude-flow/cli/.claude/commands/claude-flow-help.mdindex 8f500b337b..8f81c6d2f6 100644--- a/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md+++ b/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md@@ -91,7 +91,7 @@ npx -y claude-flow@latest init --sparc```## π― Best Practices-- Use `./claude-flow` instead of `npx claude-flow` after initialization+- Use `./claude-flow` instead of `npx @claude-flow/cli@latest` after initialization- Store important context in memory for cross-session persistence- Use swarm mode for complex tasks requiring multiple agents- Enable monitoring for real-time progress trackingdiff --git a/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md b/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.mdindex d018805a4b..bd2d37f1a9 100644--- a/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md+++ b/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md@@ -4,7 +4,7 @@ Spawn a new agent in the current swarm.## Usage```bash-npx claude-flow agent spawn [options]+npx @claude-flow/cli@latest agent spawn [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow agent spawn [options]## Examples```bash# Spawn coder agent-npx claude-flow agent spawn --type coder+npx @claude-flow/cli@latest agent spawn --type coder# With custom name-npx claude-flow agent spawn --type researcher --name "API Expert"+npx @claude-flow/cli@latest agent spawn --type researcher --name "API Expert"# With specific skills-npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"+npx @claude-flow/cli@latest agent spawn --type coder --skills "python,fastapi,testing"```diff --git a/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md b/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.mdindex d4019791e8..4b0068e45c 100644--- a/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md+++ b/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md@@ -5,7 +5,7 @@ Initialize a Claude Flow swarm with specified topology and configuration.## Usage```bash-npx claude-flow swarm init [options]+npx @claude-flow/cli@latest swarm init [options]```## Options@@ -22,25 +22,25 @@ npx claude-flow swarm init [options]### Basic initialization```bash-npx claude-flow swarm init+npx @claude-flow/cli@latest swarm init```### Mesh topology for research```bash-npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced+npx @claude-flow/cli@latest swarm init --topology mesh --max-agents 5 --strategy balanced```### Hierarchical for development```bash-npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn```### GitHub-focused swarm```bash-npx claude-flow swarm init --topology star --github --memory+npx @claude-flow/cli@latest swarm init --topology star --github --memory```## Topologiesdiff --git a/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md b/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.mdindex 3788b816aa..71673cfd0a 100644--- a/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md+++ b/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md@@ -4,7 +4,7 @@ Orchestrate complex tasks across the swarm.## Usage```bash-npx claude-flow task orchestrate [options]+npx @claude-flow/cli@latest task orchestrate [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow task orchestrate [options]## Examples```bash# Orchestrate development task-npx claude-flow task orchestrate --task "Implement user authentication"+npx @claude-flow/cli@latest task orchestrate --task "Implement user authentication"# High priority task-npx claude-flow task orchestrate --task "Fix production bug" --priority critical+npx @claude-flow/cli@latest task orchestrate --task "Fix production bug" --priority critical# With specific strategy-npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel+npx @claude-flow/cli@latest task orchestrate --task "Refactor codebase" --strategy parallel```diff --git a/v3/@claude-flow/cli/.claude/commands/github/code-review.md b/v3/@claude-flow/cli/.claude/commands/github/code-review.mdindex 58bede9e2f..68e72dfad2 100644--- a/v3/@claude-flow/cli/.claude/commands/github/code-review.md+++ b/v3/@claude-flow/cli/.claude/commands/github/code-review.md@@ -4,7 +4,7 @@ Automated code review with swarm intelligence.## Usage```bash-npx claude-flow github code-review [options]+npx @claude-flow/cli@latest github code-review [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow github code-review [options]## Examples```bash# Review PR-npx claude-flow github code-review --pr-number 456+npx @claude-flow/cli@latest github code-review --pr-number 456# Security focus-npx claude-flow github code-review --pr-number 456 --focus security+npx @claude-flow/cli@latest github code-review --pr-number 456 --focus security# With fix suggestions-npx claude-flow github code-review --pr-number 456 --suggest-fixes+npx @claude-flow/cli@latest github code-review --pr-number 456 --suggest-fixes```diff --git a/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md b/v3/@claude-flow/cli/.claude/commands/github/github-swarm.mdindex 776ee9a879..6d032b5598 100644--- a/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md+++ b/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md@@ -5,7 +5,7 @@ Create a specialized swarm for GitHub repository management.## Usage```bash-npx claude-flow github swarm [options]+npx @claude-flow/cli@latest github swarm [options]```## Options@@ -22,25 +22,25 @@ npx claude-flow github swarm [options]### Basic GitHub swarm```bash-npx claude-flow github swarm --repository owner/repo+npx @claude-flow/cli@latest github swarm --repository owner/repo```### Maintenance-focused swarm```bash-npx claude-flow github swarm -r owner/repo -f maintenance --issue-labels+npx @claude-flow/cli@latest github swarm -r owner/repo -f maintenance --issue-labels```### Development swarm with PR automation```bash-npx claude-flow github swarm -r owner/repo -f development --auto-pr --code-review+npx @claude-flow/cli@latest github swarm -r owner/repo -f development --auto-pr --code-review```### Full-featured triage swarm```bash-npx claude-flow github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr+npx @claude-flow/cli@latest github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr```## Agent Typesdiff --git a/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md b/v3/@claude-flow/cli/.claude/commands/github/issue-triage.mdindex 5d98773f02..11dbf6e202 100644--- a/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md+++ b/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md@@ -4,7 +4,7 @@ Intelligent issue classification and triage.## Usage```bash-npx claude-flow github issue-triage [options]+npx @claude-flow/cli@latest github issue-triage [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow github issue-triage [options]## Examples```bash# Triage issues-npx claude-flow github issue-triage --repository myorg/myrepo+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo# With auto-labeling-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo --auto-label# Full automation-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label --assign+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo --auto-label --assign```diff --git a/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md b/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.mdindex 3ceb3f3289..733b486d28 100644--- a/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md+++ b/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md@@ -4,7 +4,7 @@ AI-powered pull request enhancements.## Usage```bash-npx claude-flow github pr-enhance [options]+npx @claude-flow/cli@latest github pr-enhance [options]```## Options@@ -16,11 +16,11 @@ npx claude-flow github pr-enhance [options]## Examples```bash# Enhance PR-npx claude-flow github pr-enhance --pr-number 123+npx @claude-flow/cli@latest github pr-enhance --pr-number 123# Add tests-npx claude-flow github pr-enhance --pr-number 123 --add-tests+npx @claude-flow/cli@latest github pr-enhance --pr-number 123 --add-tests# Full enhancement-npx claude-flow github pr-enhance --pr-number 123 --add-tests --improve-docs+npx @claude-flow/cli@latest github pr-enhance --pr-number 123 --add-tests --improve-docs```diff --git a/v3/@claude-flow/cli/.claude/commands/github/release-manager.md b/v3/@claude-flow/cli/.claude/commands/github/release-manager.mdindex 8038920b26..530fd91ac5 100644--- a/v3/@claude-flow/cli/.claude/commands/github/release-manager.md+++ b/v3/@claude-flow/cli/.claude/commands/github/release-manager.md@@ -322,7 +322,7 @@ jobs:cd claude-code-flow/claude-code-flow && npm install && npm testcd ../../ruv-swarm/npm && npm install && npm test:all- name: Validate Release- run: npx claude-flow release validate+ run: npx @claude-flow/cli@latest release validate```## Monitoring and Metricsdiff --git a/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md b/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.mdindex 167f5b47ab..bf1bcfce89 100644--- a/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md+++ b/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md@@ -4,7 +4,7 @@ Deep analysis of GitHub repository with AI insights.## Usage```bash-npx claude-flow github repo-analyze [options]+npx @claude-flow/cli@latest github repo-analyze [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow github repo-analyze [options]## Examples```bash# Basic analysis-npx claude-flow github repo-analyze --repository myorg/myrepo+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo# Deep analysis-npx claude-flow github repo-analyze --repository myorg/myrepo --deep+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo --deep# Specific areas-npx claude-flow github repo-analyze --repository myorg/myrepo --include issues,prs+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo --include issues,prs```diff --git a/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md b/v3/@claude-flow/cli/.claude/commands/github/repo-architect.mdindex bff58985bb..ea30c88edd 100644--- a/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md+++ b/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md@@ -113,9 +113,9 @@ mcp__github__push_files {## Quick Start\`\`\`bash-npx claude-flow init --sparc+npx @claude-flow/cli@latest init --sparcnpm install-npx claude-flow start --ui+npx @claude-flow/cli@latest start --ui\`\`\`## Featuresdiff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.mdindex 846cbe371f..28254885c9 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-consensus in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-consensus [options]+npx @claude-flow/cli@latest hive-mind hive-mind-consensus [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.mdindex cdf319c030..8a6b31b804 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md@@ -4,7 +4,7 @@ Initialize the Hive Mind collective intelligence system.## Usage```bash-npx claude-flow hive-mind init [options]+npx @claude-flow/cli@latest hive-mind init [options]```## Options@@ -13,6 +13,6 @@ npx claude-flow hive-mind init [options]## Examples```bash-npx claude-flow hive-mind init-npx claude-flow hive-mind init --force+npx @claude-flow/cli@latest hive-mind init+npx @claude-flow/cli@latest hive-mind init --force```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.mdindex d4c926394d..401544e365 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-memory in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-memory [options]+npx @claude-flow/cli@latest hive-mind hive-mind-memory [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.mdindex 7c83ddb666..f618d88974 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-metrics in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-metrics [options]+npx @claude-flow/cli@latest hive-mind hive-mind-metrics [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.mdindex 999c924c70..6668e04e85 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-resume in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-resume [options]+npx @claude-flow/cli@latest hive-mind hive-mind-resume [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.mdindex d0e2ea6797..06eb8ad3d7 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-sessions in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-sessions [options]+npx @claude-flow/cli@latest hive-mind hive-mind-sessions [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.mdindex a3bded7dff..0ff58ea7ff 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md@@ -4,7 +4,7 @@ Spawn a Hive Mind swarm with queen-led coordination.## Usage```bash-npx claude-flow hive-mind spawn <objective> [options]+npx @claude-flow/cli@latest hive-mind spawn <objective> [options]```## Options@@ -15,7 +15,7 @@ npx claude-flow hive-mind spawn <objective> [options]## Examples```bash-npx claude-flow hive-mind spawn "Build API"-npx claude-flow hive-mind spawn "Research patterns" --queen-type adaptive-npx claude-flow hive-mind spawn "Build service" --claude+npx @claude-flow/cli@latest hive-mind spawn "Build API"+npx @claude-flow/cli@latest hive-mind spawn "Research patterns" --queen-type adaptive+npx @claude-flow/cli@latest hive-mind spawn "Build service" --claude```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.mdindex 77853e139c..f2b5e7530c 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-status in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-status [options]+npx @claude-flow/cli@latest hive-mind hive-mind-status [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.mdindex d34d01f273..92d8832ab6 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-stop in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-stop [options]+npx @claude-flow/cli@latest hive-mind hive-mind-stop [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.mdindex af47456256..d2c8506ad2 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md@@ -4,5 +4,5 @@ Command documentation for hive-mind-wizard in category hive-mind.Usage:```bash-npx claude-flow hive-mind hive-mind-wizard [options]+npx @claude-flow/cli@latest hive-mind hive-mind-wizard [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.mdindex 1a860e32fa..36d70c8088 100644--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md@@ -4,7 +4,7 @@ Hive Mind collective intelligence system for advanced swarm coordination.## Usage```bash-npx claude-flow hive-mind [subcommand] [options]+npx @claude-flow/cli@latest hive-mind [subcommand] [options]```## Subcommands@@ -17,11 +17,11 @@ npx claude-flow hive-mind [subcommand] [options]## Examples```bash# Initialize hive mind-npx claude-flow hive-mind init+npx @claude-flow/cli@latest hive-mind init# Spawn swarm-npx claude-flow hive-mind spawn "Build microservices"+npx @claude-flow/cli@latest hive-mind spawn "Build microservices"# Check status-npx claude-flow hive-mind status+npx @claude-flow/cli@latest hive-mind status```diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/overview.md b/v3/@claude-flow/cli/.claude/commands/hooks/overview.mdindex 46a7e1cd27..0675e1b614 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/overview.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/overview.md@@ -37,7 +37,7 @@ Hooks are configured in `.claude/settings.json`:"matcher": "^(Write|Edit|MultiEdit)$","hooks": [{"type": "command",- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}'"+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}'"}]}]diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md b/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.mdindex a5a73f94bc..421004e9a1 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md@@ -5,7 +5,7 @@ Execute post-edit processing including formatting, validation, and memory update## Usage```bash-npx claude-flow hook post-edit [options]+npx @claude-flow/cli@latest hook post-edit [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow hook post-edit [options]### Basic post-edit hook```bash-npx claude-flow hook post-edit --file "src/components/Button.jsx"+npx @claude-flow/cli@latest hook post-edit --file "src/components/Button.jsx"```### With memory storage```bash-npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"+npx @claude-flow/cli@latest hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"```### Format and validate```bash-npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output+npx @claude-flow/cli@latest hook post-edit -f "config/webpack.js" --auto-format --validate-output```### Neural training```bash-npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"+npx @claude-flow/cli@latest hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"```## Features@@ -86,7 +86,7 @@ Manual usage in agents:```bash# After editing files-npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"+npx @claude-flow/cli@latest hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md b/v3/@claude-flow/cli/.claude/commands/hooks/post-task.mdindex 3140149a78..bfc9f32fa6 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md@@ -5,7 +5,7 @@ Execute post-task cleanup, performance analysis, and memory storage.## Usage```bash-npx claude-flow hook post-task [options]+npx @claude-flow/cli@latest hook post-task [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow hook post-task [options]### Basic post-task hook```bash-npx claude-flow hook post-task --task-id "auth-implementation"+npx @claude-flow/cli@latest hook post-task --task-id "auth-implementation"```### With full analysis```bash-npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report+npx @claude-flow/cli@latest hook post-task -t "api-refactor" --analyze-performance --generate-report```### Memory storage```bash-npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings+npx @claude-flow/cli@latest hook post-task -t "bug-fix-123" --store-decisions --export-learnings```### Quick cleanup```bash-npx claude-flow hook post-task -t "minor-update" --analyze-performance false+npx @claude-flow/cli@latest hook post-task -t "minor-update" --analyze-performance false```## Features@@ -85,7 +85,7 @@ Manual usage in agents:```bash# In agent coordination-npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true+npx @claude-flow/cli@latest hook post-task --task-id "your-task-id" --analyze-performance true```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md b/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.mdindex d7744c5759..efe2a8dfee 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md@@ -5,7 +5,7 @@ Execute pre-edit validations and agent assignment before file modifications.## Usage```bash-npx claude-flow hook pre-edit [options]+npx @claude-flow/cli@latest hook pre-edit [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow hook pre-edit [options]### Basic pre-edit hook```bash-npx claude-flow hook pre-edit --file "src/auth/login.js"+npx @claude-flow/cli@latest hook pre-edit --file "src/auth/login.js"```### With validation```bash-npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax+npx @claude-flow/cli@latest hook pre-edit -f "config/database.js" --validate-syntax```### Manual agent assignment```bash-npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false+npx @claude-flow/cli@latest hook pre-edit -f "api/users.ts" --auto-assign-agent false```### Safe editing with backup```bash-npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts+npx @claude-flow/cli@latest hook pre-edit -f "production.env" --backup-file --check-conflicts```## Features@@ -86,7 +86,7 @@ Manual usage in agents:```bash# Before editing files-npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax+npx @claude-flow/cli@latest hook pre-edit --file "path/to/file.js" --validate-syntax```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md b/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.mdindex b2f3f5e9f2..db5d928deb 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md@@ -5,7 +5,7 @@ Execute pre-task preparations and context loading.## Usage```bash-npx claude-flow hook pre-task [options]+npx @claude-flow/cli@latest hook pre-task [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow hook pre-task [options]### Basic pre-task hook```bash-npx claude-flow hook pre-task --description "Implement user authentication"+npx @claude-flow/cli@latest hook pre-task --description "Implement user authentication"```### With memory loading```bash-npx claude-flow hook pre-task -d "Continue API development" --load-memory+npx @claude-flow/cli@latest hook pre-task -d "Continue API development" --load-memory```### Manual agent control```bash-npx claude-flow hook pre-task -d "Debug issue #123" --auto-spawn-agents false+npx @claude-flow/cli@latest hook pre-task -d "Debug issue #123" --auto-spawn-agents false```### Full optimization```bash-npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity+npx @claude-flow/cli@latest hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity```## Features@@ -85,7 +85,7 @@ Manual usage in agents:```bash# In agent coordination-npx claude-flow hook pre-task --description "Your task here"+npx @claude-flow/cli@latest hook pre-task --description "Your task here"```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md b/v3/@claude-flow/cli/.claude/commands/hooks/session-end.mdindex 9f164e1b49..84cd8a0777 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md@@ -5,7 +5,7 @@ Cleanup and persist session state before ending work.## Usage```bash-npx claude-flow hook session-end [options]+npx @claude-flow/cli@latest hook session-end [options]```## Options@@ -21,25 +21,25 @@ npx claude-flow hook session-end [options]### Basic session end```bash-npx claude-flow hook session-end --session-id "dev-session-2024"+npx @claude-flow/cli@latest hook session-end --session-id "dev-session-2024"```### With full export```bash-npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary+npx @claude-flow/cli@latest hook session-end -s "feature-auth" --export-metrics --generate-summary```### Quick close```bash-npx claude-flow hook session-end -s "quick-fix" --save-state false --cleanup-temp+npx @claude-flow/cli@latest hook session-end -s "quick-fix" --save-state false --cleanup-temp```### Complete persistence```bash-npx claude-flow hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary+npx @claude-flow/cli@latest hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary```## Features@@ -86,7 +86,7 @@ Manual usage in agents:```bash# At session end-npx claude-flow hook session-end --session-id "your-session" --generate-summary+npx @claude-flow/cli@latest hook session-end --session-id "your-session" --generate-summary```## Outputdiff --git a/v3/@claude-flow/cli/.claude/commands/hooks/setup.md b/v3/@claude-flow/cli/.claude/commands/hooks/setup.mdindex c49dd23a6d..9ebb3cb44e 100644--- a/v3/@claude-flow/cli/.claude/commands/hooks/setup.md+++ b/v3/@claude-flow/cli/.claude/commands/hooks/setup.md@@ -4,7 +4,7 @@### 1. Initialize with Hooks```bash-npx claude-flow init --hooks+npx @claude-flow/cli@latest init --hooks```This automatically creates:@@ -15,10 +15,10 @@ This automatically creates:### 2. Test Hook Functionality```bash# Test pre-edit hook-npx claude-flow hook pre-edit --file test.js+npx @claude-flow/cli@latest hook pre-edit --file test.js# Test session summary-npx claude-flow hook session-end --summary+npx @claude-flow/cli@latest hook session-end --summary```### 3. Customize Hooks@@ -33,7 +33,7 @@ Edit `.claude/settings.json` to customize:"matcher": "^Write$","hooks": [{"type": "command",- "command": "npx claude-flow hook pre-write --file '${tool.params.file_path}'"+ "command": "npx @claude-flow/cli@latest hook pre-write --file '${tool.params.file_path}'"}]}]@@ -72,7 +72,7 @@ Example blocking response:export CLAUDE_FLOW_DEBUG=true# Test specific hook-npx claude-flow hook pre-edit --file app.js --debug+npx @claude-flow/cli@latest hook pre-edit --file app.js --debug```## Common Patterns@@ -86,7 +86,7 @@ Already configured by default for common file types."matcher": "^(Write|Edit)$","hooks": [{"type": "command",- "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"+ "command": "npx @claude-flow/cli@latest hook check-protected --file '${tool.params.file_path}'"}]}```diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.mdindex d42bb10bf4..c3651d0c46 100644--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md@@ -4,7 +4,7 @@ Persist memory across sessions.## Usage```bash-npx claude-flow memory persist [options]+npx @claude-flow/cli@latest memory persist [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow memory persist [options]## Examples```bash# Export memory-npx claude-flow memory persist --export memory-backup.json+npx @claude-flow/cli@latest memory persist --export memory-backup.json# Import memory-npx claude-flow memory persist --import memory-backup.json+npx @claude-flow/cli@latest memory persist --import memory-backup.json# Compressed export-npx claude-flow memory persist --export memory.gz --compress+npx @claude-flow/cli@latest memory persist --export memory.gz --compress```diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-search.mdindex 87d6a13d24..7079addc4e 100644--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md@@ -4,7 +4,7 @@ Search through stored memory.## Usage```bash-npx claude-flow memory search [options]+npx @claude-flow/cli@latest memory search [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow memory search [options]## Examples```bash# Search memory-npx claude-flow memory search --query "authentication"+npx @claude-flow/cli@latest memory search --query "authentication"# Pattern search-npx claude-flow memory search --pattern "api-.*"+npx @claude-flow/cli@latest memory search --pattern "api-.*"# Limited results-npx claude-flow memory search --query "config" --limit 10+npx @claude-flow/cli@latest memory search --query "config" --limit 10```diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.mdindex 5e640055a6..3c163a37db 100644--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md@@ -4,7 +4,7 @@ Manage persistent memory storage.## Usage```bash-npx claude-flow memory usage [options]+npx @claude-flow/cli@latest memory usage [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow memory usage [options]## Examples```bash# Store memory-npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'+npx @claude-flow/cli@latest memory usage --action store --key "project-config" --value '{"api": "v2"}'# Retrieve memory-npx claude-flow memory usage --action retrieve --key "project-config"+npx @claude-flow/cli@latest memory usage --action retrieve --key "project-config"# List all keys-npx claude-flow memory usage --action list+npx @claude-flow/cli@latest memory usage --action list```diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md b/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.mdindex a3201d82d5..9e718424aa 100644--- a/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md@@ -4,7 +4,7 @@ View agent performance metrics.## Usage```bash-npx claude-flow agent metrics [options]+npx @claude-flow/cli@latest agent metrics [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow agent metrics [options]## Examples```bash# All agents metrics-npx claude-flow agent metrics+npx @claude-flow/cli@latest agent metrics# Specific agent-npx claude-flow agent metrics --agent-id agent-001+npx @claude-flow/cli@latest agent metrics --agent-id agent-001# Last hour-npx claude-flow agent metrics --period 1h+npx @claude-flow/cli@latest agent metrics --period 1h```diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md b/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.mdindex cd0c26bf16..763a74af37 100644--- a/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md@@ -4,7 +4,7 @@ Real-time view of swarm activity.## Usage```bash-npx claude-flow monitoring real-time-view [options]+npx @claude-flow/cli@latest monitoring real-time-view [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow monitoring real-time-view [options]## Examples```bash# Start real-time view-npx claude-flow monitoring real-time-view+npx @claude-flow/cli@latest monitoring real-time-view# Filter errors-npx claude-flow monitoring real-time-view --filter errors+npx @claude-flow/cli@latest monitoring real-time-view --filter errors# Highlight pattern-npx claude-flow monitoring real-time-view --highlight "API"+npx @claude-flow/cli@latest monitoring real-time-view --highlight "API"```diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md b/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.mdindex 790a0e4342..9917fbcaf4 100644--- a/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md@@ -4,7 +4,7 @@ Real-time swarm monitoring.## Usage```bash-npx claude-flow swarm monitor [options]+npx @claude-flow/cli@latest swarm monitor [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow swarm monitor [options]## Examples```bash# Start monitoring-npx claude-flow swarm monitor+npx @claude-flow/cli@latest swarm monitor# Custom interval-npx claude-flow swarm monitor --interval 5000+npx @claude-flow/cli@latest swarm monitor --interval 5000# With metrics-npx claude-flow swarm monitor --metrics+npx @claude-flow/cli@latest swarm monitor --metrics```diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md b/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.mdindex 949fdca741..ca9a54cf07 100644--- a/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md+++ b/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md@@ -45,7 +45,7 @@ Result: Automatically uses hierarchical topology with architect, coder, and testThe pre-task hook automatically handles topology selection:```json{- "command": "npx claude-flow hook pre-task --optimize-topology"+ "command": "npx @claude-flow/cli@latest hook pre-task --optimize-topology"}```@@ -58,5 +58,5 @@ Parameters: {"swarmId": "current"}## CLI Usage```bash# Auto-optimize topology via CLI-npx claude-flow optimize topology+npx @claude-flow/cli@latest optimize topology```\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md b/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.mdindex 6ddf684c1f..9a5f0a9f74 100644--- a/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md+++ b/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md@@ -4,7 +4,7 @@ Manage operation cache for performance.## Usage```bash-npx claude-flow optimization cache-manage [options]+npx @claude-flow/cli@latest optimization cache-manage [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow optimization cache-manage [options]## Examples```bash# View cache stats-npx claude-flow optimization cache-manage --action view+npx @claude-flow/cli@latest optimization cache-manage --action view# Clear cache-npx claude-flow optimization cache-manage --action clear+npx @claude-flow/cli@latest optimization cache-manage --action clear# Set limits-npx claude-flow optimization cache-manage --max-size 100 --ttl 3600+npx @claude-flow/cli@latest optimization cache-manage --max-size 100 --ttl 3600```diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.mdindex 346a8aa2fe..02c8695784 100644--- a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md+++ b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md@@ -4,7 +4,7 @@ Execute tasks in parallel for maximum efficiency.## Usage```bash-npx claude-flow optimization parallel-execute [options]+npx @claude-flow/cli@latest optimization parallel-execute [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow optimization parallel-execute [options]## Examples```bash# Execute task list-npx claude-flow optimization parallel-execute --tasks tasks.json+npx @claude-flow/cli@latest optimization parallel-execute --tasks tasks.json# Limit parallelism-npx claude-flow optimization parallel-execute --tasks tasks.json --max-parallel 5+npx @claude-flow/cli@latest optimization parallel-execute --tasks tasks.json --max-parallel 5# Custom strategy-npx claude-flow optimization parallel-execute --strategy adaptive+npx @claude-flow/cli@latest optimization parallel-execute --strategy adaptive```diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.mdindex 9585840b65..1ce0df9515 100644--- a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md+++ b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md@@ -32,7 +32,7 @@ For the REST API task:## CLI Usage```bash# Execute parallel tasks via CLI-npx claude-flow parallel "Build REST API" --max-agents 8+npx @claude-flow/cli@latest parallel "Build REST API" --max-agents 8```## Performance Gainsdiff --git a/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md b/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.mdindex f9dfb8b506..cb4dc40702 100644--- a/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md+++ b/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md@@ -4,7 +4,7 @@ Optimize swarm topology for current workload.## Usage```bash-npx claude-flow optimization topology-optimize [options]+npx @claude-flow/cli@latest optimization topology-optimize [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow optimization topology-optimize [options]## Examples```bash# Analyze and suggest-npx claude-flow optimization topology-optimize --analyze-first+npx @claude-flow/cli@latest optimization topology-optimize --analyze-first# Optimize for speed-npx claude-flow optimization topology-optimize --target speed+npx @claude-flow/cli@latest optimization topology-optimize --target speed# Apply changes-npx claude-flow optimization topology-optimize --target efficiency --apply+npx @claude-flow/cli@latest optimization topology-optimize --target efficiency --apply```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc.md b/v3/@claude-flow/cli/.claude/commands/sparc.mdindex 8523bca51b..ed1a394795 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc.md@@ -66,17 +66,17 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Run SPARC orchestrator (default)-npx claude-flow sparc "build complete authentication system"+npx @claude-flow/cli@latest sparc "build complete authentication system"# Run a specific mode-npx claude-flow sparc run architect "design API structure"-npx claude-flow sparc run tdd "implement user service"+npx @claude-flow/cli@latest sparc run architect "design API structure"+npx @claude-flow/cli@latest sparc run tdd "implement user service"# Execute full TDD workflow-npx claude-flow sparc tdd "implement user authentication"+npx @claude-flow/cli@latest sparc tdd "implement user authentication"# List all modes with details-npx claude-flow sparc modes --verbose+npx @claude-flow/cli@latest sparc modes --verbose# For alpha featuresnpx claude-flow@alpha sparc run <mode> "your task"@@ -121,7 +121,7 @@ mcp__claude-flow__memory_usage {### Using NPX CLI (Fallback)```bash# Store specifications-npx claude-flow memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec+npx @claude-flow/cli@latest memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec# Store architectural decisions./claude-flow memory store "arch_api" "RESTful microservices design" --namespace archdiff --git a/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md b/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.mdindex 299fb586c8..600b892f6f 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run analyzer "analyze codebase performance"+npx @claude-flow/cli@latest sparc run analyzer "analyze codebase performance"# For alpha featuresnpx claude-flow@alpha sparc run analyzer "analyze codebase performance"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/architect.md b/v3/@claude-flow/cli/.claude/commands/sparc/architect.mdindex 5f41c5ab52..b8014a523e 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/architect.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/architect.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run architect "design microservices architecture"+npx @claude-flow/cli@latest sparc run architect "design microservices architecture"# For alpha featuresnpx claude-flow@alpha sparc run architect "design microservices architecture"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/ask.md b/v3/@claude-flow/cli/.claude/commands/sparc/ask.mdindex b2f352665e..682f267398 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/ask.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/ask.md@@ -49,16 +49,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run ask "help me choose the right mode"+npx @claude-flow/cli@latest sparc run ask "help me choose the right mode"# For alpha featuresnpx claude-flow@alpha sparc run ask "help me choose the right mode"# With namespace-npx claude-flow sparc run ask "your task" --namespace ask+npx @claude-flow/cli@latest sparc run ask "your task" --namespace ask# Non-interactive mode-npx claude-flow sparc run ask "your task" --non-interactive+npx @claude-flow/cli@latest sparc run ask "your task" --non-interactive```### Option 3: Local Installation@@ -90,8 +90,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "ask_context" "important decisions" --namespace ask+npx @claude-flow/cli@latest memory store "ask_context" "important decisions" --namespace ask# Query previous work-npx claude-flow memory query "ask" --limit 5+npx @claude-flow/cli@latest memory query "ask" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md b/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.mdindex 24dc1f6fd2..e94f9056e0 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run batch-executor "process multiple files"+npx @claude-flow/cli@latest sparc run batch-executor "process multiple files"# For alpha featuresnpx claude-flow@alpha sparc run batch-executor "process multiple files"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/code.md b/v3/@claude-flow/cli/.claude/commands/sparc/code.mdindex f2e7096851..0cacbe5de7 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/code.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/code.md@@ -41,16 +41,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run code "implement REST API endpoints"+npx @claude-flow/cli@latest sparc run code "implement REST API endpoints"# For alpha featuresnpx claude-flow@alpha sparc run code "implement REST API endpoints"# With namespace-npx claude-flow sparc run code "your task" --namespace code+npx @claude-flow/cli@latest sparc run code "your task" --namespace code# Non-interactive mode-npx claude-flow sparc run code "your task" --non-interactive+npx @claude-flow/cli@latest sparc run code "your task" --non-interactive```### Option 3: Local Installation@@ -82,8 +82,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "code_context" "important decisions" --namespace code+npx @claude-flow/cli@latest memory store "code_context" "important decisions" --namespace code# Query previous work-npx claude-flow memory query "code" --limit 5+npx @claude-flow/cli@latest memory query "code" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/coder.md b/v3/@claude-flow/cli/.claude/commands/sparc/coder.mdindex 2dc852433c..a2718d9407 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/coder.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/coder.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run coder "implement user authentication"+npx @claude-flow/cli@latest sparc run coder "implement user authentication"# For alpha featuresnpx claude-flow@alpha sparc run coder "implement user authentication"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/debug.md b/v3/@claude-flow/cli/.claude/commands/sparc/debug.mdindex 3559f241c4..a1cccf791a 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/debug.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/debug.md@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run debug "fix memory leak in service"+npx @claude-flow/cli@latest sparc run debug "fix memory leak in service"# For alpha featuresnpx claude-flow@alpha sparc run debug "fix memory leak in service"# With namespace-npx claude-flow sparc run debug "your task" --namespace debug+npx @claude-flow/cli@latest sparc run debug "your task" --namespace debug# Non-interactive mode-npx claude-flow sparc run debug "your task" --non-interactive+npx @claude-flow/cli@latest sparc run debug "your task" --non-interactive```### Option 3: Local Installation@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "debug_context" "important decisions" --namespace debug+npx @claude-flow/cli@latest memory store "debug_context" "important decisions" --namespace debug# Query previous work-npx claude-flow memory query "debug" --limit 5+npx @claude-flow/cli@latest memory query "debug" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md b/v3/@claude-flow/cli/.claude/commands/sparc/debugger.mdindex 7627dae303..ea09c62d3a 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run debugger "fix authentication issues"+npx @claude-flow/cli@latest sparc run debugger "fix authentication issues"# For alpha featuresnpx claude-flow@alpha sparc run debugger "fix authentication issues"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/designer.md b/v3/@claude-flow/cli/.claude/commands/sparc/designer.mdindex c15d54b705..123e0aaa64 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/designer.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/designer.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run designer "create dashboard UI"+npx @claude-flow/cli@latest sparc run designer "create dashboard UI"# For alpha featuresnpx claude-flow@alpha sparc run designer "create dashboard UI"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/devops.md b/v3/@claude-flow/cli/.claude/commands/sparc/devops.mdindex 43f0422c77..b606260d86 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/devops.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/devops.md@@ -61,16 +61,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run devops "deploy to AWS Lambda"+npx @claude-flow/cli@latest sparc run devops "deploy to AWS Lambda"# For alpha featuresnpx claude-flow@alpha sparc run devops "deploy to AWS Lambda"# With namespace-npx claude-flow sparc run devops "your task" --namespace devops+npx @claude-flow/cli@latest sparc run devops "your task" --namespace devops# Non-interactive mode-npx claude-flow sparc run devops "your task" --non-interactive+npx @claude-flow/cli@latest sparc run devops "your task" --non-interactive```### Option 3: Local Installation@@ -102,8 +102,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "devops_context" "important decisions" --namespace devops+npx @claude-flow/cli@latest memory store "devops_context" "important decisions" --namespace devops# Query previous work-npx claude-flow memory query "devops" --limit 5+npx @claude-flow/cli@latest memory query "devops" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md b/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.mdindex 47440c861e..1fbf324f5f 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run docs-writer "create API documentation"+npx @claude-flow/cli@latest sparc run docs-writer "create API documentation"# For alpha featuresnpx claude-flow@alpha sparc run docs-writer "create API documentation"# With namespace-npx claude-flow sparc run docs-writer "your task" --namespace docs-writer+npx @claude-flow/cli@latest sparc run docs-writer "your task" --namespace docs-writer# Non-interactive mode-npx claude-flow sparc run docs-writer "your task" --non-interactive+npx @claude-flow/cli@latest sparc run docs-writer "your task" --non-interactive```### Option 3: Local Installation@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "docs-writer_context" "important decisions" --namespace docs-writer+npx @claude-flow/cli@latest memory store "docs-writer_context" "important decisions" --namespace docs-writer# Query previous work-npx claude-flow memory query "docs-writer" --limit 5+npx @claude-flow/cli@latest memory query "docs-writer" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md b/v3/@claude-flow/cli/.claude/commands/sparc/documenter.mdindex fba3d97a11..0db491c388 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run documenter "create API documentation"+npx @claude-flow/cli@latest sparc run documenter "create API documentation"# For alpha featuresnpx claude-flow@alpha sparc run documenter "create API documentation"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md b/v3/@claude-flow/cli/.claude/commands/sparc/innovator.mdindex 5a11c1a9f3..5215636d20 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run innovator "innovative solutions for scaling"+npx @claude-flow/cli@latest sparc run innovator "innovative solutions for scaling"# For alpha featuresnpx claude-flow@alpha sparc run innovator "innovative solutions for scaling"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/integration.md b/v3/@claude-flow/cli/.claude/commands/sparc/integration.mdindex 591a89f0dc..70b8fa1833 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/integration.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/integration.md@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run integration "connect payment service"+npx @claude-flow/cli@latest sparc run integration "connect payment service"# For alpha featuresnpx claude-flow@alpha sparc run integration "connect payment service"# With namespace-npx claude-flow sparc run integration "your task" --namespace integration+npx @claude-flow/cli@latest sparc run integration "your task" --namespace integration# Non-interactive mode-npx claude-flow sparc run integration "your task" --non-interactive+npx @claude-flow/cli@latest sparc run integration "your task" --non-interactive```### Option 3: Local Installation@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "integration_context" "important decisions" --namespace integration+npx @claude-flow/cli@latest memory store "integration_context" "important decisions" --namespace integration# Query previous work-npx claude-flow memory query "integration" --limit 5+npx @claude-flow/cli@latest memory query "integration" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md b/v3/@claude-flow/cli/.claude/commands/sparc/mcp.mdindex df94d213f8..fec09e7c19 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md@@ -69,16 +69,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run mcp "integrate with external API"+npx @claude-flow/cli@latest sparc run mcp "integrate with external API"# For alpha featuresnpx claude-flow@alpha sparc run mcp "integrate with external API"# With namespace-npx claude-flow sparc run mcp "your task" --namespace mcp+npx @claude-flow/cli@latest sparc run mcp "your task" --namespace mcp# Non-interactive mode-npx claude-flow sparc run mcp "your task" --non-interactive+npx @claude-flow/cli@latest sparc run mcp "your task" --non-interactive```### Option 3: Local Installation@@ -110,8 +110,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "mcp_context" "important decisions" --namespace mcp+npx @claude-flow/cli@latest memory store "mcp_context" "important decisions" --namespace mcp# Query previous work-npx claude-flow memory query "mcp" --limit 5+npx @claude-flow/cli@latest memory query "mcp" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md b/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.mdindex c3de400508..a6170ac4c4 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run memory-manager "organize project knowledge"+npx @claude-flow/cli@latest sparc run memory-manager "organize project knowledge"# For alpha featuresnpx claude-flow@alpha sparc run memory-manager "organize project knowledge"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md b/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.mdindex 94a246adcf..031859ae7f 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run optimizer "optimize application performance"+npx @claude-flow/cli@latest sparc run optimizer "optimize application performance"# For alpha featuresnpx claude-flow@alpha sparc run optimizer "optimize application performance"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md b/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.mdindex b577751bc2..47e53aa56c 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md@@ -16,7 +16,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run orchestrator "coordinate feature development"+npx @claude-flow/cli@latest sparc run orchestrator "coordinate feature development"# For alpha featuresnpx claude-flow@alpha sparc run orchestrator "coordinate feature development"@@ -63,13 +63,13 @@ mcp__claude-flow__task_orchestrate {### Using NPX CLI (Fallback)```bash# Initialize orchestration swarm-npx claude-flow swarm init --topology hierarchical --strategy auto --max-agents 8+npx @claude-flow/cli@latest swarm init --topology hierarchical --strategy auto --max-agents 8# Spawn coordinator agent-npx claude-flow agent spawn --type coordinator --capabilities "task-planning,resource-management"+npx @claude-flow/cli@latest agent spawn --type coordinator --capabilities "task-planning,resource-management"# Orchestrate tasks-npx claude-flow task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"+npx @claude-flow/cli@latest task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"```## Orchestration Patterns@@ -119,14 +119,14 @@ mcp__claude-flow__swarm_monitor {### Using NPX CLI (Fallback)```bash# 1. Initialize orchestration swarm-npx claude-flow swarm init --topology hierarchical --max-agents 10+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 10# 2. Create workflow-npx claude-flow workflow create --name "feature-development" --steps "design,implement,test,deploy"+npx @claude-flow/cli@latest workflow create --name "feature-development" --steps "design,implement,test,deploy"# 3. Execute orchestration-npx claude-flow sparc run orchestrator "develop user management system" --parallel --monitor+npx @claude-flow/cli@latest sparc run orchestrator "develop user management system" --parallel --monitor# 4. Monitor progress-npx claude-flow swarm monitor --interval 5000+npx @claude-flow/cli@latest swarm monitor --interval 5000```\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md b/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.mdindex e800eb7b85..23453a30a5 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run post-deployment-monitoring-mode "monitor production metrics"+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "monitor production metrics"# For alpha featuresnpx claude-flow@alpha sparc run post-deployment-monitoring-mode "monitor production metrics"# With namespace-npx claude-flow sparc run post-deployment-monitoring-mode "your task" --namespace post-deployment-monitoring-mode+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "your task" --namespace post-deployment-monitoring-mode# Non-interactive mode-npx claude-flow sparc run post-deployment-monitoring-mode "your task" --non-interactive+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "your task" --non-interactive```### Option 3: Local Installation@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "post-deployment-monitoring-mode_context" "important decisions" --namespace post-deployment-monitoring-mode+npx @claude-flow/cli@latest memory store "post-deployment-monitoring-mode_context" "important decisions" --namespace post-deployment-monitoring-mode# Query previous work-npx claude-flow memory query "post-deployment-monitoring-mode" --limit 5+npx @claude-flow/cli@latest memory query "post-deployment-monitoring-mode" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md b/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.mdindex f20a60868f..196ed15c90 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run refinement-optimization-mode "optimize database queries"+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "optimize database queries"# For alpha featuresnpx claude-flow@alpha sparc run refinement-optimization-mode "optimize database queries"# With namespace-npx claude-flow sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode# Non-interactive mode-npx claude-flow sparc run refinement-optimization-mode "your task" --non-interactive+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "your task" --non-interactive```### Option 3: Local Installation@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode+npx @claude-flow/cli@latest memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode# Query previous work-npx claude-flow memory query "refinement-optimization-mode" --limit 5+npx @claude-flow/cli@latest memory query "refinement-optimization-mode" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md b/v3/@claude-flow/cli/.claude/commands/sparc/researcher.mdindex ecd6be34fd..75654d37cd 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run researcher "research AI trends 2024"+npx @claude-flow/cli@latest sparc run researcher "research AI trends 2024"# For alpha featuresnpx claude-flow@alpha sparc run researcher "research AI trends 2024"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md b/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.mdindex 1464aca931..f53faf9478 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run reviewer "review pull request #123"+npx @claude-flow/cli@latest sparc run reviewer "review pull request #123"# For alpha featuresnpx claude-flow@alpha sparc run reviewer "review pull request #123"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md b/v3/@claude-flow/cli/.claude/commands/sparc/security-review.mdindex fc00e3efcf..5595369d62 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run security-review "audit API security"+npx @claude-flow/cli@latest sparc run security-review "audit API security"# For alpha featuresnpx claude-flow@alpha sparc run security-review "audit API security"# With namespace-npx claude-flow sparc run security-review "your task" --namespace security-review+npx @claude-flow/cli@latest sparc run security-review "your task" --namespace security-review# Non-interactive mode-npx claude-flow sparc run security-review "your task" --non-interactive+npx @claude-flow/cli@latest sparc run security-review "your task" --non-interactive```### Option 3: Local Installation@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "security-review_context" "important decisions" --namespace security-review+npx @claude-flow/cli@latest memory store "security-review_context" "important decisions" --namespace security-review# Query previous work-npx claude-flow memory query "security-review" --limit 5+npx @claude-flow/cli@latest memory query "security-review" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md b/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.mdindex ed477d9f11..015a347013 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md@@ -65,19 +65,19 @@ mcp__claude-flow__swarm_monitor {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run <mode> "task description"+npx @claude-flow/cli@latest sparc run <mode> "task description"# For alpha featuresnpx claude-flow@alpha sparc run <mode> "task description"# List all modes-npx claude-flow sparc modes+npx @claude-flow/cli@latest sparc modes# Get help for a mode-npx claude-flow sparc help <mode>+npx @claude-flow/cli@latest sparc help <mode># Run with options-npx claude-flow sparc run <mode> "task" --parallel --monitor+npx @claude-flow/cli@latest sparc run <mode> "task" --parallel --monitor```### Option 3: Local Installation@@ -126,16 +126,16 @@ mcp__claude-flow__sparc_mode {#### Using NPX CLI (Fallback)```bash# 1. Architecture design-npx claude-flow sparc run architect "design microservices"+npx @claude-flow/cli@latest sparc run architect "design microservices"# 2. Implementation-npx claude-flow sparc run coder "implement services"+npx @claude-flow/cli@latest sparc run coder "implement services"# 3. Testing-npx claude-flow sparc run tdd "test all services"+npx @claude-flow/cli@latest sparc run tdd "test all services"# 4. Review-npx claude-flow sparc run reviewer "review implementation"+npx @claude-flow/cli@latest sparc run reviewer "review implementation"```### Research and Innovation@@ -164,11 +164,11 @@ mcp__claude-flow__sparc_mode {#### Using NPX CLI (Fallback)```bash# 1. Research phase-npx claude-flow sparc run researcher "research best practices"+npx @claude-flow/cli@latest sparc run researcher "research best practices"# 2. Innovation-npx claude-flow sparc run innovator "propose novel solutions"+npx @claude-flow/cli@latest sparc run innovator "propose novel solutions"# 3. Documentation-npx claude-flow sparc run documenter "document findings"+npx @claude-flow/cli@latest sparc run documenter "document findings"```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md b/v3/@claude-flow/cli/.claude/commands/sparc/sparc.mdindex 3192d8d2dd..52e68dc8f0 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md@@ -63,16 +63,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run sparc "orchestrate authentication system"+npx @claude-flow/cli@latest sparc run sparc "orchestrate authentication system"# For alpha featuresnpx claude-flow@alpha sparc run sparc "orchestrate authentication system"# With namespace-npx claude-flow sparc run sparc "your task" --namespace sparc+npx @claude-flow/cli@latest sparc run sparc "your task" --namespace sparc# Non-interactive mode-npx claude-flow sparc run sparc "your task" --non-interactive+npx @claude-flow/cli@latest sparc run sparc "your task" --non-interactive```### Option 3: Local Installation@@ -104,8 +104,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "sparc_context" "important decisions" --namespace sparc+npx @claude-flow/cli@latest memory store "sparc_context" "important decisions" --namespace sparc# Query previous work-npx claude-flow memory query "sparc" --limit 5+npx @claude-flow/cli@latest memory query "sparc" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md b/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.mdindex cb253275f4..9fe8887b22 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run spec-pseudocode "define payment flow requirements"+npx @claude-flow/cli@latest sparc run spec-pseudocode "define payment flow requirements"# For alpha featuresnpx claude-flow@alpha sparc run spec-pseudocode "define payment flow requirements"# With namespace-npx claude-flow sparc run spec-pseudocode "your task" --namespace spec-pseudocode+npx @claude-flow/cli@latest sparc run spec-pseudocode "your task" --namespace spec-pseudocode# Non-interactive mode-npx claude-flow sparc run spec-pseudocode "your task" --non-interactive+npx @claude-flow/cli@latest sparc run spec-pseudocode "your task" --non-interactive```### Option 3: Local Installation@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "spec-pseudocode_context" "important decisions" --namespace spec-pseudocode+npx @claude-flow/cli@latest memory store "spec-pseudocode_context" "important decisions" --namespace spec-pseudocode# Query previous work-npx claude-flow memory query "spec-pseudocode" --limit 5+npx @claude-flow/cli@latest memory query "spec-pseudocode" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md b/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.mdindex c54778dd77..3223cd959f 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md@@ -300,16 +300,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run supabase-admin "create user authentication schema"+npx @claude-flow/cli@latest sparc run supabase-admin "create user authentication schema"# For alpha featuresnpx claude-flow@alpha sparc run supabase-admin "create user authentication schema"# With namespace-npx claude-flow sparc run supabase-admin "your task" --namespace supabase-admin+npx @claude-flow/cli@latest sparc run supabase-admin "your task" --namespace supabase-admin# Non-interactive mode-npx claude-flow sparc run supabase-admin "your task" --non-interactive+npx @claude-flow/cli@latest sparc run supabase-admin "your task" --non-interactive```### Option 3: Local Installation@@ -341,8 +341,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "supabase-admin_context" "important decisions" --namespace supabase-admin+npx @claude-flow/cli@latest memory store "supabase-admin_context" "important decisions" --namespace supabase-admin# Query previous work-npx claude-flow memory query "supabase-admin" --limit 5+npx @claude-flow/cli@latest memory query "supabase-admin" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md b/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.mdindex 0454c51e9a..a8d01ed521 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run swarm-coordinator "manage development swarm"+npx @claude-flow/cli@latest sparc run swarm-coordinator "manage development swarm"# For alpha featuresnpx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md b/v3/@claude-flow/cli/.claude/commands/sparc/tdd.mdindex a711770938..51d725697a 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run tdd "shopping cart feature"+npx @claude-flow/cli@latest sparc run tdd "shopping cart feature"# For alpha featuresnpx claude-flow@alpha sparc run tdd "shopping cart feature"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tester.md b/v3/@claude-flow/cli/.claude/commands/sparc/tester.mdindex 1d02c7eed5..fbdfe03d82 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/tester.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tester.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run tester "full regression suite"+npx @claude-flow/cli@latest sparc run tester "full regression suite"# For alpha featuresnpx claude-flow@alpha sparc run tester "full regression suite"diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md b/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.mdindex 156d3fba22..834ef5488c 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md@@ -31,16 +31,16 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run tutorial "guide me through SPARC methodology"+npx @claude-flow/cli@latest sparc run tutorial "guide me through SPARC methodology"# For alpha featuresnpx claude-flow@alpha sparc run tutorial "guide me through SPARC methodology"# With namespace-npx claude-flow sparc run tutorial "your task" --namespace tutorial+npx @claude-flow/cli@latest sparc run tutorial "your task" --namespace tutorial# Non-interactive mode-npx claude-flow sparc run tutorial "your task" --non-interactive+npx @claude-flow/cli@latest sparc run tutorial "your task" --non-interactive```### Option 3: Local Installation@@ -72,8 +72,8 @@ mcp__claude-flow__memory_search {### Using NPX CLI (Fallback)```bash# Store mode-specific context-npx claude-flow memory store "tutorial_context" "important decisions" --namespace tutorial+npx @claude-flow/cli@latest memory store "tutorial_context" "important decisions" --namespace tutorial# Query previous work-npx claude-flow memory query "tutorial" --limit 5+npx @claude-flow/cli@latest memory query "tutorial" --limit 5```diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md b/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.mdindex 5c449de7a3..6a2feab718 100644--- a/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md+++ b/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {### Option 2: Using NPX CLI (Fallback when MCP not available)```bash# Use when running from terminal or MCP tools unavailable-npx claude-flow sparc run workflow-manager "automate deployment"+npx @claude-flow/cli@latest sparc run workflow-manager "automate deployment"# For alpha featuresnpx claude-flow@alpha sparc run workflow-manager "automate deployment"diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md b/v3/@claude-flow/cli/.claude/commands/swarm/analysis.mdindex a60ebcd6c8..19354e6b91 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "analyze system performance" --strategy analysis`+`npx @claude-flow/cli@latest swarm "analyze system performance" --strategy analysis`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/swarm/development.md b/v3/@claude-flow/cli/.claude/commands/swarm/development.mdindex b106ed88f0..785254675a 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/development.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/development.md@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "build feature X" --strategy development`+`npx @claude-flow/cli@latest swarm "build feature X" --strategy development`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/swarm/examples.md b/v3/@claude-flow/cli/.claude/commands/swarm/examples.mdindex 8d60b2d44c..3380257bea 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/examples.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/examples.md@@ -35,7 +35,7 @@ mcp__claude-flow__swarm_status({#### Using CLI (Fallback)```bash-npx claude-flow swarm "research AI trends" \+npx @claude-flow/cli@latest swarm "research AI trends" \--strategy research \--mode distributed \--max-agents 6 \@@ -85,7 +85,7 @@ mcp__claude-flow__swarm_monitor({#### Using CLI (Fallback)```bash-npx claude-flow swarm "build REST API" \+npx @claude-flow/cli@latest swarm "build REST API" \--strategy development \--mode hierarchical \--monitor \@@ -134,7 +134,7 @@ mcp__claude-flow__performance_report({#### Using CLI (Fallback)```bash-npx claude-flow swarm "analyze codebase" \+npx @claude-flow/cli@latest swarm "analyze codebase" \--strategy analysis \--mode mesh \--parallel \diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md b/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.mdindex f91e6d0b4a..155630a3d4 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md@@ -24,7 +24,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "update dependencies" --strategy maintenance`+`npx @claude-flow/cli@latest swarm "update dependencies" --strategy maintenance`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md b/v3/@claude-flow/cli/.claude/commands/swarm/optimization.mdindex ca0bd2bd6b..1b4e13a4ae 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "optimize performance" --strategy optimization`+`npx @claude-flow/cli@latest swarm "optimize performance" --strategy optimization`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/swarm/research.md b/v3/@claude-flow/cli/.claude/commands/swarm/research.mdindex fbdd0343a0..53c653cbdc 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/research.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/research.md@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "research topic X" --strategy research`+`npx @claude-flow/cli@latest swarm "research topic X" --strategy research`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.mdindex 1168d1b181..a5bbd4006a 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md@@ -4,5 +4,5 @@ Command documentation for swarm-analysis in category swarm.Usage:```bash-npx claude-flow swarm swarm-analysis [options]+npx @claude-flow/cli@latest swarm swarm-analysis [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.mdindex 055330c839..b0983d751e 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md@@ -4,5 +4,5 @@ Command documentation for swarm-background in category swarm.Usage:```bash-npx claude-flow swarm swarm-background [options]+npx @claude-flow/cli@latest swarm swarm-background [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.mdindex 1644941666..2d0399c0f5 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md@@ -4,7 +4,7 @@ Initialize a new swarm with specified topology.## Usage```bash-npx claude-flow swarm init [options]+npx @claude-flow/cli@latest swarm init [options]```## Options@@ -14,6 +14,6 @@ npx claude-flow swarm init [options]## Examples```bash-npx claude-flow swarm init --topology mesh-npx claude-flow swarm init --topology hierarchical --max-agents 8+npx @claude-flow/cli@latest swarm init --topology mesh+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.mdindex 1818013d75..b9290d7d9e 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md@@ -4,5 +4,5 @@ Command documentation for swarm-modes in category swarm.Usage:```bash-npx claude-flow swarm swarm-modes [options]+npx @claude-flow/cli@latest swarm swarm-modes [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.mdindex 8c526bdc4d..e4f1521499 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md@@ -4,5 +4,5 @@ Command documentation for swarm-monitor in category swarm.Usage:```bash-npx claude-flow swarm swarm-monitor [options]+npx @claude-flow/cli@latest swarm swarm-monitor [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.mdindex b10ece8b06..1be34e12aa 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md@@ -4,7 +4,7 @@ Spawn agents in the swarm.## Usage```bash-npx claude-flow swarm spawn [options]+npx @claude-flow/cli@latest swarm spawn [options]```## Options@@ -14,6 +14,6 @@ npx claude-flow swarm spawn [options]## Examples```bash-npx claude-flow swarm spawn --type coder --count 3-npx claude-flow swarm spawn --type researcher --capabilities "web-search,analysis"+npx @claude-flow/cli@latest swarm spawn --type coder --count 3+npx @claude-flow/cli@latest swarm spawn --type researcher --capabilities "web-search,analysis"```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.mdindex 20fadfb8c5..9bd9c5de65 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md@@ -4,5 +4,5 @@ Command documentation for swarm-status in category swarm.Usage:```bash-npx claude-flow swarm swarm-status [options]+npx @claude-flow/cli@latest swarm swarm-status [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.mdindex 3712a909a9..ef91049adc 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md@@ -4,5 +4,5 @@ Command documentation for swarm-strategies in category swarm.Usage:```bash-npx claude-flow swarm swarm-strategies [options]+npx @claude-flow/cli@latest swarm swarm-strategies [options]```diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/testing.md b/v3/@claude-flow/cli/.claude/commands/swarm/testing.mdindex e2b8af3c34..034db206a5 100644--- a/v3/@claude-flow/cli/.claude/commands/swarm/testing.md+++ b/v3/@claude-flow/cli/.claude/commands/swarm/testing.md@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({```### Using CLI (Fallback)-`npx claude-flow swarm "test application" --strategy testing`+`npx @claude-flow/cli@latest swarm "test application" --strategy testing`## Agent Rolesdiff --git a/v3/@claude-flow/cli/.claude/commands/training/model-update.md b/v3/@claude-flow/cli/.claude/commands/training/model-update.mdindex 5e81b25dae..9a576d5308 100644--- a/v3/@claude-flow/cli/.claude/commands/training/model-update.md+++ b/v3/@claude-flow/cli/.claude/commands/training/model-update.md@@ -4,7 +4,7 @@ Update neural models with new data.## Usage```bash-npx claude-flow training model-update [options]+npx @claude-flow/cli@latest training model-update [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow training model-update [options]## Examples```bash# Update all models-npx claude-flow training model-update+npx @claude-flow/cli@latest training model-update# Specific model-npx claude-flow training model-update --model agent-selector+npx @claude-flow/cli@latest training model-update --model agent-selector# Incremental with validation-npx claude-flow training model-update --incremental --validate+npx @claude-flow/cli@latest training model-update --incremental --validate```diff --git a/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md b/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.mdindex c22c2450b7..a014e7188e 100644--- a/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md+++ b/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md@@ -23,13 +23,13 @@ Every successful operation trains the neural networks:### 2. Manual Training```bash# Train coordination patterns (50 epochs)-npx claude-flow neural train -p coordination -e 50+npx @claude-flow/cli@latest neural train -p coordination -e 50# Train optimization patterns with custom learning rate-npx claude-flow neural train -p optimization -l 0.005+npx @claude-flow/cli@latest neural train -p optimization -l 0.005# Quick training (10 epochs)-npx claude-flow neural train -e 10+npx @claude-flow/cli@latest neural train -e 10```### 3. Pattern Types@@ -50,20 +50,20 @@ npx claude-flow neural train -e 10### 4. Improvement Tracking```bash# Check neural system status-npx claude-flow neural status+npx @claude-flow/cli@latest neural status```## Pattern Management```bash# List all persisted patterns-npx claude-flow neural patterns --action list+npx @claude-flow/cli@latest neural patterns --action list# Search patterns by query-npx claude-flow neural patterns --action list -q "error handling"+npx @claude-flow/cli@latest neural patterns --action list -q "error handling"# Analyze patterns-npx claude-flow neural patterns --action analyze -q "coordination"+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"```## Performance Targets@@ -85,19 +85,19 @@ npx claude-flow neural patterns --action analyze -q "coordination"```bash# Train neural patterns-npx claude-flow neural train -p coordination -e 50+npx @claude-flow/cli@latest neural train -p coordination -e 50# Check neural status-npx claude-flow neural status+npx @claude-flow/cli@latest neural status# List patterns-npx claude-flow neural patterns --action list+npx @claude-flow/cli@latest neural patterns --action list# Search patterns-npx claude-flow neural patterns --action list -q "query"+npx @claude-flow/cli@latest neural patterns --action list -q "query"# Analyze patterns-npx claude-flow neural patterns --action analyze -q "coordination"+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"```## Related Commandsdiff --git a/v3/@claude-flow/cli/.claude/commands/training/neural-train.md b/v3/@claude-flow/cli/.claude/commands/training/neural-train.mdindex c50aa04f8d..0b20d8ab66 100644--- a/v3/@claude-flow/cli/.claude/commands/training/neural-train.md+++ b/v3/@claude-flow/cli/.claude/commands/training/neural-train.md@@ -4,7 +4,7 @@ Train neural patterns with SONA (Self-Optimizing Neural Architecture) for adapti## Usage```bash-npx claude-flow neural train [options]+npx @claude-flow/cli@latest neural train [options]```## Options@@ -27,16 +27,16 @@ Patterns survive process restarts and are loaded automatically on next session.```bash# Train coordination patterns (50 epochs)-npx claude-flow neural train -p coordination -e 50+npx @claude-flow/cli@latest neural train -p coordination -e 50# Train with custom learning rate-npx claude-flow neural train -p optimization -l 0.005+npx @claude-flow/cli@latest neural train -p optimization -l 0.005# Train from file-npx claude-flow neural train -d ./training-data.json+npx @claude-flow/cli@latest neural train -d ./training-data.json# Quick training (10 epochs)-npx claude-flow neural train -e 10+npx @claude-flow/cli@latest neural train -e 10```## Output@@ -51,13 +51,13 @@ Training produces:```bash# List all persisted patterns-npx claude-flow neural patterns --action list+npx @claude-flow/cli@latest neural patterns --action list# Search patterns by query-npx claude-flow neural patterns --action list -q "error handling"+npx @claude-flow/cli@latest neural patterns --action list -q "error handling"# Analyze patterns-npx claude-flow neural patterns --action analyze -q "coordination"+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"```## Performance Targetsdiff --git a/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md b/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.mdindex 56da6be88b..1315363db0 100644--- a/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md+++ b/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md@@ -4,7 +4,7 @@ Learn patterns from successful operations.## Usage```bash-npx claude-flow training pattern-learn [options]+npx @claude-flow/cli@latest training pattern-learn [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow training pattern-learn [options]## Examples```bash# Learn from all ops-npx claude-flow training pattern-learn+npx @claude-flow/cli@latest training pattern-learn# High success only-npx claude-flow training pattern-learn --threshold 0.9+npx @claude-flow/cli@latest training pattern-learn --threshold 0.9# Save patterns-npx claude-flow training pattern-learn --save optimal-patterns+npx @claude-flow/cli@latest training pattern-learn --save optimal-patterns```diff --git a/v3/@claude-flow/cli/.claude/commands/training/specialization.md b/v3/@claude-flow/cli/.claude/commands/training/specialization.mdindex 329f8ece20..e1561876ed 100644--- a/v3/@claude-flow/cli/.claude/commands/training/specialization.md+++ b/v3/@claude-flow/cli/.claude/commands/training/specialization.md@@ -56,8 +56,8 @@ Agents share learnings across sessions for cumulative expertise!## CLI Usage```bash# Train agent specialization via CLI-npx claude-flow train agent --type coder --capabilities "react,typescript"+npx @claude-flow/cli@latest train agent --type coder --capabilities "react,typescript"# Check specializations-npx claude-flow agent list --specializations+npx @claude-flow/cli@latest agent list --specializations```\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/commands/workflows/development.md b/v3/@claude-flow/cli/.claude/commands/workflows/development.mdindex 84fc7dd845..cad7051895 100644--- a/v3/@claude-flow/cli/.claude/commands/workflows/development.md+++ b/v3/@claude-flow/cli/.claude/commands/workflows/development.md@@ -68,11 +68,11 @@ Remember: All code is written by Claude Code using its native tools!## CLI Usage```bash# Start development workflow via CLI-npx claude-flow workflow dev "REST API with auth"+npx @claude-flow/cli@latest workflow dev "REST API with auth"# Create custom workflow-npx claude-flow workflow create --name "api-dev" --steps "design,implement,test,deploy"+npx @claude-flow/cli@latest workflow create --name "api-dev" --steps "design,implement,test,deploy"# Execute saved workflow-npx claude-flow workflow execute api-dev+npx @claude-flow/cli@latest workflow execute api-dev```\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/commands/workflows/research.md b/v3/@claude-flow/cli/.claude/commands/workflows/research.mdindex 7eed3e299b..a6f4718343 100644--- a/v3/@claude-flow/cli/.claude/commands/workflows/research.md+++ b/v3/@claude-flow/cli/.claude/commands/workflows/research.md@@ -56,8 +56,8 @@ Remember: The swarm coordinates HOW Claude Code researches, not WHAT it finds.## CLI Usage```bash# Start research workflow via CLI-npx claude-flow workflow research "modern web frameworks"+npx @claude-flow/cli@latest workflow research "modern web frameworks"# Export research workflow-npx claude-flow workflow export research --format json+npx @claude-flow/cli@latest workflow export research --format json```\ No newline at end of filediff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.mdindex c4ae9cd5a7..7afe0eb026 100644--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md@@ -4,7 +4,7 @@ Create reusable workflow templates.## Usage```bash-npx claude-flow workflow create [options]+npx @claude-flow/cli@latest workflow create [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow workflow create [options]## Examples```bash# Create workflow-npx claude-flow workflow create --name "deploy-api"+npx @claude-flow/cli@latest workflow create --name "deploy-api"# From history-npx claude-flow workflow create --name "test-suite" --from-history+npx @claude-flow/cli@latest workflow create --name "test-suite" --from-history# Interactive mode-npx claude-flow workflow create --interactive+npx @claude-flow/cli@latest workflow create --interactive```diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.mdindex 1e59870710..2b05c26481 100644--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md@@ -4,7 +4,7 @@ Execute saved workflows.## Usage```bash-npx claude-flow workflow execute [options]+npx @claude-flow/cli@latest workflow execute [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow workflow execute [options]## Examples```bash# Execute workflow-npx claude-flow workflow execute --name "deploy-api"+npx @claude-flow/cli@latest workflow execute --name "deploy-api"# With parameters-npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'+npx @claude-flow/cli@latest workflow execute --name "test-suite" --params '{"env": "staging"}'# Dry run-npx claude-flow workflow execute --name "deploy-api" --dry-run+npx @claude-flow/cli@latest workflow execute --name "deploy-api" --dry-run```diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.mdindex 6dd2479b65..e95cb0f485 100644--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md@@ -4,7 +4,7 @@ Export workflows for sharing.## Usage```bash-npx claude-flow workflow export [options]+npx @claude-flow/cli@latest workflow export [options]```## Options@@ -15,11 +15,11 @@ npx claude-flow workflow export [options]## Examples```bash# Export workflow-npx claude-flow workflow export --name "deploy-api"+npx @claude-flow/cli@latest workflow export --name "deploy-api"# As YAML-npx claude-flow workflow export --name "test-suite" --format yaml+npx @claude-flow/cli@latest workflow export --name "test-suite" --format yaml# With history-npx claude-flow workflow export --name "deploy-api" --include-history+npx @claude-flow/cli@latest workflow export --name "deploy-api" --include-history```diff --git a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjsindex e0764c25cf..409f689703 100755--- a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs+++ b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs@@ -189,7 +189,7 @@ async function loadMemoryPackage() {}// Strategy 2: Use createRequire for CJS-style resolution (handles nested node_modules- // when installed as a transitive dependency via npx ruflo / npx claude-flow)+ // when installed as a transitive dependency via npx ruflo / npx @claude-flow/cli@latest)try {const { createRequire } = await import('module');const require = createRequire(join(PROJECT_ROOT, 'package.json'));diff --git a/v3/@claude-flow/cli/.claude/helpers/github-setup.sh b/v3/@claude-flow/cli/.claude/helpers/github-setup.shindex f235ab69d6..ce966bc4e2 100755--- a/v3/@claude-flow/cli/.claude/helpers/github-setup.sh+++ b/v3/@claude-flow/cli/.claude/helpers/github-setup.sh@@ -39,7 +39,7 @@ fiecho ""echo "GitHub swarm commands available:"-echo " - npx claude-flow github swarm"-echo " - npx claude-flow repo analyze"-echo " - npx claude-flow pr enhance"-echo " - npx claude-flow issue triage"+echo " - npx @claude-flow/cli@latest github swarm"+echo " - npx @claude-flow/cli@latest repo analyze"+echo " - npx @claude-flow/cli@latest pr enhance"+echo " - npx @claude-flow/cli@latest issue triage"diff --git a/v3/@claude-flow/cli/.claude/helpers/quick-start.sh b/v3/@claude-flow/cli/.claude/helpers/quick-start.shindex 37a07840b7..4fed4eef66 100755--- a/v3/@claude-flow/cli/.claude/helpers/quick-start.sh+++ b/v3/@claude-flow/cli/.claude/helpers/quick-start.sh@@ -5,15 +5,15 @@ echo "π Claude Flow Quick Start"echo "=========================="echo ""echo "1. Initialize a swarm:"-echo " npx claude-flow swarm init --topology hierarchical"+echo " npx @claude-flow/cli@latest swarm init --topology hierarchical"echo ""echo "2. Spawn agents:"-echo " npx claude-flow agent spawn --type coder --name "API Developer""+echo " npx @claude-flow/cli@latest agent spawn --type coder --name "API Developer""echo ""echo "3. Orchestrate tasks:"-echo " npx claude-flow task orchestrate --task "Build REST API""+echo " npx @claude-flow/cli@latest task orchestrate --task "Build REST API""echo ""echo "4. Monitor progress:"-echo " npx claude-flow swarm monitor"+echo " npx @claude-flow/cli@latest swarm monitor"echo ""echo "π For more examples, see .claude/commands/"diff --git a/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh b/v3/@claude-flow/cli/.claude/helpers/setup-mcp.shindex d50d89152b..695334d7e8 100755--- a/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh+++ b/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh@@ -12,7 +12,7 @@ fi# Add MCP serverecho "π¦ Adding Claude Flow MCP server..."-claude mcp add claude-flow npx claude-flow mcp start+claude mcp add claude-flow npx @claude-flow/cli@latest mcp startecho "β MCP server setup complete!"echo "π― You can now use mcp__claude-flow__ tools in Claude Code"diff --git a/v3/@claude-flow/cli/.claude/settings.json b/v3/@claude-flow/cli/.claude/settings.jsonindex 029f8c6380..e0201d750d 100644--- a/v3/@claude-flow/cli/.claude/settings.json+++ b/v3/@claude-flow/cli/.claude/settings.json@@ -105,7 +105,7 @@"permissions": {"allow": ["Bash(npx @claude-flow*)",- "Bash(npx claude-flow*)",+ "Bash(npx @claude-flow/cli@latest*)","Bash(node .claude/*)","mcp__claude-flow__:*"],diff --git a/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md b/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.mdindex 38424c1061..1bc847580c 100644--- a/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md+++ b/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md@@ -51,7 +51,7 @@ Spawn multiple headless Codex workers to run tasks in parallel while you continu```bash# Initialize coordination-npx claude-flow swarm init --topology hierarchical --max-agents {{workers}}+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents {{workers}}# Spawn workers{{#each workers}}@@ -77,5 +77,5 @@ Use `/dual-collect` to gather results:Or check manually:```bash-npx claude-flow memory list --namespace results+npx @claude-flow/cli@latest memory list --namespace results```diff --git a/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md b/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.mdindex 4b87d1000b..d985dd05e8 100644--- a/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md+++ b/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md@@ -29,12 +29,12 @@ Cross-package integration testing and deployment coordination.### Initialize Multi-Repo Coordination```bash# Basic swarm initialization-npx claude-flow skill run github-multi-repo init \+npx @claude-flow/cli@latest skill run github-multi-repo init \--repos "org/frontend,org/backend,org/shared" \--topology hierarchical# Advanced initialization with synchronization-npx claude-flow skill run github-multi-repo init \+npx @claude-flow/cli@latest skill run github-multi-repo init \--repos "org/frontend,org/backend,org/shared" \--topology mesh \--shared-memory \@@ -44,7 +44,7 @@ npx claude-flow skill run github-multi-repo init \### Synchronize Packages```bash# Synchronize package versions and dependencies-npx claude-flow skill run github-multi-repo sync \+npx @claude-flow/cli@latest skill run github-multi-repo sync \--packages "claude-code-flow,ruv-swarm" \--align-versions \--update-docs@@ -53,7 +53,7 @@ npx claude-flow skill run github-multi-repo sync \### Optimize Architecture```bash# Analyze and optimize repository structure-npx claude-flow skill run github-multi-repo optimize \+npx @claude-flow/cli@latest skill run github-multi-repo optimize \--analyze-structure \--suggest-improvements \--create-templates@@ -577,7 +577,7 @@ kafka:### 1. Microservices Coordination```bash-npx claude-flow skill run github-multi-repo microservices \+npx @claude-flow/cli@latest skill run github-multi-repo microservices \--services "auth,users,orders,payments" \--ensure-compatibility \--sync-contracts \@@ -586,7 +586,7 @@ npx claude-flow skill run github-multi-repo microservices \### 2. Library Updates```bash-npx claude-flow skill run github-multi-repo lib-update \+npx @claude-flow/cli@latest skill run github-multi-repo lib-update \--library "org/shared-lib" \--version "2.0.0" \--find-consumers \@@ -596,7 +596,7 @@ npx claude-flow skill run github-multi-repo lib-update \### 3. Organization-Wide Changes```bash-npx claude-flow skill run github-multi-repo org-policy \+npx @claude-flow/cli@latest skill run github-multi-repo org-policy \--policy "add-security-headers" \--repos "org/*" \--validate-compliance \@@ -662,7 +662,7 @@ ruv-FANN/### Multi-Repo Dashboard```bash-npx claude-flow skill run github-multi-repo dashboard \+npx @claude-flow/cli@latest skill run github-multi-repo dashboard \--port 3000 \--metrics "agent-activity,task-progress,memory-usage" \--real-time@@ -670,7 +670,7 @@ npx claude-flow skill run github-multi-repo dashboard \### Dependency Graph```bash-npx claude-flow skill run github-multi-repo dep-graph \+npx @claude-flow/cli@latest skill run github-multi-repo dep-graph \--format mermaid \--include-agents \--show-data-flow@@ -678,7 +678,7 @@ npx claude-flow skill run github-multi-repo dep-graph \### Health Monitoring```bash-npx claude-flow skill run github-multi-repo health-check \+npx @claude-flow/cli@latest skill run github-multi-repo health-check \--repos "org/*" \--check "connectivity,memory,agents" \--alert-on-issues@@ -718,7 +718,7 @@ npx claude-flow skill run github-multi-repo health-check \### Caching Strategy```bash-npx claude-flow skill run github-multi-repo cache-strategy \+npx @claude-flow/cli@latest skill run github-multi-repo cache-strategy \--analyze-patterns \--suggest-cache-layers \--implement-invalidation@@ -726,7 +726,7 @@ npx claude-flow skill run github-multi-repo cache-strategy \### Parallel Execution```bash-npx claude-flow skill run github-multi-repo parallel-optimize \+npx @claude-flow/cli@latest skill run github-multi-repo parallel-optimize \--analyze-dependencies \--identify-parallelizable \--execute-optimal@@ -734,7 +734,7 @@ npx claude-flow skill run github-multi-repo parallel-optimize \### Resource Pooling```bash-npx claude-flow skill run github-multi-repo resource-pool \+npx @claude-flow/cli@latest skill run github-multi-repo resource-pool \--share-agents \--distribute-load \--monitor-usage@@ -744,7 +744,7 @@ npx claude-flow skill run github-multi-repo resource-pool \### Connectivity Issues```bash-npx claude-flow skill run github-multi-repo diagnose-connectivity \+npx @claude-flow/cli@latest skill run github-multi-repo diagnose-connectivity \--test-all-repos \--check-permissions \--verify-webhooks@@ -752,7 +752,7 @@ npx claude-flow skill run github-multi-repo diagnose-connectivity \### Memory Synchronization```bash-npx claude-flow skill run github-multi-repo debug-memory \+npx @claude-flow/cli@latest skill run github-multi-repo debug-memory \--check-consistency \--identify-conflicts \--repair-state@@ -760,7 +760,7 @@ npx claude-flow skill run github-multi-repo debug-memory \### Performance Bottlenecks```bash-npx claude-flow skill run github-multi-repo perf-analysis \+npx @claude-flow/cli@latest skill run github-multi-repo perf-analysis \--profile-operations \--identify-bottlenecks \--suggest-optimizations@@ -770,7 +770,7 @@ npx claude-flow skill run github-multi-repo perf-analysis \### 1. Distributed Task Queue```bash-npx claude-flow skill run github-multi-repo queue \+npx @claude-flow/cli@latest skill run github-multi-repo queue \--backend redis \--workers 10 \--priority-routing \@@ -779,7 +779,7 @@ npx claude-flow skill run github-multi-repo queue \### 2. Cross-Repo Testing```bash-npx claude-flow skill run github-multi-repo test \+npx @claude-flow/cli@latest skill run github-multi-repo test \--setup-test-env \--link-services \--run-e2e \@@ -788,7 +788,7 @@ npx claude-flow skill run github-multi-repo test \### 3. Monorepo Migration```bash-npx claude-flow skill run github-multi-repo to-monorepo \+npx @claude-flow/cli@latest skill run github-multi-repo to-monorepo \--analyze-repos \--suggest-structure \--preserve-history \@@ -799,7 +799,7 @@ npx claude-flow skill run github-multi-repo to-monorepo \### Full-Stack Application Update```bash-npx claude-flow skill run github-multi-repo fullstack-update \+npx @claude-flow/cli@latest skill run github-multi-repo fullstack-update \--frontend "org/web-app" \--backend "org/api-server" \--database "org/db-migrations" \@@ -808,7 +808,7 @@ npx claude-flow skill run github-multi-repo fullstack-update \### Cross-Team Collaboration```bash-npx claude-flow skill run github-multi-repo cross-team \+npx @claude-flow/cli@latest skill run github-multi-repo cross-team \--teams "frontend,backend,devops" \--task "implement-feature-x" \--assign-by-expertise \diff --git a/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md b/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.mdindex 7d2b9a23ba..6deb7098e7 100644--- a/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md+++ b/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md@@ -19,7 +19,7 @@ gh release create v2.0.0 \--title "Release v2.0.0"# Orchestrate with swarm-npx claude-flow github release-create \+npx @claude-flow/cli@latest github release-create \--version "2.0.0" \--build-artifacts \--deploy-targets "npm,docker,github"@@ -28,10 +28,10 @@ npx claude-flow github release-create \### Full Automated Release```bash# Initialize release swarm-npx claude-flow swarm init --topology hierarchical+npx @claude-flow/cli@latest swarm init --topology hierarchical# Execute complete release pipeline-npx claude-flow sparc pipeline "Release v2.0.0 with full validation"+npx @claude-flow/cli@latest sparc pipeline "Release v2.0.0 with full validation"```---@@ -212,7 +212,7 @@ COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \--jq '.commits[].commit.message')# Generate categorized changelog-npx claude-flow github changelog \+npx @claude-flow/cli@latest github changelog \--prs "$PRS" \--commits "$COMMITS" \--from v1.0.0 \@@ -231,7 +231,7 @@ npx claude-flow github changelog \#### Version Agent```bash# Intelligent version suggestion-npx claude-flow github version-suggest \+npx @claude-flow/cli@latest github version-suggest \--current v1.2.3 \--analyze-commits \--check-compatibility \@@ -248,7 +248,7 @@ npx claude-flow github version-suggest \#### Build Agent```bash# Multi-platform build coordination-npx claude-flow github release-build \+npx @claude-flow/cli@latest github release-build \--platforms "linux,macos,windows" \--architectures "x64,arm64" \--parallel \@@ -265,7 +265,7 @@ npx claude-flow github release-build \#### Test Agent```bash# Comprehensive pre-release testing-npx claude-flow github release-test \+npx @claude-flow/cli@latest github release-test \--suites "unit,integration,e2e,performance" \--environments "node:16,node:18,node:20" \--fail-fast false \@@ -275,7 +275,7 @@ npx claude-flow github release-test \#### Deploy Agent```bash# Multi-target deployment orchestration-npx claude-flow github release-deploy \+npx @claude-flow/cli@latest github release-deploy \--targets "npm,docker,github,s3" \--staged-rollout \--monitor-metrics \@@ -352,7 +352,7 @@ deployment:#### Execute Staged Deployment```bash# Deploy with progressive rollout-npx claude-flow github release-deploy \+npx @claude-flow/cli@latest github release-deploy \--version v2.0.0 \--strategy progressive \--config .github/release-deployment.yml \@@ -365,7 +365,7 @@ npx claude-flow github release-deploy \#### Coordinated Multi-Repo Release```bash# Synchronize releases across repositories-npx claude-flow github multi-release \+npx @claude-flow/cli@latest github multi-release \--repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \--ensure-compatibility \--atomic-release \@@ -399,7 +399,7 @@ npx claude-flow github multi-release \#### Emergency Hotfix Workflow```bash# Fast-track critical bug fix-npx claude-flow github emergency-release \+npx @claude-flow/cli@latest github emergency-release \--issue 789 \--severity critical \--target-version v1.2.4 \@@ -561,7 +561,7 @@ release:#### Comprehensive Validation Suite```bash# Pre-release validation with all checks-npx claude-flow github release-validate \+npx @claude-flow/cli@latest github release-validate \--checks "version-conflicts,dependency-compatibility,@@ -580,7 +580,7 @@ npx claude-flow github release-validate \#### Backward Compatibility Testing```bash# Test against previous versions-npx claude-flow github compat-test \+npx @claude-flow/cli@latest github compat-test \--previous-versions "v1.0,v1.1,v1.2" \--api-contracts \--data-migrations \@@ -591,7 +591,7 @@ npx claude-flow github compat-test \#### Performance Regression Detection```bash# Benchmark against baseline-npx claude-flow github performance-test \+npx @claude-flow/cli@latest github performance-test \--baseline v1.9.0 \--candidate v2.0.0 \--metrics "throughput,latency,memory,cpu" \@@ -604,7 +604,7 @@ npx claude-flow github performance-test \#### Real-Time Release Monitoring```bash# Monitor release health post-deployment-npx claude-flow github release-monitor \+npx @claude-flow/cli@latest github release-monitor \--version v2.0.0 \--metrics "error-rate,latency,throughput,adoption" \--alert-thresholds \@@ -615,7 +615,7 @@ npx claude-flow github release-monitor \#### Release Analytics & Insights```bash# Analyze release performance and adoption-npx claude-flow github release-analytics \+npx @claude-flow/cli@latest github release-analytics \--version v2.0.0 \--compare-with v1.9.0 \--metrics "adoption,performance,stability,feedback" \@@ -626,7 +626,7 @@ npx claude-flow github release-analytics \#### Automated Rollback Configuration```bash# Configure intelligent auto-rollback-npx claude-flow github rollback-config \+npx @claude-flow/cli@latest github rollback-config \--triggers '{"error-rate": ">5%","latency-p99": ">1000ms",@@ -643,7 +643,7 @@ npx claude-flow github rollback-config \#### Security Scanning```bash# Comprehensive security validation-npx claude-flow github release-security \+npx @claude-flow/cli@latest github release-security \--scan-dependencies \--check-secrets \--audit-permissions \@@ -655,7 +655,7 @@ npx claude-flow github release-security \#### Compliance Validation```bash# Ensure regulatory compliance-npx claude-flow github release-compliance \+npx @claude-flow/cli@latest github release-compliance \--standards "SOC2,GDPR,HIPAA" \--license-audit \--data-governance \diff --git a/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md b/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.mdindex 7acce959ef..9cd019b9ac 100644--- a/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md+++ b/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md@@ -38,7 +38,7 @@ This skill provides a comprehensive hook system that automatically manages devel```bash# Initialize with default hooks configuration-npx claude-flow init --hooks+npx @claude-flow/cli@latest init --hooks```This creates:@@ -50,13 +50,13 @@ This creates:```bash# Pre-task hook (auto-spawns agents)-npx claude-flow hook pre-task --description "Implement authentication"+npx @claude-flow/cli@latest hook pre-task --description "Implement authentication"# Post-edit hook (auto-formats and stores in memory)-npx claude-flow hook post-edit --file "src/auth.js" --memory-key "auth/login"+npx @claude-flow/cli@latest hook post-edit --file "src/auth.js" --memory-key "auth/login"# Session end hook (saves state and metrics)-npx claude-flow hook session-end --session-id "dev-session" --export-metrics+npx @claude-flow/cli@latest hook session-end --session-id "dev-session" --export-metrics```---@@ -71,7 +71,7 @@ Hooks that execute BEFORE operations to prepare and validate:**pre-edit** - Validate and assign agents before file modifications```bash-npx claude-flow hook pre-edit [options]+npx @claude-flow/cli@latest hook pre-edit [options]Options:--file, -f <path> File path to be edited@@ -81,9 +81,9 @@ Options:--backup-file Create backup before editingExamples:- npx claude-flow hook pre-edit --file "src/auth/login.js"- npx claude-flow hook pre-edit -f "config/db.js" --validate-syntax- npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts+ npx @claude-flow/cli@latest hook pre-edit --file "src/auth/login.js"+ npx @claude-flow/cli@latest hook pre-edit -f "config/db.js" --validate-syntax+ npx @claude-flow/cli@latest hook pre-edit -f "production.env" --backup-file --check-conflicts```**Features:**@@ -94,7 +94,7 @@ Examples:**pre-bash** - Check command safety and resource requirements```bash-npx claude-flow hook pre-bash --command <cmd>+npx @claude-flow/cli@latest hook pre-bash --command <cmd>Options:--command, -c <cmd> Command to validate@@ -103,8 +103,8 @@ Options:--require-confirmation Request user confirmation for risky commandsExamples:- npx claude-flow hook pre-bash -c "rm -rf /tmp/cache"- npx claude-flow hook pre-bash --command "docker build ." --estimate-resources+ npx @claude-flow/cli@latest hook pre-bash -c "rm -rf /tmp/cache"+ npx @claude-flow/cli@latest hook pre-bash --command "docker build ." --estimate-resources```**Features:**@@ -115,7 +115,7 @@ Examples:**pre-task** - Auto-spawn agents and prepare for complex tasks```bash-npx claude-flow hook pre-task [options]+npx @claude-flow/cli@latest hook pre-task [options]Options:--description, -d <text> Task description for context@@ -125,9 +125,9 @@ Options:--estimate-complexity Analyze task complexityExamples:- npx claude-flow hook pre-task --description "Implement user authentication"- npx claude-flow hook pre-task -d "Continue API dev" --load-memory- npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology+ npx @claude-flow/cli@latest hook pre-task --description "Implement user authentication"+ npx @claude-flow/cli@latest hook pre-task -d "Continue API dev" --load-memory+ npx @claude-flow/cli@latest hook pre-task -d "Refactor codebase" --optimize-topology```**Features:**@@ -138,7 +138,7 @@ Examples:**pre-search** - Prepare and optimize search operations```bash-npx claude-flow hook pre-search --query <query>+npx @claude-flow/cli@latest hook pre-search --query <query>Options:--query, -q <text> Search query@@ -146,7 +146,7 @@ Options:--optimize-query Optimize search patternExamples:- npx claude-flow hook pre-search -q "authentication middleware"+ npx @claude-flow/cli@latest hook pre-search -q "authentication middleware"```**Features:**@@ -160,7 +160,7 @@ Hooks that execute AFTER operations to process and learn:**post-edit** - Auto-format, validate, and update memory```bash-npx claude-flow hook post-edit [options]+npx @claude-flow/cli@latest hook post-edit [options]Options:--file, -f <path> File path that was edited@@ -170,9 +170,9 @@ Options:--validate-output Validate edited fileExamples:- npx claude-flow hook post-edit --file "src/components/Button.jsx"- npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login"- npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns+ npx @claude-flow/cli@latest hook post-edit --file "src/components/Button.jsx"+ npx @claude-flow/cli@latest hook post-edit -f "api/auth.js" --memory-key "auth/login"+ npx @claude-flow/cli@latest hook post-edit -f "utils/helpers.ts" --train-patterns```**Features:**@@ -183,7 +183,7 @@ Examples:**post-bash** - Log execution and update metrics```bash-npx claude-flow hook post-bash --command <cmd>+npx @claude-flow/cli@latest hook post-bash --command <cmd>Options:--command, -c <cmd> Command that was executed@@ -192,7 +192,7 @@ Options:--store-result Store result in memoryExamples:- npx claude-flow hook post-bash -c "npm test" --update-metrics+ npx @claude-flow/cli@latest hook post-bash -c "npm test" --update-metrics```**Features:**@@ -203,7 +203,7 @@ Examples:**post-task** - Performance analysis and decision storage```bash-npx claude-flow hook post-task [options]+npx @claude-flow/cli@latest hook post-task [options]Options:--task-id, -t <id> Task identifier for tracking@@ -213,9 +213,9 @@ Options:--generate-report Create task completion reportExamples:- npx claude-flow hook post-task --task-id "auth-implementation"- npx claude-flow hook post-task -t "api-refactor" --analyze-performance- npx claude-flow hook post-task -t "bug-fix-123" --store-decisions+ npx @claude-flow/cli@latest hook post-task --task-id "auth-implementation"+ npx @claude-flow/cli@latest hook post-task -t "api-refactor" --analyze-performance+ npx @claude-flow/cli@latest hook post-task -t "bug-fix-123" --store-decisions```**Features:**@@ -226,7 +226,7 @@ Examples:**post-search** - Cache results and improve patterns```bash-npx claude-flow hook post-search --query <query> --results <path>+npx @claude-flow/cli@latest hook post-search --query <query> --results <path>Options:--query, -q <text> Original search query@@ -235,7 +235,7 @@ Options:--train-patterns Improve search patternsExamples:- npx claude-flow hook post-search -q "auth" -r "results.json" --train-patterns+ npx @claude-flow/cli@latest hook post-search -q "auth" -r "results.json" --train-patterns```**Features:**@@ -249,7 +249,7 @@ Hooks that coordinate with MCP swarm tools:**mcp-initialized** - Persist swarm configuration```bash-npx claude-flow hook mcp-initialized --swarm-id <id>+npx @claude-flow/cli@latest hook mcp-initialized --swarm-id <id>Features:- Save swarm topology and configuration@@ -259,7 +259,7 @@ Features:**agent-spawned** - Update agent roster and memory```bash-npx claude-flow hook agent-spawned --agent-id <id> --type <type>+npx @claude-flow/cli@latest hook agent-spawned --agent-id <id> --type <type>Features:- Register agent in coordination memory@@ -269,7 +269,7 @@ Features:**task-orchestrated** - Monitor task progress```bash-npx claude-flow hook task-orchestrated --task-id <id>+npx @claude-flow/cli@latest hook task-orchestrated --task-id <id>Features:- Track task progress through memory@@ -279,7 +279,7 @@ Features:**neural-trained** - Save pattern improvements```bash-npx claude-flow hook neural-trained --pattern <name>+npx @claude-flow/cli@latest hook neural-trained --pattern <name>Features:- Export trained neural patterns@@ -309,7 +309,7 @@ Features:**memory-sync** - Synchronize memory across swarm agents```bash-npx claude-flow hook memory-sync --namespace <ns>+npx @claude-flow/cli@latest hook memory-sync --namespace <ns>Features:- Sync memory state across agents@@ -322,7 +322,7 @@ Features:**session-start** - Initialize new session```bash-npx claude-flow hook session-start --session-id <id>+npx @claude-flow/cli@latest hook session-start --session-id <id>Options:--session-id, -s <id> Session identifier@@ -338,7 +338,7 @@ Features:**session-restore** - Load previous session state```bash-npx claude-flow hook session-restore --session-id <id>+npx @claude-flow/cli@latest hook session-restore --session-id <id>Options:--session-id, -s <id> Session to restore@@ -346,8 +346,8 @@ Options:--restore-agents Restore agent configurationsExamples:- npx claude-flow hook session-restore --session-id "swarm-20241019"- npx claude-flow hook session-restore -s "feature-auth" --restore-memory+ npx @claude-flow/cli@latest hook session-restore --session-id "swarm-20241019"+ npx @claude-flow/cli@latest hook session-restore -s "feature-auth" --restore-memory```**Features:**@@ -358,7 +358,7 @@ Examples:**session-end** - Cleanup and persist session state```bash-npx claude-flow hook session-end [options]+npx @claude-flow/cli@latest hook session-end [options]Options:--session-id, -s <id> Session identifier to end@@ -368,9 +368,9 @@ Options:--cleanup-temp Remove temporary filesExamples:- npx claude-flow hook session-end --session-id "dev-session-2024"- npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary- npx claude-flow hook session-end -s "quick-fix" --cleanup-temp+ npx @claude-flow/cli@latest hook session-end --session-id "dev-session-2024"+ npx @claude-flow/cli@latest hook session-end -s "feature-auth" --export-metrics --generate-summary+ npx @claude-flow/cli@latest hook session-end -s "quick-fix" --cleanup-temp```**Features:**@@ -381,7 +381,7 @@ Examples:**notify** - Custom notifications with swarm status```bash-npx claude-flow hook notify --message <msg>+npx @claude-flow/cli@latest hook notify --message <msg>Options:--message, -m <text> Notification message@@ -390,8 +390,8 @@ Options:--broadcast Send to all agentsExamples:- npx claude-flow hook notify -m "Task completed" --level info- npx claude-flow hook notify -m "Critical error" --level error --broadcast+ npx @claude-flow/cli@latest hook notify -m "Task completed" --level info+ npx @claude-flow/cli@latest hook notify -m "Critical error" --level error --broadcast```**Features:**@@ -414,14 +414,14 @@ Edit `.claude/settings.json` to configure hooks:"matcher": "^(Write|Edit|MultiEdit)$","hooks": [{"type": "command",- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/current'"+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/current'"}]},{"matcher": "^Bash$","hooks": [{"type": "command",- "command": "npx claude-flow hook pre-bash --command '${tool.params.command}'"+ "command": "npx @claude-flow/cli@latest hook pre-bash --command '${tool.params.command}'"}]}],@@ -430,14 +430,14 @@ Edit `.claude/settings.json` to configure hooks:"matcher": "^(Write|Edit|MultiEdit)$","hooks": [{"type": "command",- "command": "npx claude-flow hook post-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/complete' --auto-format --train-patterns"+ "command": "npx @claude-flow/cli@latest hook post-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/complete' --auto-format --train-patterns"}]},{"matcher": "^Bash$","hooks": [{"type": "command",- "command": "npx claude-flow hook post-bash --command '${tool.params.command}' --update-metrics"+ "command": "npx @claude-flow/cli@latest hook post-bash --command '${tool.params.command}' --update-metrics"}]}]@@ -462,7 +462,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}' --auto-assign-agent --validate-syntax",+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}' --auto-assign-agent --validate-syntax","timeout": 3000,"continueOnError": true}@@ -473,7 +473,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook pre-task --description '${tool.params.task}' --auto-spawn-agents --load-memory",+ "command": "npx @claude-flow/cli@latest hook pre-task --description '${tool.params.task}' --auto-spawn-agents --load-memory","async": true}]@@ -483,7 +483,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook pre-search --query '${tool.params.pattern}' --check-cache"+ "command": "npx @claude-flow/cli@latest hook pre-search --query '${tool.params.pattern}' --check-cache"}]}@@ -495,7 +495,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook post-edit --file '${tool.params.file_path}' --memory-key 'edits/${tool.params.file_path}' --auto-format --train-patterns",+ "command": "npx @claude-flow/cli@latest hook post-edit --file '${tool.params.file_path}' --memory-key 'edits/${tool.params.file_path}' --auto-format --train-patterns","async": true}]@@ -505,7 +505,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook post-task --task-id '${result.task_id}' --analyze-performance --store-decisions --export-learnings",+ "command": "npx @claude-flow/cli@latest hook post-task --task-id '${result.task_id}' --analyze-performance --store-decisions --export-learnings","async": true}]@@ -515,7 +515,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook post-search --query '${tool.params.pattern}' --cache-results --train-patterns"+ "command": "npx @claude-flow/cli@latest hook post-search --query '${tool.params.pattern}' --cache-results --train-patterns"}]}@@ -526,7 +526,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook session-start --session-id '${session.id}' --load-context"+ "command": "npx @claude-flow/cli@latest hook session-start --session-id '${session.id}' --load-context"}]}@@ -537,7 +537,7 @@ Complete hook configuration with all features:"hooks": [{"type": "command",- "command": "npx claude-flow hook session-end --session-id '${session.id}' --export-metrics --generate-summary --cleanup-temp"+ "command": "npx @claude-flow/cli@latest hook session-end --session-id '${session.id}' --export-metrics --generate-summary --cleanup-temp"}]}@@ -559,7 +559,7 @@ Add protection for sensitive files:"hooks": [{"type": "command",- "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"+ "command": "npx @claude-flow/cli@latest hook check-protected --file '${tool.params.file_path}'"}]}@@ -599,7 +599,7 @@ Hooks automatically integrate with MCP tools for coordination:```javascript// Hook command-npx claude-flow hook pre-task --description "Build REST API"+npx @claude-flow/cli@latest hook pre-task --description "Build REST API"// Internally calls MCP tools:mcp__claude-flow__agent_spawn {@@ -623,7 +623,7 @@ mcp__claude-flow__memory_usage {```javascript// Hook command-npx claude-flow hook post-edit --file "api/auth.js"+npx @claude-flow/cli@latest hook post-edit --file "api/auth.js"// Internally calls MCP tools:mcp__claude-flow__memory_usage {@@ -649,7 +649,7 @@ mcp__claude-flow__neural_train {```javascript// Hook command-npx claude-flow hook session-end --session-id "dev-2024"+npx @claude-flow/cli@latest hook session-end --session-id "dev-2024"// Internally calls MCP tools:mcp__claude-flow__memory_persist {@@ -776,7 +776,7 @@ FILES=$(git diff --cached --name-only --diff-filter=ACM)for FILE in $FILES; do# Run pre-edit hook for validation- npx claude-flow hook pre-edit --file "$FILE" --validate-syntax+ npx @claude-flow/cli@latest hook pre-edit --file "$FILE" --validate-syntaxif [ $? -ne 0 ]; thenecho "Validation failed for $FILE"@@ -784,7 +784,7 @@ for FILE in $FILES; dofi# Run post-edit hook for formatting- npx claude-flow hook post-edit --file "$FILE" --auto-format+ npx @claude-flow/cli@latest hook post-edit --file "$FILE" --auto-formatdone# Run tests@@ -803,7 +803,7 @@ exit $?COMMIT_HASH=$(git rev-parse HEAD)COMMIT_MSG=$(git log -1 --pretty=%B)-npx claude-flow hook notify \+npx @claude-flow/cli@latest hook notify \--message "Commit completed: $COMMIT_MSG" \--level info \--swarm-status@@ -820,12 +820,12 @@ npx claude-flow hook notify \npm run test:all# Run quality checks-npx claude-flow hook session-end \+npx @claude-flow/cli@latest hook session-end \--generate-report \--export-metrics# Verify quality thresholds-TRUTH_SCORE=$(npx claude-flow metrics score --format json | jq -r '.truth_score')+TRUTH_SCORE=$(npx @claude-flow/cli@latest metrics score --format json | jq -r '.truth_score')if (( $(echo "$TRUTH_SCORE < 0.95" | bc -l) )); thenecho "Truth score below threshold: $TRUTH_SCORE < 0.95"@@ -844,13 +844,13 @@ How agents use hooks for coordination:```bash# Agent 1: Backend Developer# STEP 1: Pre-task preparation-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Implement user authentication API" \--auto-spawn-agents \--load-memory# STEP 2: Work begins - pre-edit validation-npx claude-flow hook pre-edit \+npx @claude-flow/cli@latest hook pre-edit \--file "api/auth.js" \--auto-assign-agent \--validate-syntax@@ -859,20 +859,20 @@ npx claude-flow hook pre-edit \# ... code changes ...# STEP 4: Post-edit processing-npx claude-flow hook post-edit \+npx @claude-flow/cli@latest hook post-edit \--file "api/auth.js" \--memory-key "swarm/backend/auth-api" \--auto-format \--train-patterns# STEP 5: Notify coordination system-npx claude-flow hook notify \+npx @claude-flow/cli@latest hook notify \--message "Auth API implementation complete" \--swarm-status \--broadcast# STEP 6: Task completion-npx claude-flow hook post-task \+npx @claude-flow/cli@latest hook post-task \--task-id "auth-api" \--analyze-performance \--store-decisions \@@ -882,25 +882,25 @@ npx claude-flow hook post-task \```bash# Agent 2: Test Engineer (receives notification)# STEP 1: Check memory for API details-npx claude-flow hook session-restore \+npx @claude-flow/cli@latest hook session-restore \--session-id "swarm-current" \--restore-memory# Memory contains: swarm/backend/auth-api with implementation details# STEP 2: Generate tests-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Write tests for auth API" \--load-memory# STEP 3: Create test file-npx claude-flow hook post-edit \+npx @claude-flow/cli@latest hook post-edit \--file "api/auth.test.js" \--memory-key "swarm/testing/auth-api-tests" \--train-patterns# STEP 4: Share test results-npx claude-flow hook notify \+npx @claude-flow/cli@latest hook notify \--message "Auth API tests complete - 100% coverage" \--broadcast```@@ -979,37 +979,37 @@ module.exports = {```bash# Session start - initialize coordination-npx claude-flow hook session-start --session-id "fullstack-feature"+npx @claude-flow/cli@latest hook session-start --session-id "fullstack-feature"# Pre-task planning-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Build user profile feature - frontend + backend + tests" \--auto-spawn-agents \--optimize-topology# Backend work-npx claude-flow hook pre-edit --file "api/profile.js"+npx @claude-flow/cli@latest hook pre-edit --file "api/profile.js"# ... implement backend ...-npx claude-flow hook post-edit \+npx @claude-flow/cli@latest hook post-edit \--file "api/profile.js" \--memory-key "profile/backend" \--train-patterns# Frontend work (reads backend details from memory)-npx claude-flow hook pre-edit --file "components/Profile.jsx"+npx @claude-flow/cli@latest hook pre-edit --file "components/Profile.jsx"# ... implement frontend ...-npx claude-flow hook post-edit \+npx @claude-flow/cli@latest hook post-edit \--file "components/Profile.jsx" \--memory-key "profile/frontend" \--train-patterns# Testing (reads both backend and frontend from memory)-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Test profile feature" \--load-memory# Session end - export everything-npx claude-flow hook session-end \+npx @claude-flow/cli@latest hook session-end \--session-id "fullstack-feature" \--export-metrics \--generate-summary@@ -1019,39 +1019,39 @@ npx claude-flow hook session-end \```bash# Start debugging session-npx claude-flow hook session-start --session-id "debug-memory-leak"+npx @claude-flow/cli@latest hook session-start --session-id "debug-memory-leak"# Pre-task: analyze issue-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Debug memory leak in event handlers" \--load-memory \--estimate-complexity# Search for event emitters-npx claude-flow hook pre-search --query "EventEmitter"+npx @claude-flow/cli@latest hook pre-search --query "EventEmitter"# ... search executes ...-npx claude-flow hook post-search \+npx @claude-flow/cli@latest hook post-search \--query "EventEmitter" \--cache-results# Fix the issue-npx claude-flow hook pre-edit \+npx @claude-flow/cli@latest hook pre-edit \--file "services/events.js" \--backup-file# ... fix code ...-npx claude-flow hook post-edit \+npx @claude-flow/cli@latest hook post-edit \--file "services/events.js" \--memory-key "debug/memory-leak-fix" \--validate-output# Verify fix-npx claude-flow hook post-task \+npx @claude-flow/cli@latest hook post-task \--task-id "memory-leak-fix" \--analyze-performance \--generate-report# End session-npx claude-flow hook session-end \+npx @claude-flow/cli@latest hook session-end \--session-id "debug-memory-leak" \--export-metrics```@@ -1060,27 +1060,27 @@ npx claude-flow hook session-end \```bash# Initialize swarm for refactoring-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Refactor legacy codebase to modern patterns" \--auto-spawn-agents \--optimize-topology# Agent 1: Code Analyzer-npx claude-flow hook pre-task --description "Analyze code complexity"+npx @claude-flow/cli@latest hook pre-task --description "Analyze code complexity"# ... analysis ...-npx claude-flow hook post-task \+npx @claude-flow/cli@latest hook post-task \--task-id "analysis" \--store-decisions# Agent 2: Refactoring (reads analysis from memory)-npx claude-flow hook session-restore \+npx @claude-flow/cli@latest hook session-restore \--session-id "swarm-refactor" \--restore-memoryfor file in src/**/*.js; do- npx claude-flow hook pre-edit --file "$file" --backup-file+ npx @claude-flow/cli@latest hook pre-edit --file "$file" --backup-file# ... refactor ...- npx claude-flow hook post-edit \+ npx @claude-flow/cli@latest hook post-edit \--file "$file" \--memory-key "refactor/$file" \--auto-format \@@ -1088,12 +1088,12 @@ for file in src/**/*.js; dodone# Agent 3: Testing (reads refactored code from memory)-npx claude-flow hook pre-task \+npx @claude-flow/cli@latest hook pre-task \--description "Generate tests for refactored code" \--load-memory# Broadcast completion-npx claude-flow hook notify \+npx @claude-flow/cli@latest hook notify \--message "Refactoring complete - all tests passing" \--broadcast```@@ -1117,13 +1117,13 @@ Enable debug mode for troubleshooting:export CLAUDE_FLOW_DEBUG=true# Test specific hook with verbose output-npx claude-flow hook pre-edit --file "test.js" --debug+npx @claude-flow/cli@latest hook pre-edit --file "test.js" --debug# Check hook execution logscat .claude-flow/logs/hooks-$(date +%Y-%m-%d).log# Validate configuration-npx claude-flow hook validate-config+npx @claude-flow/cli@latest hook validate-config```### Benefits@@ -1183,12 +1183,12 @@ npx claude-flow hook validate-config### Related Commands-- `npx claude-flow init --hooks` - Initialize hooks system-- `npx claude-flow hook --list` - List available hooks-- `npx claude-flow hook --test <hook>` - Test specific hook-- `npx claude-flow memory usage` - Manage memory-- `npx claude-flow agent spawn` - Spawn agents-- `npx claude-flow swarm init` - Initialize swarm+- `npx @claude-flow/cli@latest init --hooks` - Initialize hooks system+- `npx @claude-flow/cli@latest hook --list` - List available hooks+- `npx @claude-flow/cli@latest hook --test <hook>` - Test specific hook+- `npx @claude-flow/cli@latest memory usage` - Manage memory+- `npx @claude-flow/cli@latest agent spawn` - Spawn agents+- `npx @claude-flow/cli@latest swarm init` - Initialize swarm### Integration with Other Skillsdiff --git a/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md b/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.mdindex ab343f9525..743e868130 100644--- a/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md+++ b/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md@@ -472,28 +472,28 @@ mcp__claude-flow__swarm_monitor {```bash# Execute specific mode-npx claude-flow sparc run <mode> "task description"+npx @claude-flow/cli@latest sparc run <mode> "task description"# Use alpha featuresnpx claude-flow@alpha sparc run <mode> "task description"# List all available modes-npx claude-flow sparc modes+npx @claude-flow/cli@latest sparc modes# Get help for specific mode-npx claude-flow sparc help <mode>+npx @claude-flow/cli@latest sparc help <mode># Run with options-npx claude-flow sparc run <mode> "task" --parallel --monitor+npx @claude-flow/cli@latest sparc run <mode> "task" --parallel --monitor# Execute TDD workflow-npx claude-flow sparc tdd "feature description"+npx @claude-flow/cli@latest sparc tdd "feature description"# Batch execution-npx claude-flow sparc batch <mode1,mode2,mode3> "task"+npx @claude-flow/cli@latest sparc batch <mode1,mode2,mode3> "task"# Pipeline execution-npx claude-flow sparc pipeline "task description"+npx @claude-flow/cli@latest sparc pipeline "task description"```### Method 3: Local Installation@@ -911,58 +911,58 @@ mcp__claude-flow__sparc_mode {```bash# Step 1: Research and planning-npx claude-flow sparc run researcher "authentication patterns"+npx @claude-flow/cli@latest sparc run researcher "authentication patterns"# Step 2: Architecture design-npx claude-flow sparc run architect "design auth system"+npx @claude-flow/cli@latest sparc run architect "design auth system"# Step 3: TDD implementation-npx claude-flow sparc tdd "user authentication feature"+npx @claude-flow/cli@latest sparc tdd "user authentication feature"# Step 4: Code review-npx claude-flow sparc run reviewer "review auth implementation"+npx @claude-flow/cli@latest sparc run reviewer "review auth implementation"# Step 5: Documentation-npx claude-flow sparc run documenter "document auth API"+npx @claude-flow/cli@latest sparc run documenter "document auth API"```### Workflow 2: Bug Investigation```bash# Step 1: Analyze issue-npx claude-flow sparc run analyzer "investigate bug #456"+npx @claude-flow/cli@latest sparc run analyzer "investigate bug #456"# Step 2: Debug systematically-npx claude-flow sparc run debugger "fix memory leak in service X"+npx @claude-flow/cli@latest sparc run debugger "fix memory leak in service X"# Step 3: Create tests-npx claude-flow sparc run tester "regression tests for bug #456"+npx @claude-flow/cli@latest sparc run tester "regression tests for bug #456"# Step 4: Review fix-npx claude-flow sparc run reviewer "validate bug fix"+npx @claude-flow/cli@latest sparc run reviewer "validate bug fix"```### Workflow 3: Performance Optimization```bash# Step 1: Profile performance-npx claude-flow sparc run analyzer "profile API response times"+npx @claude-flow/cli@latest sparc run analyzer "profile API response times"# Step 2: Identify bottlenecks-npx claude-flow sparc run optimizer "optimize database queries"+npx @claude-flow/cli@latest sparc run optimizer "optimize database queries"# Step 3: Implement improvements-npx claude-flow sparc run coder "implement caching layer"+npx @claude-flow/cli@latest sparc run coder "implement caching layer"# Step 4: Benchmark results-npx claude-flow sparc run tester "performance benchmarks"+npx @claude-flow/cli@latest sparc run tester "performance benchmarks"```### Workflow 4: Complete Pipeline```bash# Execute full development pipeline-npx claude-flow sparc pipeline "e-commerce checkout feature"+npx @claude-flow/cli@latest sparc pipeline "e-commerce checkout feature"# This automatically runs:# 1. researcher - Gather requirements@@ -1070,19 +1070,19 @@ mcp__claude-flow__token_usage {```bash# List modes-npx claude-flow sparc modes+npx @claude-flow/cli@latest sparc modes# Run specific mode-npx claude-flow sparc run <mode> "task"+npx @claude-flow/cli@latest sparc run <mode> "task"# TDD workflow-npx claude-flow sparc tdd "feature"+npx @claude-flow/cli@latest sparc tdd "feature"# Full pipeline-npx claude-flow sparc pipeline "task"+npx @claude-flow/cli@latest sparc pipeline "task"# Batch execution-npx claude-flow sparc batch <modes> "task"+npx @claude-flow/cli@latest sparc batch <modes> "task"```### Most Common MCP Callsdiff --git a/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md b/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.mdindex 478558e0fc..52d979c9ba 100644--- a/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md+++ b/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md@@ -237,7 +237,7 @@ mcp__claude-flow__workflow_execute({### CLI Fallback```bash# Quick research swarm-npx claude-flow swarm "research AI trends in 2025" \+npx @claude-flow/cli@latest swarm "research AI trends in 2025" \--strategy research \--mode distributed \--max-agents 6 \@@ -381,7 +381,7 @@ mcp__claude-flow__pipeline_create({### CLI Fallback```bash# Quick development swarm-npx claude-flow swarm "build REST API with authentication" \+npx @claude-flow/cli@latest swarm "build REST API with authentication" \--strategy development \--mode hierarchical \--monitor \@@ -581,7 +581,7 @@ mcp__claude-flow__trend_analysis({### CLI Fallback```bash# Quick testing swarm-npx claude-flow swarm "test application comprehensively" \+npx @claude-flow/cli@latest swarm "test application comprehensively" \--strategy testing \--mode star \--parallel \