claude-flow 3.0.0-alpha.5 → 3.0.0-alpha.7

package/.claude/commands/swarm/examples.md

@@ -0,0 +1,168 @@
+# Examples Swarm Strategy
+
+## Common Swarm Patterns
+
+### Research Swarm
+
+#### Using MCP Tools
+```javascript
+// Initialize research swarm
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 6,
+  "strategy": "adaptive"
+})
+
+// Spawn research agents
+mcp__claude-flow__agent_spawn({
+  "type": "researcher",
+  "name": "AI Trends Researcher",
+  "capabilities": ["web-search", "analysis", "synthesis"]
+})
+
+// Orchestrate research
+mcp__claude-flow__task_orchestrate({
+  "task": "research AI trends",
+  "strategy": "parallel",
+  "priority": "medium"
+})
+
+// Monitor progress
+mcp__claude-flow__swarm_status({
+  "swarmId": "research-swarm"
+})
+```
+
+#### Using CLI (Fallback)
+```bash
+npx claude-flow swarm "research AI trends" \
+  --strategy research \
+  --mode distributed \
+  --max-agents 6 \
+  --parallel
+```
+
+### Development Swarm
+
+#### Using MCP Tools
+```javascript
+// Initialize development swarm
+mcp__claude-flow__swarm_init({
+  "topology": "hierarchical",
+  "maxAgents": 8,
+  "strategy": "balanced"
+})
+
+// Spawn development team
+const devAgents = [
+  { type: "architect", name: "API Designer" },
+  { type: "coder", name: "Backend Developer" },
+  { type: "tester", name: "API Tester" },
+  { type: "documenter", name: "API Documenter" }
+]
+
+devAgents.forEach(agent => {
+  mcp__claude-flow__agent_spawn({
+    "type": agent.type,
+    "name": agent.name,
+    "swarmId": "dev-swarm"
+  })
+})
+
+// Orchestrate development
+mcp__claude-flow__task_orchestrate({
+  "task": "build REST API",
+  "strategy": "sequential",
+  "dependencies": ["design", "implement", "test", "document"]
+})
+
+// Enable monitoring
+mcp__claude-flow__swarm_monitor({
+  "swarmId": "dev-swarm",
+  "interval": 5000
+})
+```
+
+#### Using CLI (Fallback)
+```bash
+npx claude-flow swarm "build REST API" \
+  --strategy development \
+  --mode hierarchical \
+  --monitor \
+  --output sqlite
+```
+
+### Analysis Swarm
+
+#### Using MCP Tools
+```javascript
+// Initialize analysis swarm
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 5,
+  "strategy": "adaptive"
+})
+
+// Spawn analysis agents
+mcp__claude-flow__agent_spawn({
+  "type": "analyst",
+  "name": "Code Analyzer",
+  "capabilities": ["static-analysis", "complexity-analysis"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "analyst",
+  "name": "Security Analyzer",
+  "capabilities": ["security-scan", "vulnerability-detection"]
+})
+
+// Parallel analysis execution
+mcp__claude-flow__parallel_execute({
+  "tasks": [
+    { "id": "analyze-code", "command": "analyze codebase structure" },
+    { "id": "analyze-security", "command": "scan for vulnerabilities" },
+    { "id": "analyze-performance", "command": "identify bottlenecks" }
+  ]
+})
+
+// Generate comprehensive report
+mcp__claude-flow__performance_report({
+  "format": "detailed",
+  "timeframe": "current"
+})
+```
+
+#### Using CLI (Fallback)
+```bash
+npx claude-flow swarm "analyze codebase" \
+  --strategy analysis \
+  --mode mesh \
+  --parallel \
+  --timeout 300
+```
+
+## Error Handling Examples
+
+```javascript
+// Setup fault tolerance
+mcp__claude-flow__daa_fault_tolerance({
+  "agentId": "all",
+  "strategy": "auto-recovery"
+})
+
+// Handle errors gracefully
+try {
+  await mcp__claude-flow__task_orchestrate({
+    "task": "complex operation",
+    "strategy": "parallel"
+  })
+} catch (error) {
+  // Check swarm health
+  const status = await mcp__claude-flow__swarm_status({})
+  
+  // Log error patterns
+  await mcp__claude-flow__error_analysis({
+    "logs": [error.message]
+  })
+}
+```

