moflo 4.9.20 → 4.9.21

package/.claude/skills/swarm-advanced/SKILL.md

@@ -1,811 +0,0 @@
----
-name: swarm-advanced
-description: Advanced swarm orchestration patterns for research, development, testing, and complex distributed workflows
-version: 2.0.0
-category: orchestration
-tags: [swarm, distributed, parallel, research, testing, development, coordination]
-author: Claude Flow Team
----
-
-# Advanced Swarm Orchestration
-
-Master advanced swarm patterns for distributed research, development, and testing workflows. This skill covers comprehensive orchestration strategies using both MCP tools and CLI commands.
-
-## Quick Start
-
-### Prerequisites
-```bash
-# Ensure Claude Flow is installed
-npm install -g claude-flow@alpha
-
-# Add MCP server (if using MCP tools)
-claude mcp add moflo npx moflo mcp start
-```
-
-### Basic Pattern
-```javascript
-// 1. Initialize swarm topology
-mcp__moflo__swarm_init({ topology: "mesh", maxAgents: 6 })
-
-// 2. Spawn specialized agents
-mcp__moflo__agent_spawn({ type: "researcher", name: "swarm-advanced" })
-
-// 3. Orchestrate tasks
-```
-
-### Dynamic Scaling
-Use `mcp__moflo__swarm_scale` to grow or shrink the agent pool to a target size
-without re-initializing the swarm. Three strategies are available:
-
-```javascript
-// Burst-spawn 8 workers all at once (load test, big batch)
-mcp__moflo__swarm_scale({
-  targetAgents: 8,
-  scaleStrategy: "immediate",
-  agentTypes: ["worker"],
-  reason: "load-test ramp"
-})
-
-// Rate-limited ramp (1 agent / 200ms) — gentler on the coordinator
-mcp__moflo__swarm_scale({
-  targetAgents: 12,
-  scaleStrategy: "gradual",
-  agentTypes: ["coder", "tester"]
-})
-
-// Adaptive: chunks scale with current coordinator load
-mcp__moflo__swarm_scale({ targetAgents: 4, scaleStrategy: "adaptive" })
-```
-
-The tool returns `{ previousAgents, currentAgents, scalingStatus, addedAgents,
-removedAgents }` so callers can verify the swarm reached the target. Scale-down
-prefers idle agents first, then oldest by heartbeat.
-
-### Task Orchestration
-
-The `task_*` family talks to the same UnifiedSwarmCoordinator that
-`swarm_init` / `agent_spawn` use, so tasks created here flow through the
-same scoring scheduler that load-balances across idle agents.
-
-```javascript
-// Single task — coordinator picks the lowest-workload agent automatically
-mcp__moflo__task_create({
-  type: "coding",
-  description: "Implement OAuth refresh flow",
-  priority: "high"
-})
-
-// Direct dispatch to a known agent (skip the scheduler)
-mcp__moflo__task_assign({
-  taskId: "task_swarm-…_3",
-  agentId: "agent-coder-…"
-})
-
-// Domain-routed dispatch (queen / security / core / integration / support)
-mcp__moflo__task_assign({
-  taskId: "task_swarm-…_4",
-  domain: "security"
-})
-
-// Submit a batch — load-balanced across available agents in one call.
-// 5 tasks across 3 idle agents → no agent ends up with more than 2.
-mcp__moflo__task_orchestrate({
-  tasks: [
-    { type: "coding", description: "endpoint A" },
-    { type: "coding", description: "endpoint B" },
-    { type: "testing", description: "tests for A" },
-    { type: "testing", description: "tests for B" },
-    { type: "review",  description: "PR review" }
-  ]
-})
-
-// Mark a task done and record its outcome
-mcp__moflo__task_complete({
-  taskId: "task_swarm-…_3",
-  result: { ok: true, summary: "merged in PR #842" }
-})
-```
-
-`task_orchestrate` returns `{ submitted, assigned, queued, rejected, tasks,
-errors }` — `assigned` is the count whose agents accepted them on submit;
-the rest are queued and will be picked up as agents go idle.
-
-## Core Concepts
-
-### Swarm Topologies
-
-**Mesh Topology** - Peer-to-peer communication, best for research and analysis
-- All agents communicate directly
-- High flexibility and resilience
-- Use for: Research, analysis, brainstorming
-
-**Hierarchical Topology** - Coordinator with subordinates, best for development
-- Clear command structure
-- Sequential workflow support
-- Use for: Development, structured pipelines
-
-**Star Topology** - Central coordinator, best for testing
-- Centralized control and monitoring
-- Parallel execution with coordination
-- Use for: Testing, validation, quality assurance
-
-**Ring Topology** - Sequential processing chain
-- Step-by-step processing
-- Pipeline processing
-- Use for: Multi-stage processing, data pipelines
-
-### Agent Strategies
-
-**Adaptive** - Dynamic adjustment based on task complexity
-**Balanced** - Equal distribution of work across agents
-**Specialized** - Task-specific agent assignment
-**Parallel** - Maximum concurrent execution
-
-## Pattern 1: Research Swarm
-
-### Purpose
-Deep research through parallel information gathering, analysis, and synthesis.
-
-### Architecture
-```javascript
-// Initialize research swarm
-mcp__moflo__swarm_init({
-  "topology": "mesh",
-  "maxAgents": 6,
-  "strategy": "adaptive"
-})
-
-// Spawn research team
-const researchAgents = [
-  {
-    type: "researcher",
-    name: "Web Researcher",
-    capabilities: ["web-search", "content-extraction", "source-validation"]
-  },
-  {
-    type: "researcher",
-    name: "Academic Researcher",
-    capabilities: ["paper-analysis", "citation-tracking", "literature-review"]
-  },
-  {
-    type: "analyst",
-    name: "Data Analyst",
-    capabilities: ["data-processing", "statistical-analysis", "visualization"]
-  },
-  {
-    type: "analyst",
-    name: "Pattern Analyzer",
-    capabilities: ["trend-detection", "correlation-analysis", "outlier-detection"]
-  },
-  {
-    type: "documenter",
-    name: "Report Writer",
-    capabilities: ["synthesis", "technical-writing", "formatting"]
-  }
-]
-
-// Spawn all agents
-researchAgents.forEach(agent => {
-  mcp__moflo__agent_spawn({
-    type: agent.type,
-    name: agent.name,
-    capabilities: agent.capabilities
-  })
-})
-```
-
-### Research Workflow
-
-#### Phase 1: Information Gathering
-```javascript
-// Parallel information collection
-// Store research findings in memory
-mcp__moflo__memory_store({
-  "action": "store",
-  "key": "research-findings-" + Date.now(),
-  "value": JSON.stringify(findings),
-  "namespace": "research",
-  "ttl": 604800 // 7 days
-})
-```
-
-#### Phase 2: Analysis and Validation
-```javascript
-// Pattern recognition in findings
-mcp__moflo__neural_patterns({
-  "data": researchData,
-  "patterns": ["trend", "correlation", "outlier", "emerging-pattern"]
-})
-
-// Cognitive analysis
-mcp__moflo__neural_predict({
-  "behavior": "research-synthesis"
-})
-
-// Quality assessment
-// Cross-reference validation
-mcp__moflo__neural_patterns({
-  "action": "analyze",
-  "operation": "fact-checking",
-  "metadata": { "sources": sourcesArray }
-})
-```
-
-#### Phase 3: Knowledge Management
-```javascript
-// Search existing knowledge base
-mcp__moflo__memory_search({
-  "pattern": "topic X",
-  "namespace": "research",
-  "limit": 20
-})
-
-// Create knowledge graph connections
-mcp__moflo__neural_patterns({
-  "action": "learn",
-  "operation": "knowledge-graph",
-  "metadata": {
-    "topic": "X",
-    "connections": relatedTopics,
-    "depth": 3
-  }
-})
-
-// Store connections for future use
-mcp__moflo__memory_store({
-  "action": "store",
-  "key": "knowledge-graph-X",
-  "value": JSON.stringify(knowledgeGraph),
-  "namespace": "research/graphs",
-  "ttl": 2592000 // 30 days
-})
-```
-
-#### Phase 4: Report Generation
-```javascript
-// Orchestrate report generation
-// Monitor research progress
-mcp__moflo__swarm_status({
-  "swarmId": "research-swarm"
-})
-
-// Generate final report
-mcp__moflo__spell_cast({
-  "workflowId": "research-report-generation",
-  "params": {
-    "findings": findings,
-    "format": "comprehensive",
-    "sections": ["executive-summary", "methodology", "findings", "analysis", "conclusions", "references"]
-  }
-})
-```
-
-### CLI Fallback
-```bash
-# Quick research swarm
-npx claude-flow swarm "research AI trends in 2025" \
-  --strategy research \
-  --mode distributed \
-  --max-agents 6 \
-  --parallel \
-  --output research-report.md
-```
-
-## Pattern 2: Development Swarm
-
-### Purpose
-Full-stack development through coordinated specialist agents.
-
-### Architecture
-```javascript
-// Initialize development swarm with hierarchy
-mcp__moflo__swarm_init({
-  "topology": "hierarchical",
-  "maxAgents": 8,
-  "strategy": "balanced"
-})
-
-// Spawn development team
-const devTeam = [
-  { type: "architect", name: "System Architect", role: "coordinator" },
-  { type: "coder", name: "Backend Developer", capabilities: ["node", "api", "database"] },
-  { type: "coder", name: "Frontend Developer", capabilities: ["react", "ui", "ux"] },
-  { type: "coder", name: "Database Engineer", capabilities: ["sql", "nosql", "optimization"] },
-  { type: "tester", name: "QA Engineer", capabilities: ["unit", "integration", "e2e"] },
-  { type: "reviewer", name: "Code Reviewer", capabilities: ["security", "performance", "best-practices"] },
-  { type: "documenter", name: "Technical Writer", capabilities: ["api-docs", "guides", "tutorials"] },
-  { type: "monitor", name: "DevOps Engineer", capabilities: ["ci-cd", "deployment", "monitoring"] }
-]
-
-// Spawn all team members
-devTeam.forEach(member => {
-  mcp__moflo__agent_spawn({
-    type: member.type,
-    name: member.name,
-    capabilities: member.capabilities,
-    swarmId: "dev-swarm"
-  })
-})
-```
-
-### Development Workflow
-
-#### Phase 1: Architecture and Design
-```javascript
-// System architecture design
-// Store architecture decisions
-mcp__moflo__memory_store({
-  "action": "store",
-  "key": "architecture-decisions",
-  "value": JSON.stringify(architectureDoc),
-  "namespace": "development/design"
-})
-```
-
-#### Phase 2: Parallel Implementation
-```javascript
-// Parallel development tasks
-// Monitor development progress
-mcp__moflo__swarm_status({
-  "swarmId": "dev-swarm",
-  "interval": 5000
-})
-```
-
-#### Phase 3: Testing and Validation
-```javascript
-// Comprehensive testing
-// Quality assessment
-```
-
-#### Phase 4: Review and Deployment
-```javascript
-// Code review workflow
-mcp__moflo__spell_cast({
-  "workflowId": "code-review-process",
-  "params": {
-    "reviewers": ["Code Reviewer"],
-    "criteria": ["security", "performance", "best-practices"]
-  }
-})
-
-// CI/CD pipeline
-```
-
-### CLI Fallback
-```bash
-# Quick development swarm
-npx claude-flow swarm "build REST API with authentication" \
-  --strategy development \
-  --mode hierarchical \
-  --monitor \
-  --output sqlite
-```
-
-## Pattern 3: Testing Swarm
-
-### Purpose
-Comprehensive quality assurance through distributed testing.
-
-### Architecture
-```javascript
-// Initialize testing swarm with star topology
-mcp__moflo__swarm_init({
-  "topology": "star",
-  "maxAgents": 7,
-  "strategy": "parallel"
-})
-
-// Spawn testing team
-const testingTeam = [
-  {
-    type: "tester",
-    name: "Unit Test Coordinator",
-    capabilities: ["unit-testing", "mocking", "coverage", "tdd"]
-  },
-  {
-    type: "tester",
-    name: "Integration Tester",
-    capabilities: ["integration", "api-testing", "contract-testing"]
-  },
-  {
-    type: "tester",
-    name: "E2E Tester",
-    capabilities: ["e2e", "ui-testing", "user-flows", "selenium"]
-  },
-  {
-    type: "tester",
-    name: "Performance Tester",
-    capabilities: ["load-testing", "stress-testing", "benchmarking"]
-  },
-  {
-    type: "monitor",
-    name: "Security Tester",
-    capabilities: ["security-testing", "penetration-testing", "vulnerability-scanning"]
-  },
-  {
-    type: "analyst",
-    name: "Test Analyst",
-    capabilities: ["coverage-analysis", "test-optimization", "reporting"]
-  },
-  {
-    type: "documenter",
-    name: "Test Documenter",
-    capabilities: ["test-documentation", "test-plans", "reports"]
-  }
-]
-
-// Spawn all testers
-testingTeam.forEach(tester => {
-  mcp__moflo__agent_spawn({
-    type: tester.type,
-    name: tester.name,
-    capabilities: tester.capabilities,
-    swarmId: "testing-swarm"
-  })
-})
-```
-
-### Testing Workflow
-
-#### Phase 1: Test Planning
-```javascript
-// Analyze test coverage requirements
-// Identify test scenarios
-mcp__moflo__neural_patterns({
-  "data": testScenarios,
-  "patterns": [
-    "edge-case",
-    "boundary-condition",
-    "error-path",
-    "happy-path"
-  ]
-})
-
-// Store test plan
-mcp__moflo__memory_store({
-  "action": "store",
-  "key": "test-plan-" + Date.now(),
-  "value": JSON.stringify(testPlan),
-  "namespace": "testing/plans"
-})
-```
-
-#### Phase 2: Parallel Test Execution
-```javascript
-// Execute all test suites in parallel
-// Batch process test suites
-```
-
-#### Phase 3: Performance and Security
-```javascript
-// Run performance benchmarks
-mcp__moflo__performance_benchmark({
-  "suite": "comprehensive-performance"
-})
-
-// Bottleneck analysis
-mcp__moflo__performance_report({
-  "component": "application",
-  "metrics": ["response-time", "throughput", "memory", "cpu"]
-})
-
-// Security scanning
-mcp__moflo__aidefence_scan({
-  "target": "application",
-  "depth": "comprehensive"
-})
-
-// Vulnerability analysis
-```
-
-#### Phase 4: Monitoring and Reporting
-```javascript
-// Real-time test monitoring
-mcp__moflo__swarm_status({
-  "swarmId": "testing-swarm",
-  "interval": 2000
-})
-
-// Generate comprehensive test report
-mcp__moflo__performance_report({
-  "format": "detailed",
-  "timeframe": "current-run"
-})
-
-// Get test results
-mcp__moflo__task_status({
-  "taskId": "test-execution-001"
-})
-
-// Trend analysis
-```
-
-### CLI Fallback
-```bash
-# Quick testing swarm
-npx claude-flow swarm "test application comprehensively" \
-  --strategy testing \
-  --mode star \
-  --parallel \
-  --timeout 600
-```
-
-## Pattern 4: Analysis Swarm
-
-### Purpose
-Deep code and system analysis through specialized analyzers.
-
-### Architecture
-```javascript
-// Initialize analysis swarm
-mcp__moflo__swarm_init({
-  "topology": "mesh",
-  "maxAgents": 5,
-  "strategy": "adaptive"
-})
-
-// Spawn analysis specialists
-const analysisTeam = [
-  {
-    type: "analyst",
-    name: "Code Analyzer",
-    capabilities: ["static-analysis", "complexity-analysis", "dead-code-detection"]
-  },
-  {
-    type: "analyst",
-    name: "Security Analyzer",
-    capabilities: ["security-scan", "vulnerability-detection", "dependency-audit"]
-  },
-  {
-    type: "analyst",
-    name: "Performance Analyzer",
-    capabilities: ["profiling", "bottleneck-detection", "optimization"]
-  },
-  {
-    type: "analyst",
-    name: "Architecture Analyzer",
-    capabilities: ["dependency-analysis", "coupling-detection", "modularity-assessment"]
-  },
-  {
-    type: "documenter",
-    name: "Analysis Reporter",
-    capabilities: ["reporting", "visualization", "recommendations"]
-  }
-]
-
-// Spawn all analysts
-analysisTeam.forEach(analyst => {
-  mcp__moflo__agent_spawn({
-    type: analyst.type,
-    name: analyst.name,
-    capabilities: analyst.capabilities
-  })
-})
-```
-
-### Analysis Workflow
-```javascript
-// Parallel analysis execution
-// Generate comprehensive analysis report
-mcp__moflo__performance_report({
-  "format": "detailed",
-  "timeframe": "current"
-})
-
-// Cost analysis
-```
-
-## Advanced Techniques
-
-### Error Handling and Fault Tolerance
-
-```javascript
-// Setup fault tolerance for all agents
-// Error handling pattern
-try {
-} catch (error) {
-  // Check swarm health
-  const status = await mcp__moflo__swarm_status({})
-
-  // Analyze error patterns
-// Auto-recovery attempt
-  if (status.healthy) {
-}
-}
-```
-
-### Memory and State Management
-
-```javascript
-// Cross-session persistence
-// Namespace management for different swarms
-// Create state snapshot
-// Restore from snapshot if needed
-// Backup memory stores
-```
-
-### Neural Pattern Learning
-
-```javascript
-// Train neural patterns from successful workflows
-mcp__moflo__neural_train({
-  "pattern_type": "coordination",
-  "training_data": JSON.stringify(successfulWorkflows),
-  "epochs": 50
-})
-
-// Adaptive learning from experience
-// Pattern recognition for optimization
-mcp__moflo__neural_patterns({
-  "data": workflowMetrics,
-  "patterns": ["bottleneck", "optimization-opportunity", "efficiency-gain"]
-})
-```
-
-### Spell Automation
-
-```javascript
-// Create reusable spell
-mcp__moflo__spell_create({
-  "name": "full-stack-development",
-  "steps": [
-    { "phase": "design", "agents": ["architect"] },
-    { "phase": "implement", "agents": ["backend-dev", "frontend-dev"], "parallel": true },
-    { "phase": "test", "agents": ["tester", "security-tester"], "parallel": true },
-    { "phase": "review", "agents": ["reviewer"] },
-    { "phase": "deploy", "agents": ["devops"] }
-  ],
-  "triggers": ["on-commit", "scheduled-daily"]
-})
-
-// Setup automation rules
-// Event-driven triggers
-```
-
-### Performance Optimization
-
-```javascript
-// Topology optimization
-// Load balancing
-// Agent coordination sync
-mcp__moflo__coordination_sync({
-  "swarmId": "development-swarm"
-})
-
-// Auto-scaling
-```
-
-### Monitoring and Metrics
-
-```javascript
-// Real-time swarm monitoring
-mcp__moflo__swarm_status({
-  "swarmId": "active-swarm",
-  "interval": 3000
-})
-
-// Collect comprehensive metrics
-// Health monitoring
-mcp__moflo__system_health({
-  "components": ["swarm", "agents", "neural", "memory"]
-})
-
-// Usage statistics
-// Trend analysis
-```
-
-## Best Practices
-
-### 1. Choosing the Right Topology
-
-- **Mesh**: Research, brainstorming, collaborative analysis
-- **Hierarchical**: Structured development, sequential workflows
-- **Star**: Testing, validation, centralized coordination
-- **Ring**: Pipeline processing, staged workflows
-
-### 2. Agent Specialization
-
-- Assign specific capabilities to each agent
-- Avoid overlapping responsibilities
-- Use coordination agents for complex workflows
-- Leverage memory for agent communication
-
-### 3. Parallel Execution
-
-- Identify independent tasks for parallelization
-- Use sequential execution for dependent tasks
-- Monitor resource usage during parallel execution
-- Implement proper error handling
-
-### 4. Memory Management
-
-- Use namespaces to organize memory
-- Set appropriate TTL values
-- Create regular backups
-- Implement state snapshots for checkpoints
-
-### 5. Monitoring and Optimization
-
-- Monitor swarm health regularly
-- Collect and analyze metrics
-- Optimize topology based on performance
-- Use neural patterns to learn from success
-
-### 6. Error Recovery
-
-- Implement fault tolerance strategies
-- Use auto-recovery mechanisms
-- Analyze error patterns
-- Create fallback pipelines
-
-## Real-World Examples
-
-### Example 1: AI Research Project
-```javascript
-// Research AI trends, analyze findings, generate report
-mcp__moflo__swarm_init({ topology: "mesh", maxAgents: 6 })
-// Spawn: 2 researchers, 2 analysts, 1 synthesizer, 1 documenter
-// Parallel gather → Analyze patterns → Synthesize → Report
-```
-
-### Example 2: Full-Stack Application
-```javascript
-// Build complete web application with testing
-mcp__moflo__swarm_init({ topology: "hierarchical", maxAgents: 8 })
-// Spawn: 1 architect, 2 devs, 1 db engineer, 2 testers, 1 reviewer, 1 devops
-// Design → Parallel implement → Test → Review → Deploy
-```
-
-### Example 3: Security Audit
-```javascript
-// Comprehensive security analysis
-mcp__moflo__swarm_init({ topology: "star", maxAgents: 5 })
-// Spawn: 1 coordinator, 1 code analyzer, 1 security scanner, 1 penetration tester, 1 reporter
-// Parallel scan → Vulnerability analysis → Penetration test → Report
-```
-
-### Example 4: Performance Optimization
-```javascript
-// Identify and fix performance bottlenecks
-mcp__moflo__swarm_init({ topology: "mesh", maxAgents: 4 })
-// Spawn: 1 profiler, 1 bottleneck analyzer, 1 optimizer, 1 tester
-// Profile → Identify bottlenecks → Optimize → Validate
-```
-
-## Troubleshooting
-
-### Common Issues
-
-**Issue**: Swarm agents not coordinating properly
-**Solution**: Check topology selection, verify memory usage, enable monitoring
-
-**Issue**: Parallel execution failing
-**Solution**: Verify task dependencies, check resource limits, implement error handling
-
-**Issue**: Memory persistence not working
-**Solution**: Verify namespaces, check TTL settings, ensure backup configuration
-
-**Issue**: Performance degradation
-**Solution**: Optimize topology, reduce agent count, analyze bottlenecks
-
-## Related Skills
-
-- `sparc-methodology` - Systematic development workflow
-- `github-integration` - Repository management and automation
-- `neural-patterns` - AI-powered coordination optimization
-- `memory-management` - Cross-session state persistence
-
-## References
-
-- [Claude Flow Documentation](https://github.com/eric-cielo/moflo)
-- [Swarm Orchestration Guide](https://github.com/eric-cielo/moflo/wiki/swarm)
-- [MCP Tools Reference](https://github.com/eric-cielo/moflo/wiki/mcp)
-- [Performance Optimization](https://github.com/eric-cielo/moflo/wiki/performance)
-
----
-
-**Version**: 2.0.0
-**Last Updated**: 2025-10-19
-**Skill Level**: Advanced
-**Estimated Learning Time**: 2-3 hours