@claude-flow/cli 3.0.0-alpha.6 → 3.0.0-alpha.61

package/dist/src/init/claudemd-generator.js

@@ -9,76 +9,168 @@ export function generateClaudeMd(options) {
     const topology = options.runtime.topology;
     const maxAgents = options.runtime.maxAgents;
     const memoryBackend = options.runtime.memoryBackend;
-    return `# Claude Code Configuration - SPARC Development Environment
+    return `# Claude Code Configuration - Claude Flow V3
 
 ## 🚨 AUTOMATIC SWARM ORCHESTRATION
 
 **When starting work on complex tasks, Claude Code MUST automatically:**
 
-1. **Initialize the swarm** using MCP tools
+1. **Initialize the swarm** using CLI tools via Bash
 2. **Spawn concurrent agents** using Claude Code's Task tool
 3. **Coordinate via hooks** and memory
 
-### 🚨 CRITICAL: MCP + Task Tool in SAME Message
+### 🚨 CRITICAL: CLI + Task Tool in SAME Message
 
 **When user says "spawn swarm" or requests complex work, Claude Code MUST in ONE message:**
-1. Call MCP tools to initialize coordination
+1. Call CLI tools via Bash to initialize coordination
 2. **IMMEDIATELY** call Task tool to spawn REAL working agents
-3. Both MCP and Task calls must be in the SAME response
+3. Both CLI and Task calls must be in the SAME response
 
-**MCP alone does NOT execute work - Task tool agents do the actual work!**
+**CLI coordinates, Task tool agents do the actual work!**
 
-### 🔄 Auto-Start Swarm Protocol
+### 🔄 Auto-Start Swarm Protocol (Background Execution)
 
-When the user requests a complex task (multi-file changes, feature implementation, refactoring), **immediately execute this pattern in a SINGLE message:**
+When the user requests a complex task, **spawn agents in background and WAIT for completion:**
 
 \`\`\`javascript
-// STEP 1: Initialize swarm coordination via MCP (in parallel with agent spawning)
-mcp__claude-flow__swarm_init({
-  topology: "${topology}",
-  maxAgents: ${maxAgents},
-  strategy: "adaptive"
+// STEP 1: Initialize swarm coordination
+Bash("npx @claude-flow/cli@latest swarm init --topology ${topology} --max-agents ${maxAgents}")
+
+// STEP 2: Spawn ALL agents IN BACKGROUND in a SINGLE message
+// Use run_in_background: true so agents work concurrently
+Task({
+  prompt: "Research requirements, analyze codebase patterns, store findings in memory",
+  subagent_type: "researcher",
+  description: "Research phase",
+  run_in_background: true  // ← CRITICAL: Run in background
 })
-
-// STEP 2: Spawn agents concurrently using Claude Code's Task tool
-// ALL Task calls MUST be in the SAME message for parallel execution
-Task("Coordinator", "You are the swarm coordinator. Initialize session, coordinate other agents via memory. Run: npx claude-flow@v3alpha hooks session-start", "hierarchical-coordinator")
-Task("Researcher", "Analyze requirements and existing code patterns. Store findings in memory via hooks.", "researcher")
-Task("Architect", "Design implementation approach based on research. Document decisions in memory.", "system-architect")
-Task("Coder", "Implement the solution following architect's design. Coordinate via hooks.", "coder")
-Task("Tester", "Write tests for the implementation. Report coverage via hooks.", "tester")
-Task("Reviewer", "Review code quality and security. Document findings.", "reviewer")
-
-// STEP 3: Batch all todos
-TodoWrite({ todos: [
-  {content: "Initialize swarm coordination", status: "in_progress", activeForm: "Initializing swarm"},
-  {content: "Research and analyze requirements", status: "in_progress", activeForm: "Researching requirements"},
-  {content: "Design architecture", status: "pending", activeForm: "Designing architecture"},
-  {content: "Implement solution", status: "pending", activeForm: "Implementing solution"},
-  {content: "Write tests", status: "pending", activeForm: "Writing tests"},
-  {content: "Review and finalize", status: "pending", activeForm: "Reviewing code"}
-]})
-
-// STEP 4: Store swarm state in memory
-mcp__claude-flow__memory_usage({
-  action: "store",
-  namespace: "swarm",
-  key: "current-session",
-  value: JSON.stringify({task: "[user's task]", agents: 6, startedAt: new Date().toISOString()})
+Task({
+  prompt: "Design architecture based on research. Document decisions.",
+  subagent_type: "system-architect",
+  description: "Architecture phase",
+  run_in_background: true
+})
+Task({
+  prompt: "Implement the solution following the design. Write clean code.",
+  subagent_type: "coder",
+  description: "Implementation phase",
+  run_in_background: true
+})
+Task({
+  prompt: "Write comprehensive tests for the implementation.",
+  subagent_type: "tester",
+  description: "Testing phase",
+  run_in_background: true
 })
+Task({
+  prompt: "Review code quality, security, and best practices.",
+  subagent_type: "reviewer",
+  description: "Review phase",
+  run_in_background: true
+})
+
+// STEP 3: WAIT - Tell user agents are working, then STOP
+// Say: "I've spawned 5 agents to work on this in parallel. They'll report back when done."
+// DO NOT check status repeatedly. Just wait for user or agent responses.
 \`\`\`
 
-### 📋 Agent Routing by Task Type
+### ⏸️ CRITICAL: Spawn and Wait Pattern
+
+**After spawning background agents:**
+
+1. **TELL USER** - "I've spawned X agents working in parallel on: [list tasks]"
+2. **STOP** - Do not continue with more tool calls
+3. **WAIT** - Let the background agents complete their work
+4. **RESPOND** - When agents return results, review and synthesize
+
+**Example response after spawning:**
+\`\`\`
+I've launched 5 concurrent agents to work on this:
+- 🔍 Researcher: Analyzing requirements and codebase
+- 🏗️ Architect: Designing the implementation approach
+- 💻 Coder: Implementing the solution
+- 🧪 Tester: Writing tests
+- 👀 Reviewer: Code review and security check
+
+They're working in parallel. I'll synthesize their results when they complete.
+\`\`\`
+
+### 🚫 DO NOT:
+- Continuously check swarm status
+- Poll TaskOutput repeatedly
+- Add more tool calls after spawning
+- Ask "should I check on the agents?"
+
+### ✅ DO:
+- Spawn all agents in ONE message
+- Tell user what's happening
+- Wait for agent results to arrive
+- Synthesize results when they return
+
+## 🧠 AUTO-LEARNING PROTOCOL
+
+### Before Starting Any Task
+\`\`\`bash
+# 1. Search memory for relevant patterns from past successes
+Bash("npx @claude-flow/cli@latest memory search -q '[task keywords]' --namespace patterns")
+
+# 2. Check if similar task was done before
+Bash("npx @claude-flow/cli@latest memory search -q '[task type]' --namespace tasks")
 
-**Automatically select agents based on task:**
+# 3. Load learned optimizations
+Bash("npx @claude-flow/cli@latest hooks route --task '[task description]'")
+\`\`\`
+
+### After Completing Any Task Successfully
+\`\`\`bash
+# 1. Store successful pattern for future reference
+Bash("npx @claude-flow/cli@latest memory store --namespace patterns --key '[pattern-name]' --value '[what worked]'")
+
+# 2. Train neural patterns on the successful approach
+Bash("npx @claude-flow/cli@latest hooks post-edit --file '[main-file]' --train-neural true")
+
+# 3. Record task completion with metrics
+Bash("npx @claude-flow/cli@latest hooks post-task --task-id '[id]' --success true --store-results true")
+
+# 4. Trigger optimization worker if performance-related
+Bash("npx @claude-flow/cli@latest hooks worker dispatch --trigger optimize")
+\`\`\`
+
+### Continuous Improvement Triggers
+
+| Trigger | Worker | When to Use |
+|---------|--------|-------------|
+| After major refactor | \`optimize\` | Performance optimization |
+| After adding features | \`testgaps\` | Find missing test coverage |
+| After security changes | \`audit\` | Security analysis |
+| After API changes | \`document\` | Update documentation |
+| Every 5+ file changes | \`map\` | Update codebase map |
+| Complex debugging | \`deepdive\` | Deep code analysis |
+
+### Memory-Enhanced Development
+
+**ALWAYS check memory before:**
+- Starting a new feature (search for similar implementations)
+- Debugging an issue (search for past solutions)
+- Refactoring code (search for learned patterns)
+- Performance work (search for optimization strategies)
+
+**ALWAYS store in memory after:**
+- Solving a tricky bug (store the solution pattern)
+- Completing a feature (store the approach)
+- Finding a performance fix (store the optimization)
+- Discovering a security issue (store the vulnerability pattern)
+
+### 📋 Agent Routing by Task Type
 
 | Task Type | Required Agents | Topology |
 |-----------|-----------------|----------|
 | Bug Fix | researcher, coder, tester | mesh |
 | New Feature | coordinator, architect, coder, tester, reviewer | hierarchical |
 | Refactoring | architect, coder, reviewer | mesh |
-| Performance | researcher, coder, perf-analyzer | hierarchical |
-| Security Audit | security-manager, reviewer, tester | hierarchical |
+| Performance | researcher, performance-engineer, coder | hierarchical |
+| Security Audit | security-architect, security-auditor, reviewer | hierarchical |
+| Memory Optimization | memory-specialist, performance-engineer | mesh |
 | Documentation | researcher, api-docs | mesh |
 
 ### 🎯 Task Complexity Detection
@@ -99,36 +191,6 @@ mcp__claude-flow__memory_usage({
 - Configuration changes
 - Quick questions/exploration
 
-### 🔧 Settings Configuration
-
-The following settings are auto-configured in \`.claude/settings.json\`:
-
-\`\`\`json
-{
-  "hooks": {
-    "PreToolUse": [{
-      "matcher": "Task",
-      "commands": ["npx claude-flow@v3alpha hooks pre-task --tool Task"]
-    }],
-    "PostToolUse": [{
-      "matcher": "Task",
-      "commands": ["npx claude-flow@v3alpha hooks post-task --tool Task"]
-    }],
-    "UserPromptSubmit": [{
-      "matcher": ".*",
-      "commands": ["npx claude-flow@v3alpha hooks route-task"]
-    }]
-  },
-  "permissions": {
-    "allow": [
-      "Bash(npx claude-flow:*)",
-      "mcp__claude-flow__*",
-      "mcp__ruv-swarm__*"
-    ]
-  }
-}
-\`\`\`
-
 ## 🚨 CRITICAL: CONCURRENT EXECUTION & FILE MANAGEMENT
 
 **ABSOLUTE RULES**:
@@ -146,24 +208,6 @@ The following settings are auto-configured in \`.claude/settings.json\`:
 - **Bash commands**: ALWAYS batch ALL terminal operations in ONE message
 - **Memory operations**: ALWAYS batch ALL memory store/retrieve in ONE message
 
-### 🎯 CRITICAL: Claude Code Task Tool for Agent Execution
-
-**Claude Code's Task tool is the PRIMARY way to spawn agents:**
-\`\`\`javascript
-// ✅ CORRECT: Use Claude Code's Task tool for parallel agent execution
-[Single Message]:
-  Task("Research agent", "Analyze requirements and patterns...", "researcher")
-  Task("Coder agent", "Implement core features...", "coder")
-  Task("Tester agent", "Create comprehensive tests...", "tester")
-  Task("Reviewer agent", "Review code quality...", "reviewer")
-  Task("Architect agent", "Design system architecture...", "system-architect")
-\`\`\`
-
-**MCP tools are ONLY for coordination setup:**
-- \`mcp__claude-flow__swarm_init\` - Initialize coordination topology
-- \`mcp__claude-flow__agent_spawn\` - Define agent types for coordination
-- \`mcp__claude-flow__task_orchestrate\` - Orchestrate high-level workflows
-
 ### 📁 File Organization Rules
 
 **NEVER save to root folder. Use these directories:**
@@ -180,30 +224,81 @@ This project is configured with Claude Flow V3:
 - **Topology**: ${topology}
 - **Max Agents**: ${maxAgents}
 - **Memory Backend**: ${memoryBackend}
-- **HNSW Indexing**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
-- **Neural Learning**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
+- **HNSW Indexing**: ${options.runtime.enableHNSW ? 'Enabled (150x-12,500x faster)' : 'Disabled'}
+- **Neural Learning**: ${options.runtime.enableNeural ? 'Enabled (SONA)' : 'Disabled'}
+
+## 🚀 V3 CLI Commands (26 Commands, 140+ Subcommands)
+
+### Core Commands
+
+| Command | Subcommands | Description |
+|---------|-------------|-------------|
+| \`init\` | 4 | Project initialization with wizard, presets, skills, hooks |
+| \`agent\` | 8 | Agent lifecycle (spawn, list, status, stop, metrics, pool, health, logs) |
+| \`swarm\` | 6 | Multi-agent swarm coordination and orchestration |
+| \`memory\` | 11 | AgentDB memory with vector search (150x-12,500x faster) |
+| \`mcp\` | 9 | MCP server management and tool execution |
+| \`task\` | 6 | Task creation, assignment, and lifecycle |
+| \`session\` | 7 | Session state management and persistence |
+| \`config\` | 7 | Configuration management and provider setup |
+| \`status\` | 3 | System status monitoring with watch mode |
+| \`workflow\` | 6 | Workflow execution and template management |
+| \`hooks\` | 17 | Self-learning hooks + 12 background workers |
+| \`hive-mind\` | 6 | Queen-led Byzantine fault-tolerant consensus |
+
+### Advanced Commands
+
+| Command | Subcommands | Description |
+|---------|-------------|-------------|
+| \`daemon\` | 5 | Background worker daemon (start, stop, status, trigger, enable) |
+| \`neural\` | 5 | Neural pattern training (train, status, patterns, predict, optimize) |
+| \`security\` | 6 | Security scanning (scan, audit, cve, threats, validate, report) |
+| \`performance\` | 5 | Performance profiling (benchmark, profile, metrics, optimize, report) |
+| \`providers\` | 5 | AI providers (list, add, remove, test, configure) |
+| \`plugins\` | 5 | Plugin management (list, install, uninstall, enable, disable) |
+| \`deployment\` | 5 | Deployment management (deploy, rollback, status, environments, release) |
+| \`embeddings\` | 4 | Vector embeddings (embed, batch, search, init) - 75x faster with agentic-flow |
+| \`claims\` | 4 | Claims-based authorization (check, grant, revoke, list) |
+| \`migrate\` | 5 | V2 to V3 migration with rollback support |
+| \`doctor\` | 1 | System diagnostics with health checks |
+| \`completions\` | 4 | Shell completions (bash, zsh, fish, powershell) |
+
+### Quick CLI Examples
 
-## SPARC Workflow Phases
+\`\`\`bash
+# Initialize project
+npx @claude-flow/cli@latest init --wizard
+
+# Start daemon with background workers
+npx @claude-flow/cli@latest daemon start
+
+# Spawn an agent
+npx @claude-flow/cli@latest agent spawn -t coder --name my-coder
+
+# Initialize swarm
+npx @claude-flow/cli@latest swarm init --v3-mode
+
+# Search memory (HNSW-indexed)
+npx @claude-flow/cli@latest memory search -q "authentication patterns"
 
-1. **Specification** - Requirements analysis (\`sparc run spec-pseudocode\`)
-2. **Pseudocode** - Algorithm design (\`sparc run spec-pseudocode\`)
-3. **Architecture** - System design (\`sparc run architect\`)
-4. **Refinement** - TDD implementation (\`sparc tdd\`)
-5. **Completion** - Integration (\`sparc run integration\`)
+# System diagnostics
+npx @claude-flow/cli@latest doctor --fix
 
-## Code Style & Best Practices
+# Security scan
+npx @claude-flow/cli@latest security scan --depth full
 
-- **Modular Design**: Files under 500 lines
-- **Environment Safety**: Never hardcode secrets
-- **Test-First**: Write tests before implementation
-- **Clean Architecture**: Separate concerns
-- **Documentation**: Keep updated
+# Performance benchmark
+npx @claude-flow/cli@latest performance benchmark --suite all
+\`\`\`
 
-## 🚀 Available Agents
+## 🚀 Available Agents (60+ Types)
 
 ### Core Development
 \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
 
+### V3 Specialized Agents
+\`security-architect\`, \`security-auditor\`, \`memory-specialist\`, \`performance-engineer\`
+
 ### Swarm Coordination
 \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`, \`collective-intelligence-coordinator\`, \`swarm-memory-manager\`
 
@@ -225,347 +320,217 @@ This project is configured with Claude Flow V3:
 ### Testing & Validation
 \`tdd-london-swarm\`, \`production-validator\`
 
-## 🎯 Claude Code vs MCP Tools
+## 🪝 V3 Hooks System (17 Hooks + 12 Workers)
 
-### Claude Code Handles ALL EXECUTION:
-- **Task tool**: Spawn and run agents concurrently for actual work
-- File operations (Read, Write, Edit, MultiEdit, Glob, Grep)
-- Code generation and programming
-- Bash commands and system operations
-- Implementation work
-- Project navigation and analysis
-- TodoWrite and task management
-- Git operations
-- Package management
-- Testing and debugging
-
-### MCP Tools ONLY COORDINATE:
-- Swarm initialization (topology setup)
-- Agent type definitions (coordination patterns)
-- Task orchestration (high-level planning)
-- Memory management
-- Neural features
-- Performance tracking
-- GitHub integration
+### Hook Categories
 
-**KEY**: MCP coordinates the strategy, Claude Code's Task tool executes with real agents.
+| Category | Hooks | Purpose |
+|----------|-------|---------|
+| **Core** | \`pre-edit\`, \`post-edit\`, \`pre-command\`, \`post-command\`, \`pre-task\`, \`post-task\` | Tool lifecycle |
+| **Session** | \`session-start\`, \`session-end\`, \`session-restore\`, \`notify\` | Context management |
+| **Intelligence** | \`route\`, \`explain\`, \`pretrain\`, \`build-agents\`, \`transfer\` | Neural learning |
+| **Learning** | \`intelligence\` (trajectory-start/step/end, pattern-store/search, stats, attention) | Reinforcement |
+
+### 12 Background Workers
+
+| Worker | Priority | Description |
+|--------|----------|-------------|
+| \`ultralearn\` | normal | Deep knowledge acquisition |
+| \`optimize\` | high | Performance optimization |
+| \`consolidate\` | low | Memory consolidation |
+| \`predict\` | normal | Predictive preloading |
+| \`audit\` | critical | Security analysis |
+| \`map\` | normal | Codebase mapping |
+| \`preload\` | low | Resource preloading |
+| \`deepdive\` | normal | Deep code analysis |
+| \`document\` | normal | Auto-documentation |
+| \`refactor\` | normal | Refactoring suggestions |
+| \`benchmark\` | normal | Performance benchmarking |
+| \`testgaps\` | normal | Test coverage analysis |
 
-## 🚀 Quick Setup
+### Essential Hook Commands
 
 \`\`\`bash
-# Add MCP servers (Claude Flow required, others optional)
-claude mcp add claude-flow npx claude-flow@v3alpha mcp start
-claude mcp add ruv-swarm npx ruv-swarm mcp start  # Optional: Enhanced coordination
-claude mcp add flow-nexus npx flow-nexus@latest mcp start  # Optional: Cloud features
-\`\`\`
-
-## MCP Tool Categories
-
-### Coordination
-\`swarm_init\`, \`agent_spawn\`, \`task_orchestrate\`
-
-### Monitoring
-\`swarm_status\`, \`agent_list\`, \`agent_metrics\`, \`task_status\`, \`task_results\`
-
-### Memory & Neural
-\`memory_usage\`, \`neural_status\`, \`neural_train\`, \`neural_patterns\`
-
-### GitHub Integration
-\`github_swarm\`, \`repo_analyze\`, \`pr_enhance\`, \`issue_triage\`, \`code_review\`
-
-### System
-\`benchmark_run\`, \`features_detect\`, \`swarm_monitor\`
-
-## 🚀 Agent Execution Flow with Claude Code
+# Core hooks
+npx @claude-flow/cli@latest hooks pre-task --description "[task]"
+npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
+npx @claude-flow/cli@latest hooks post-edit --file "[file]" --train-patterns
 
-### The Correct Pattern:
+# Session management
+npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
+npx @claude-flow/cli@latest hooks session-end --export-metrics true
+npx @claude-flow/cli@latest hooks session-restore --session-id "[id]"
 
-1. **Optional**: Use MCP tools to set up coordination topology
-2. **REQUIRED**: Use Claude Code's Task tool to spawn agents that do actual work
-3. **REQUIRED**: Each agent runs hooks for coordination
-4. **REQUIRED**: Batch all operations in single messages
+# Intelligence routing
+npx @claude-flow/cli@latest hooks route --task "[task]"
+npx @claude-flow/cli@latest hooks explain --topic "[topic]"
 
-### Example Full-Stack Development:
+# Neural learning
+npx @claude-flow/cli@latest hooks pretrain --model-type moe --epochs 10
+npx @claude-flow/cli@latest hooks build-agents --agent-types coder,tester
 
-\`\`\`javascript
-// Single message with all agent spawning via Claude Code's Task tool
-[Parallel Agent Execution]:
-  Task("Backend Developer", "Build REST API with Express. Use hooks for coordination.", "backend-dev")
-  Task("Frontend Developer", "Create React UI. Coordinate with backend via memory.", "coder")
-  Task("Database Architect", "Design PostgreSQL schema. Store schema in memory.", "code-analyzer")
-  Task("Test Engineer", "Write Jest tests. Check memory for API contracts.", "tester")
-  Task("DevOps Engineer", "Setup Docker and CI/CD. Document in memory.", "cicd-engineer")
-  Task("Security Auditor", "Review authentication. Report findings via hooks.", "reviewer")
-
-  // All todos batched together
-  TodoWrite { todos: [...8-10 todos...] }
-
-  // All file operations together
-  Write "backend/server.js"
-  Write "frontend/App.jsx"
-  Write "database/schema.sql"
+# Background workers
+npx @claude-flow/cli@latest hooks worker list
+npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
+npx @claude-flow/cli@latest hooks worker status
 \`\`\`
 
-## 📋 Agent Coordination Protocol
+## 🧠 Intelligence System (RuVector)
 
-### Every Agent Spawned via Task Tool MUST:
+V3 includes the RuVector Intelligence System:
+- **SONA**: Self-Optimizing Neural Architecture (<0.05ms adaptation)
+- **MoE**: Mixture of Experts for specialized routing
+- **HNSW**: 150x-12,500x faster pattern search
+- **EWC++**: Elastic Weight Consolidation (prevents forgetting)
+- **Flash Attention**: 2.49x-7.47x speedup
 
-**1️⃣ BEFORE Work:**
-\`\`\`bash
-npx claude-flow@v3alpha hooks pre-task --description "[task]"
-npx claude-flow@v3alpha hooks session-restore --session-id "swarm-[id]"
-\`\`\`
+The 4-step intelligence pipeline:
+1. **RETRIEVE** - Fetch relevant patterns via HNSW
+2. **JUDGE** - Evaluate with verdicts (success/failure)
+3. **DISTILL** - Extract key learnings via LoRA
+4. **CONSOLIDATE** - Prevent catastrophic forgetting via EWC++
 
-**2️⃣ DURING Work:**
-\`\`\`bash
-npx claude-flow@v3alpha hooks post-edit --file "[file]" --memory-key "swarm/[agent]/[step]"
-npx claude-flow@v3alpha hooks notify --message "[what was done]"
-\`\`\`
+## 📦 Embeddings Package (v3.0.0-alpha.12)
 
-**3️⃣ AFTER Work:**
-\`\`\`bash
-npx claude-flow@v3alpha hooks post-task --task-id "[task]"
-npx claude-flow@v3alpha hooks session-end --export-metrics true
-\`\`\`
+Features:
+- **sql.js**: Cross-platform SQLite persistent cache (WASM, no native compilation)
+- **Document chunking**: Configurable overlap and size
+- **Normalization**: L2, L1, min-max, z-score
+- **Hyperbolic embeddings**: Poincaré ball model for hierarchical data
+- **75x faster**: With agentic-flow ONNX integration
+- **Neural substrate**: Integration with RuVector
 
-## 🚀 Swarm Lifecycle Management
+## 🐝 Hive-Mind Consensus
 
-### Session Start (AUTOMATIC)
-When beginning ANY development task, Claude Code should:
+### Topologies
+- \`hierarchical\` - Queen controls workers directly
+- \`mesh\` - Fully connected peer network
+- \`hierarchical-mesh\` - Hybrid (recommended)
+- \`adaptive\` - Dynamic based on load
 
-\`\`\`javascript
-// 1. Check for existing swarm session
-mcp__claude-flow__swarm_status({})
+### Consensus Strategies
+- \`byzantine\` - BFT (tolerates f < n/3 faulty)
+- \`raft\` - Leader-based (tolerates f < n/2)
+- \`gossip\` - Epidemic for eventual consistency
+- \`crdt\` - Conflict-free replicated data types
+- \`quorum\` - Configurable quorum-based
 
-// 2. If no active swarm, initialize one
-mcp__claude-flow__swarm_init({ topology: "${topology}", maxAgents: ${maxAgents} })
+## V3 Performance Targets
 
-// 3. Restore previous context if available
-mcp__claude-flow__memory_usage({ action: "retrieve", namespace: "swarm", key: "last-session" })
-\`\`\`
+| Metric | Target |
+|--------|--------|
+| Flash Attention | 2.49x-7.47x speedup |
+| HNSW Search | 150x-12,500x faster |
+| Memory Reduction | 50-75% with quantization |
+| MCP Response | <100ms |
+| CLI Startup | <500ms |
+| SONA Adaptation | <0.05ms |
 
-### Task Execution (AUTOMATIC)
-For each significant task:
+## 📊 Performance Optimization Protocol
 
-\`\`\`javascript
-// 1. Create task orchestration
-mcp__claude-flow__task_orchestrate({
-  task: "[task description]",
-  priority: "high",
-  strategy: "adaptive"
-})
+### Automatic Performance Tracking
+\`\`\`bash
+# After any significant operation, track metrics
+Bash("npx @claude-flow/cli@latest hooks post-command --command '[operation]' --track-metrics true")
 
-// 2. Spawn appropriate agents via Task tool (PARALLEL)
-Task("Agent1", "...", "agent-type")
-Task("Agent2", "...", "agent-type")
-Task("Agent3", "...", "agent-type")
+# Periodically run benchmarks (every major feature)
+Bash("npx @claude-flow/cli@latest performance benchmark --suite all")
 
-// 3. Monitor progress via MCP
-mcp__claude-flow__swarm_status({ includeAgents: true, includeMetrics: true })
+# Analyze bottlenecks when performance degrades
+Bash("npx @claude-flow/cli@latest performance profile --target '[component]'")
 \`\`\`
 
-### Session End (AUTOMATIC)
-When task completes or user ends session:
-
-\`\`\`javascript
-// 1. Save session state
-mcp__claude-flow__memory_usage({
-  action: "store",
-  namespace: "swarm",
-  key: "last-session",
-  value: JSON.stringify({ completedAt: new Date().toISOString(), summary: "..." })
-})
-
-// 2. Export metrics if enabled
-mcp__claude-flow__agent_metrics({})
+### Session Persistence (Cross-Conversation Learning)
+\`\`\`bash
+# At session start - restore previous context
+Bash("npx @claude-flow/cli@latest session restore --latest")
 
-// 3. Graceful shutdown (only if explicitly requested)
-// mcp__claude-flow__swarm_destroy({ swarmId: "..." })
+# At session end - persist learned patterns
+Bash("npx @claude-flow/cli@latest hooks session-end --generate-summary true --persist-state true --export-metrics true")
 \`\`\`
 
-## 🎯 Concurrent Execution Examples
+### Neural Pattern Training
+\`\`\`bash
+# Train on successful code patterns
+Bash("npx @claude-flow/cli@latest neural train --pattern-type coordination --epochs 10")
 
-### ✅ CORRECT WORKFLOW: MCP Coordinates, Claude Code Executes
+# Predict optimal approach for new tasks
+Bash("npx @claude-flow/cli@latest neural predict --input '[task description]'")
 
-\`\`\`javascript
-// Step 1: MCP tools set up coordination (optional, for complex tasks)
-[Single Message - Coordination Setup]:
-  mcp__claude-flow__swarm_init { topology: "${topology}", maxAgents: ${maxAgents} }
-  mcp__claude-flow__agent_spawn { type: "researcher" }
-  mcp__claude-flow__agent_spawn { type: "coder" }
-  mcp__claude-flow__agent_spawn { type: "tester" }
-
-// Step 2: Claude Code Task tool spawns ACTUAL agents that do the work
-[Single Message - Parallel Agent Execution]:
-  // Claude Code's Task tool spawns real agents concurrently
-  Task("Research agent", "Analyze API requirements and best practices. Check memory for prior decisions.", "researcher")
-  Task("Coder agent", "Implement REST endpoints with authentication. Coordinate via hooks.", "coder")
-  Task("Database agent", "Design and implement database schema. Store decisions in memory.", "code-analyzer")
-  Task("Tester agent", "Create comprehensive test suite with 90% coverage.", "tester")
-  Task("Reviewer agent", "Review code quality and security. Document findings.", "reviewer")
-
-  // Batch ALL todos in ONE call
-  TodoWrite { todos: [
-    {id: "1", content: "Research API patterns", status: "in_progress", priority: "high"},
-    {id: "2", content: "Design database schema", status: "in_progress", priority: "high"},
-    {id: "3", content: "Implement authentication", status: "pending", priority: "high"},
-    {id: "4", content: "Build REST endpoints", status: "pending", priority: "high"},
-    {id: "5", content: "Write unit tests", status: "pending", priority: "medium"},
-    {id: "6", content: "Integration tests", status: "pending", priority: "medium"},
-    {id: "7", content: "API documentation", status: "pending", priority: "low"},
-    {id: "8", content: "Performance optimization", status: "pending", priority: "low"}
-  ]}
-
-  // Parallel file operations
-  Bash "mkdir -p app/{src,tests,docs,config}"
-  Write "app/package.json"
-  Write "app/src/server.js"
-  Write "app/tests/server.test.js"
-  Write "app/docs/API.md"
-\`\`\`
-
-### ❌ WRONG (Multiple Messages):
-\`\`\`javascript
-Message 1: mcp__claude-flow__swarm_init
-Message 2: Task("agent 1")
-Message 3: TodoWrite { todos: [single todo] }
-Message 4: Write "file.js"
-// This breaks parallel coordination!
+# View learned patterns
+Bash("npx @claude-flow/cli@latest neural patterns --list")
 \`\`\`
 
-## V3 Performance Targets
-
-- **2.49x-7.47x** Flash Attention speedup
-- **150x-12,500x** search improvements with HNSW
-- **50-75%** memory reduction with quantization
-- **Sub-100ms** MCP response times
-
-## 🪝 V3 Hooks System (26 Hooks)
-
-Claude Flow V3 provides 26 hooks for comprehensive agent coordination and self-learning.
-
-### Hook Categories
-
-| Category | Hooks | Purpose |
-|----------|-------|---------|
-| **Core** | \`pre-edit\`, \`post-edit\`, \`pre-command\`, \`post-command\`, \`pre-task\`, \`post-task\` | Tool lifecycle |
-| **Routing** | \`route\`, \`metrics\`, \`list\` | Task analysis |
-| **Intelligence** | \`explain\`, \`pretrain\`, \`build-agents\`, \`transfer\`, \`init\` | Neural learning |
-| **Session** | \`session-start\`, \`session-end\`, \`session-restore\`, \`notify\` | Context management |
-| **Learning** | \`trajectory-start\`, \`trajectory-step\`, \`trajectory-end\` | Reinforcement learning |
-| **Patterns** | \`pattern-store\`, \`pattern-search\`, \`stats\`, \`learn\`, \`attention\` | Memory & search |
-
-### Essential Hook Commands
+## 🔧 Environment Variables
 
 \`\`\`bash
-# Core hooks for tool coordination
-npx claude-flow@v3alpha hooks pre-task --description "[task]"
-npx claude-flow@v3alpha hooks post-task --task-id "[id]" --success true
-npx claude-flow@v3alpha hooks post-edit --file "[file]" --train-patterns
-
-# Session management
-npx claude-flow@v3alpha hooks session-start --session-id "[id]"
-npx claude-flow@v3alpha hooks session-end --export-metrics true --persist-patterns
-npx claude-flow@v3alpha hooks session-restore --session-id "[id]"
-
-# Intelligence routing
-npx claude-flow@v3alpha hooks route --task "[task]" --include-explanation
-npx claude-flow@v3alpha hooks explain --topic "[topic]" --depth comprehensive
-
-# Neural learning
-npx claude-flow@v3alpha hooks pretrain --model-type moe --epochs 10
-npx claude-flow@v3alpha hooks build-agents --agent-types coder,tester --config-format yaml
-
-# Trajectory learning (reinforcement)
-npx claude-flow@v3alpha hooks intelligence trajectory-start --session "[session]"
-npx claude-flow@v3alpha hooks intelligence trajectory-step --action "[action]" --reward "[reward]"
-npx claude-flow@v3alpha hooks intelligence trajectory-end --verdict success
-
-# Pattern storage (HNSW-indexed)
-npx claude-flow@v3alpha hooks intelligence pattern-store --pattern "[pattern]" --embedding "[json]"
-npx claude-flow@v3alpha hooks intelligence pattern-search --query "[query]" --limit 10
-
-# Learning stats & attention
-npx claude-flow@v3alpha hooks intelligence stats
-npx claude-flow@v3alpha hooks intelligence attention --focus "[task]"
+# Configuration
+CLAUDE_FLOW_CONFIG=./claude-flow.config.json
+CLAUDE_FLOW_LOG_LEVEL=info
+
+# Provider API Keys
+ANTHROPIC_API_KEY=sk-ant-...
+OPENAI_API_KEY=sk-...
+GOOGLE_API_KEY=...
+
+# MCP Server
+CLAUDE_FLOW_MCP_PORT=3000
+CLAUDE_FLOW_MCP_HOST=localhost
+CLAUDE_FLOW_MCP_TRANSPORT=stdio
+
+# Memory
+CLAUDE_FLOW_MEMORY_BACKEND=hybrid
+CLAUDE_FLOW_MEMORY_PATH=./data/memory
 \`\`\`
 
-### Intelligence System (RuVector)
-
-V3 includes the RuVector Intelligence System with:
-- **SONA**: Self-Optimizing Neural Architecture
-- **MoE**: Mixture of Experts for specialized routing
-- **HNSW**: 150x faster pattern search
-- **EWC++**: Elastic Weight Consolidation (prevents forgetting)
-- **Flash Attention**: 2.49x-7.47x speedup
-
-The 4-step intelligence pipeline:
-1. **RETRIEVE** - Fetch relevant patterns via HNSW
-2. **JUDGE** - Evaluate with verdicts (success/failure)
-3. **DISTILL** - Extract key learnings via LoRA
-4. **CONSOLIDATE** - Prevent catastrophic forgetting via EWC++
-
-### Auto-Configured Hooks
-
-The init system configures these hooks in \`.claude/settings.json\`:
-
-\`\`\`json
-{
-  "hooks": {
-    "PreToolUse": [
-      { "matcher": "Task", "commands": ["npx claude-flow@v3alpha hooks pre-task --tool Task"] }
-    ],
-    "PostToolUse": [
-      { "matcher": "Task", "commands": ["npx claude-flow@v3alpha hooks post-task --tool Task --train-patterns"] }
-    ],
-    "UserPromptSubmit": [
-      { "matcher": ".*", "commands": ["npx claude-flow@v3alpha hooks route-task --analyze-complexity"] }
-    ],
-    "SessionStart": [
-      { "commands": ["npx claude-flow@v3alpha hooks session-start --load-context"] }
-    ]
-  }
-}
-\`\`\`
+## 🔍 Doctor Health Checks
 
-### Agent Coordination via Hooks
+Run \`npx @claude-flow/cli@latest doctor\` to check:
+- Node.js version (20+)
+- npm version (9+)
+- Git installation
+- Config file validity
+- Daemon status
+- Memory database
+- API keys
+- MCP servers
+- Disk space
+- TypeScript installation
 
-Every spawned agent should use hooks for coordination:
+## 🚀 Quick Setup
 
-\`\`\`javascript
-// In agent prompt instructions
-Task("Coder", \`
-  BEFORE starting: npx claude-flow@v3alpha hooks pre-task --description "Implement feature X"
+\`\`\`bash
+# Add MCP servers (auto-detects MCP mode when stdin is piped)
+claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
+claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start  # Optional
+claude mcp add flow-nexus -- npx -y flow-nexus@latest mcp start  # Optional
 
-  DURING work:
-  - After each file edit: npx claude-flow@v3alpha hooks post-edit --file "[file]"
-  - To notify others: npx claude-flow@v3alpha hooks notify --message "[update]"
+# Start daemon
+npx @claude-flow/cli@latest daemon start
 
-  AFTER completing: npx claude-flow@v3alpha hooks post-task --success true
-\`, "coder")
+# Run doctor
+npx @claude-flow/cli@latest doctor --fix
 \`\`\`
 
-## Advanced Features (V3)
+## 🎯 Claude Code vs CLI Tools
 
-- 🚀 Automatic Topology Selection
-- ⚡ Parallel Execution (2.8-4.4x speed)
-- 🧠 Neural Training with ReasoningBank
-- 📊 Bottleneck Analysis
-- 🤖 Smart Auto-Spawning
-- 🛡️ Self-Healing Workflows
-- 💾 Cross-Session Memory with AgentDB
-- 🔗 GitHub Integration
-- 🔐 Security-Hardened Architecture
+### Claude Code Handles ALL EXECUTION:
+- **Task tool**: Spawn and run agents concurrently
+- File operations (Read, Write, Edit, MultiEdit, Glob, Grep)
+- Code generation and programming
+- Bash commands and system operations
+- TodoWrite and task management
+- Git operations
 
-## Integration Tips
+### CLI Tools Handle Coordination (via Bash):
+- **Swarm init**: \`npx @claude-flow/cli@latest swarm init --topology <type>\`
+- **Swarm status**: \`npx @claude-flow/cli@latest swarm status\`
+- **Agent spawn**: \`npx @claude-flow/cli@latest agent spawn -t <type> --name <name>\`
+- **Memory store**: \`npx @claude-flow/cli@latest memory store --namespace <ns> --key <k> --value <v>\`
+- **Memory search**: \`npx @claude-flow/cli@latest memory search -q "<query>"\`
+- **Hooks**: \`npx @claude-flow/cli@latest hooks <hook-name> [options]\`
 
-1. Start with basic swarm init
-2. Scale agents gradually
-3. Use memory for context
-4. Monitor progress regularly
-5. Train patterns from success
-6. Enable hooks automation
-7. Use GitHub tools first
+**KEY**: CLI coordinates the strategy via Bash, Claude Code's Task tool executes with real agents.
 
 ## Support
 
@@ -574,7 +539,7 @@ Task("Coder", \`
 
 ---
 
-Remember: **Claude Flow coordinates, Claude Code creates!**
+Remember: **Claude Flow CLI coordinates, Claude Code Task tool creates!**
 
 # important-instruction-reminders
 Do what has been asked; nothing more, nothing less.
@@ -582,25 +547,46 @@ NEVER create files unless they're absolutely necessary for achieving your goal.
 ALWAYS prefer editing an existing file to creating a new one.
 NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
 Never save working files, text/mds and tests to the root folder.
+
+## 🚨 SWARM EXECUTION RULES (CRITICAL)
+1. **SPAWN IN BACKGROUND**: Use \`run_in_background: true\` for all agent Task calls
+2. **SPAWN ALL AT ONCE**: Put ALL agent Task calls in ONE message for parallel execution
+3. **TELL USER**: After spawning, list what each agent is doing (use emojis for clarity)
+4. **STOP AND WAIT**: After spawning, STOP - do NOT add more tool calls or check status
+5. **NO POLLING**: Never poll TaskOutput or check swarm status - trust agents to return
+6. **SYNTHESIZE**: When agent results arrive, review ALL results before proceeding
+7. **NO CONFIRMATION**: Don't ask "should I check?" - just wait for results
+
+Example spawn message:
+\`\`\`
+"I've launched 4 agents in background:
+- 🔍 Researcher: [task]
+- 💻 Coder: [task]
+- 🧪 Tester: [task]
+- 👀 Reviewer: [task]
+Working in parallel - I'll synthesize when they complete."
+\`\`\`
 `;
 }
 /**
  * Generate minimal CLAUDE.md content
  */
 export function generateMinimalClaudeMd(options) {
-    return `# Claude Code Configuration
+    return `# Claude Code Configuration - Claude Flow V3
 
 ## Quick Reference
 
 - **Topology**: ${options.runtime.topology}
 - **Max Agents**: ${options.runtime.maxAgents}
 - **Memory**: ${options.runtime.memoryBackend}
+- **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
+- **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
 
 ## Key Rules
 
 1. **Batch Operations**: All related operations in ONE message
 2. **Task Tool**: Use Claude Code's Task tool for agent execution
-3. **MCP Tools**: Only for coordination, not execution
+3. **CLI Tools**: Use via Bash for coordination (swarm, memory, hooks)
 4. **File Organization**: Never save to root folder
 
 ## Agent Execution Pattern
@@ -612,14 +598,30 @@ Task("Coder", "Implement features...", "coder")
 Task("Tester", "Write tests...", "tester")
 \`\`\`
 
+## 26 CLI Commands
+
+\`\`\`bash
+# Core
+npx @claude-flow/cli@latest init --wizard
+npx @claude-flow/cli@latest agent spawn -t coder
+npx @claude-flow/cli@latest swarm init --v3-mode
+npx @claude-flow/cli@latest memory search -q "query"
+
+# Advanced
+npx @claude-flow/cli@latest daemon start
+npx @claude-flow/cli@latest doctor --fix
+npx @claude-flow/cli@latest security scan
+npx @claude-flow/cli@latest performance benchmark
+\`\`\`
+
 ## MCP Setup
 
 \`\`\`bash
-claude mcp add claude-flow npx claude-flow@v3alpha mcp start
+claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
 \`\`\`
 
 ---
-Remember: **Claude Flow coordinates, Claude Code creates!**
+Remember: **Claude Flow CLI coordinates, Claude Code Task tool creates!**
 `;
 }
 export default generateClaudeMd;