package/.claude/commands/swarm/maintenance.md

@@ -0,0 +1,102 @@
+# Maintenance Swarm Strategy
+
+## Purpose
+System maintenance and updates through coordinated agents.
+
+## Activation
+
+### Using MCP Tools
+```javascript
+// Initialize maintenance swarm
+mcp__claude-flow__swarm_init({
+  "topology": "star",
+  "maxAgents": 5,
+  "strategy": "sequential"
+})
+
+// Orchestrate maintenance task
+mcp__claude-flow__task_orchestrate({
+  "task": "update dependencies",
+  "strategy": "sequential",
+  "priority": "medium",
+  "dependencies": ["backup", "test", "update", "verify"]
+})
+```
+
+### Using CLI (Fallback)
+`npx claude-flow swarm "update dependencies" --strategy maintenance`
+
+## Agent Roles
+
+### Agent Spawning with MCP
+```javascript
+// Spawn maintenance agents
+mcp__claude-flow__agent_spawn({
+  "type": "analyst",
+  "name": "Dependency Analyzer",
+  "capabilities": ["dependency-analysis", "version-management"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "monitor",
+  "name": "Security Scanner",
+  "capabilities": ["security", "vulnerability-scan"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "tester",
+  "name": "Test Runner",
+  "capabilities": ["testing", "validation"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "documenter",
+  "name": "Documentation Updater",
+  "capabilities": ["documentation", "changelog"]
+})
+```
+
+## Safety Features
+
+### Backup and Recovery
+```javascript
+// Create system backup
+mcp__claude-flow__backup_create({
+  "components": ["code", "config", "dependencies"],
+  "destination": "./backups/maintenance-" + Date.now()
+})
+
+// Create state snapshot
+mcp__claude-flow__state_snapshot({
+  "name": "pre-maintenance-" + Date.now()
+})
+
+// Enable fault tolerance
+mcp__claude-flow__daa_fault_tolerance({
+  "agentId": "all",
+  "strategy": "checkpoint-recovery"
+})
+```
+
+### Security Scanning
+```javascript
+// Run security scan
+mcp__claude-flow__security_scan({
+  "target": "./",
+  "depth": "comprehensive"
+})
+```
+
+### Monitoring
+```javascript
+// Health check before/after
+mcp__claude-flow__health_check({
+  "components": ["dependencies", "tests", "build"]
+})
+
+// Monitor maintenance progress
+mcp__claude-flow__swarm_monitor({
+  "swarmId": "maintenance-swarm",
+  "interval": 3000
+})
+```

package/.claude/commands/swarm/optimization.md

@@ -0,0 +1,117 @@
+# Optimization Swarm Strategy
+
+## Purpose
+Performance optimization through specialized analysis.
+
+## Activation
+
+### Using MCP Tools
+```javascript
+// Initialize optimization swarm
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 6,
+  "strategy": "adaptive"
+})
+
+// Orchestrate optimization task
+mcp__claude-flow__task_orchestrate({
+  "task": "optimize performance",
+  "strategy": "parallel",
+  "priority": "high"
+})
+```
+
+### Using CLI (Fallback)
+`npx claude-flow swarm "optimize performance" --strategy optimization`
+
+## Agent Roles
+
+### Agent Spawning with MCP
+```javascript
+// Spawn optimization agents
+mcp__claude-flow__agent_spawn({
+  "type": "optimizer",
+  "name": "Performance Profiler",
+  "capabilities": ["profiling", "bottleneck-detection"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "analyst",
+  "name": "Memory Analyzer",
+  "capabilities": ["memory-analysis", "leak-detection"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "optimizer",
+  "name": "Code Optimizer",
+  "capabilities": ["code-optimization", "refactoring"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "tester",
+  "name": "Benchmark Runner",
+  "capabilities": ["benchmarking", "performance-testing"]
+})
+```
+
+## Optimization Areas
+
+### Performance Analysis
+```javascript
+// Analyze bottlenecks
+mcp__claude-flow__bottleneck_analyze({
+  "component": "all",
+  "metrics": ["cpu", "memory", "io", "network"]
+})
+
+// Run benchmarks
+mcp__claude-flow__benchmark_run({
+  "suite": "performance"
+})
+
+// WASM optimization
+mcp__claude-flow__wasm_optimize({
+  "operation": "simd-acceleration"
+})
+```
+
+### Optimization Operations
+```javascript
+// Optimize topology
+mcp__claude-flow__topology_optimize({
+  "swarmId": "optimization-swarm"
+})
+
+// DAA optimization
+mcp__claude-flow__daa_optimization({
+  "target": "performance",
+  "metrics": ["speed", "memory", "efficiency"]
+})
+
+// Load balancing
+mcp__claude-flow__load_balance({
+  "swarmId": "optimization-swarm",
+  "tasks": optimizationTasks
+})
+```
+
+### Monitoring and Reporting
+```javascript
+// Performance report
+mcp__claude-flow__performance_report({
+  "format": "detailed",
+  "timeframe": "7d"
+})
+
+// Trend analysis
+mcp__claude-flow__trend_analysis({
+  "metric": "performance",
+  "period": "30d"
+})
+
+// Cost analysis
+mcp__claude-flow__cost_analysis({
+  "timeframe": "30d"
+})
+```

package/.claude/commands/swarm/research.md

@@ -0,0 +1,136 @@
+# Research Swarm Strategy
+
+## Purpose
+Deep research through parallel information gathering.
+
+## Activation
+
+### Using MCP Tools
+```javascript
+// Initialize research swarm
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 6,
+  "strategy": "adaptive"
+})
+
+// Orchestrate research task
+mcp__claude-flow__task_orchestrate({
+  "task": "research topic X",
+  "strategy": "parallel",
+  "priority": "medium"
+})
+```
+
+### Using CLI (Fallback)
+`npx claude-flow swarm "research topic X" --strategy research`
+
+## Agent Roles
+
+### Agent Spawning with MCP
+```javascript
+// Spawn research agents
+mcp__claude-flow__agent_spawn({
+  "type": "researcher",
+  "name": "Web Researcher",
+  "capabilities": ["web-search", "content-extraction", "source-validation"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "researcher",
+  "name": "Academic Researcher",
+  "capabilities": ["paper-analysis", "citation-tracking", "literature-review"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "analyst",
+  "name": "Data Analyst",
+  "capabilities": ["data-processing", "statistical-analysis", "visualization"]
+})
+
+mcp__claude-flow__agent_spawn({
+  "type": "documenter",
+  "name": "Report Writer",
+  "capabilities": ["synthesis", "technical-writing", "formatting"]
+})
+```
+
+## Research Methods
+
+### Information Gathering
+```javascript
+// Parallel information collection
+mcp__claude-flow__parallel_execute({
+  "tasks": [
+    { "id": "web-search", "command": "search recent publications" },
+    { "id": "academic-search", "command": "search academic databases" },
+    { "id": "data-collection", "command": "gather relevant datasets" }
+  ]
+})
+
+// Store research findings
+mcp__claude-flow__memory_usage({
+  "action": "store",
+  "key": "research-findings-" + Date.now(),
+  "value": JSON.stringify(findings),
+  "namespace": "research",
+  "ttl": 604800 // 7 days
+})
+```
+
+### Analysis and Validation
+```javascript
+// Pattern recognition in findings
+mcp__claude-flow__pattern_recognize({
+  "data": researchData,
+  "patterns": ["trend", "correlation", "outlier"]
+})
+
+// Cognitive analysis
+mcp__claude-flow__cognitive_analyze({
+  "behavior": "research-synthesis"
+})
+
+// Cross-reference validation
+mcp__claude-flow__quality_assess({
+  "target": "research-sources",
+  "criteria": ["credibility", "relevance", "recency"]
+})
+```
+
+### Knowledge Management
+```javascript
+// Search existing knowledge
+mcp__claude-flow__memory_search({
+  "pattern": "topic X",
+  "namespace": "research",
+  "limit": 20
+})
+
+// Create knowledge connections
+mcp__claude-flow__neural_patterns({
+  "action": "learn",
+  "operation": "knowledge-graph",
+  "metadata": {
+    "topic": "X",
+    "connections": relatedTopics
+  }
+})
+```
+
+### Reporting
+```javascript
+// Generate research report
+mcp__claude-flow__workflow_execute({
+  "workflowId": "research-report-generation",
+  "params": {
+    "findings": findings,
+    "format": "comprehensive"
+  }
+})
+
+// Monitor progress
+mcp__claude-flow__swarm_status({
+  "swarmId": "research-swarm"
+})
+```

package/.claude/commands/swarm/swarm-analysis.md

@@ -0,0 +1,8 @@
+# swarm-analysis
+
+Command documentation for swarm-analysis in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-analysis [options]
+```

package/.claude/commands/swarm/swarm-background.md

@@ -0,0 +1,8 @@
+# swarm-background
+
+Command documentation for swarm-background in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-background [options]
+```

package/.claude/commands/swarm/swarm-init.md

@@ -0,0 +1,19 @@
+# swarm-init
+
+Initialize a new swarm with specified topology.
+
+## Usage
+```bash
+npx claude-flow swarm init [options]
+```
+
+## Options
+- `--topology <type>` - Swarm topology (mesh, hierarchical, ring, star)
+- `--max-agents <n>` - Maximum agents
+- `--strategy <type>` - Distribution strategy
+
+## Examples
+```bash
+npx claude-flow swarm init --topology mesh
+npx claude-flow swarm init --topology hierarchical --max-agents 8
+```

package/.claude/commands/swarm/swarm-modes.md

@@ -0,0 +1,8 @@
+# swarm-modes
+
+Command documentation for swarm-modes in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-modes [options]
+```

package/.claude/commands/swarm/swarm-monitor.md

@@ -0,0 +1,8 @@
+# swarm-monitor
+
+Command documentation for swarm-monitor in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-monitor [options]
+```

package/.claude/commands/swarm/swarm-spawn.md

@@ -0,0 +1,19 @@
+# swarm-spawn
+
+Spawn agents in the swarm.
+
+## Usage
+```bash
+npx claude-flow swarm spawn [options]
+```
+
+## Options
+- `--type <type>` - Agent type
+- `--count <n>` - Number to spawn
+- `--capabilities <list>` - Agent capabilities
+
+## Examples
+```bash
+npx claude-flow swarm spawn --type coder --count 3
+npx claude-flow swarm spawn --type researcher --capabilities "web-search,analysis"
+```

package/.claude/commands/swarm/swarm-status.md

@@ -0,0 +1,8 @@
+# swarm-status
+
+Command documentation for swarm-status in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-status [options]
+```

package/.claude/commands/swarm/swarm-strategies.md

@@ -0,0 +1,8 @@
+# swarm-strategies
+
+Command documentation for swarm-strategies in category swarm.
+
+Usage:
+```bash
+npx claude-flow swarm swarm-strategies [options]
+```

package/.claude/commands/swarm/swarm.md

@@ -0,0 +1,27 @@
+# swarm
+
+Main swarm orchestration command for Claude Flow.
+
+## Usage
+```bash
+npx claude-flow swarm <objective> [options]
+```
+
+## Options
+- `--strategy <type>` - Execution strategy (research, development, analysis, testing)
+- `--mode <type>` - Coordination mode (centralized, distributed, hierarchical, mesh)
+- `--max-agents <n>` - Maximum number of agents (default: 5)
+- `--claude` - Open Claude Code CLI with swarm prompt
+- `--parallel` - Enable parallel execution
+
+## Examples
+```bash
+# Basic swarm
+npx claude-flow swarm "Build REST API"
+
+# With strategy
+npx claude-flow swarm "Research AI patterns" --strategy research
+
+# Open in Claude Code
+npx claude-flow swarm "Build API" --claude
+```