claude-flow 3.0.0-alpha.15 → 3.0.0-alpha.16

package/.claude-plugin/README.md

@@ -0,0 +1,720 @@
+# 🚀 Claude Flow Plugin - Complete Enterprise AI Agent Orchestration
+
+[![Version](https://img.shields.io/badge/version-2.5.0-blue.svg)](https://github.com/ruvnet/claude-flow)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-%3E%3D2.0.0-purple.svg)](https://claude.com/code)
+
+> **Enterprise-grade AI agent orchestration plugin with 150+ commands, 74+ specialized agents, SPARC methodology, swarm coordination, GitHub integration, and neural training capabilities**
+
+---
+
+## 📋 Table of Contents
+
+- [Overview](#overview)
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Installation](#installation)
+- [Components](#components)
+- [Usage](#usage)
+- [MCP Integration](#mcp-integration)
+- [Examples](#examples)
+- [Documentation](#documentation)
+- [Support](#support)
+
+---
+
+## 🌟 Overview
+
+Claude Flow is the most comprehensive Claude Code plugin for enterprise AI agent orchestration. It provides a complete ecosystem for:
+
+- **Multi-Agent Coordination**: 74+ specialized agents with swarm intelligence
+- **SPARC Methodology**: Systematic development with 18 specialized modes
+- **GitHub Automation**: 14+ tools for complete repository workflow automation
+- **Neural Training**: 27+ models with WASM acceleration
+- **150+ Commands**: Complete slash command library for all workflows
+- **MCP Integration**: 110+ tools across 3 MCP servers
+
+---
+
+## ✨ Features
+
+### 🐝 **Swarm Coordination**
+- **4 Topologies**: Hierarchical, Mesh, Ring, Star
+- **Auto-Spawning**: Intelligent agent creation based on task complexity
+- **Auto-Optimization**: Dynamic topology adjustment for performance
+- **100 Max Agents**: Scale to handle enterprise workloads
+- **Cross-Session Memory**: Persistent context and learnings
+
+### 🎯 **SPARC Methodology**
+- **Specification**: Requirements analysis and planning
+- **Pseudocode**: Algorithm design and logic flow
+- **Architecture**: System design and component structure
+- **Refinement**: TDD and iterative improvement
+- **Code**: Implementation and optimization
+- **18 Specialized Modes**: Complete development lifecycle coverage
+
+### 🐙 **GitHub Integration**
+- **PR Management**: Automated pull request workflows
+- **Code Review Swarms**: Multi-agent code analysis
+- **Issue Tracking**: Intelligent issue triage and assignment
+- **Release Automation**: Coordinated multi-package releases
+- **Workflow Automation**: Custom GitHub Actions integration
+- **Multi-Repo Coordination**: Cross-repository synchronization
+
+### 🧠 **Neural Training**
+- **27+ Models**: Pre-trained patterns for common tasks
+- **WASM Acceleration**: 2.8-4.4x speed improvement
+- **SIMD Optimization**: Advanced vector processing
+- **Pattern Learning**: Self-improving agent behaviors
+- **Context Persistence**: Cross-session learning retention
+
+### 🎨 **74+ Specialized Agents**
+
+#### Core Development (5)
+- `coder` - Code implementation specialist
+- `planner` - Strategic planning and roadmaps
+- `researcher` - Information gathering and analysis
+- `reviewer` - Code quality and security review
+- `tester` - Comprehensive test creation
+
+#### Swarm Coordination (5)
+- `hierarchical-coordinator` - Queen-led command structure
+- `mesh-coordinator` - Peer-to-peer coordination
+- `adaptive-coordinator` - Dynamic topology management
+- `collective-intelligence-coordinator` - Distributed decision-making
+- `swarm-memory-manager` - Cross-agent memory coordination
+
+#### Consensus & Fault Tolerance (7)
+- `byzantine-coordinator` - Byzantine fault tolerance
+- `raft-manager` - Raft consensus protocol
+- `gossip-coordinator` - Gossip-based consensus
+- `crdt-synchronizer` - Conflict-free data replication
+- `quorum-manager` - Dynamic quorum management
+- `security-manager` - Comprehensive security protocols
+- `performance-benchmarker` - Consensus performance testing
+
+#### GitHub Automation (13)
+- `pr-manager` - Pull request coordination
+- `code-review-swarm` - Multi-agent code reviews
+- `issue-tracker` - Issue management and triage
+- `release-manager` - Release coordination
+- `workflow-automation` - GitHub Actions management
+- `repo-architect` - Repository structure optimization
+- `multi-repo-swarm` - Cross-repository coordination
+- `sync-coordinator` - Version alignment across repos
+- And 5 more specialized GitHub agents...
+
+#### Specialized Development (8)
+- `backend-dev` - Backend API development
+- `mobile-dev` - React Native mobile development
+- `ml-developer` - Machine learning workflows
+- `cicd-engineer` - CI/CD pipeline creation
+- `api-docs` - OpenAPI/Swagger documentation
+- `system-architect` - System design and architecture
+- `code-analyzer` - Advanced code quality analysis
+- `base-template-generator` - Boilerplate generation
+
+#### SPARC Methodology (4)
+- `specification` - Requirements analysis
+- `pseudocode` - Algorithm design
+- `architecture` - System architecture
+- `refinement` - Iterative improvement
+
+#### And 32 more specialized agents!
+
+### 📦 **150+ Commands**
+
+#### Coordination (6)
+- `/coordination-swarm-init` - Initialize swarm with topology
+- `/coordination-agent-spawn` - Create specialized agents
+- `/coordination-task-orchestrate` - Coordinate task execution
+- `/coordination-spawn` - Quick agent spawning
+- `/coordination-orchestrate` - Advanced orchestration
+- `/coordination-init` - Setup coordination environment
+
+#### SPARC Methodology (18)
+- `/sparc-modes` - List all SPARC modes
+- `/sparc-coder` - Clean code implementation
+- `/sparc-tdd` - Test-driven development
+- `/sparc-architect` - Architecture design
+- `/sparc-reviewer` - Code review mode
+- `/sparc-tester` - Test creation mode
+- `/sparc-analyzer` - Code analysis
+- `/sparc-researcher` - Research mode
+- `/sparc-optimizer` - Performance optimization
+- `/sparc-debugger` - Debugging assistance
+- `/sparc-designer` - UI/UX design mode
+- `/sparc-documenter` - Documentation creation
+- `/sparc-innovator` - Innovation and R&D
+- `/sparc-orchestrator` - Workflow orchestration
+- `/sparc-batch-executor` - Batch operations
+- `/sparc-memory-manager` - Memory management
+- `/sparc-workflow-manager` - Workflow management
+- `/sparc-swarm-coordinator` - Swarm coordination
+
+#### GitHub Integration (18)
+- `/github-code-review` - Automated code reviews
+- `/github-code-review-swarm` - Multi-agent reviews
+- `/github-pr-manager` - PR lifecycle management
+- `/github-pr-enhance` - PR enhancement automation
+- `/github-issue-tracker` - Issue tracking
+- `/github-issue-triage` - Intelligent issue triage
+- `/github-repo-analyze` - Repository analysis
+- `/github-repo-architect` - Repo structure optimization
+- `/github-release-manager` - Release coordination
+- `/github-release-swarm` - Multi-package releases
+- `/github-workflow-automation` - GitHub Actions automation
+- `/github-swarm-pr` - PR swarm management
+- `/github-swarm-issue` - Issue swarm coordination
+- `/github-multi-repo-swarm` - Cross-repo coordination
+- `/github-sync-coordinator` - Version synchronization
+- `/github-project-board-sync` - Project board integration
+- `/github-modes` - GitHub integration modes
+- `/github-swarm` - GitHub swarm orchestration
+
+#### Hive Mind (11)
+- `/hive-mind` - Initialize hive mind coordination
+- `/hive-mind-init` - Setup hive mind topology
+- `/hive-mind-spawn` - Spawn hive agents
+- `/hive-mind-status` - Check hive status
+- `/hive-mind-consensus` - Consensus protocols
+- `/hive-mind-memory` - Shared memory management
+- `/hive-mind-metrics` - Performance metrics
+- `/hive-mind-sessions` - Session management
+- `/hive-mind-resume` - Resume hive sessions
+- `/hive-mind-stop` - Stop hive coordination
+- `/hive-mind-wizard` - Guided setup wizard
+
+#### Memory Management (5)
+- `/memory-usage` - Memory storage and retrieval
+- `/memory-persist` - Cross-session persistence
+- `/memory-search` - Pattern-based search
+- `/memory-neural` - Neural memory integration
+
+#### Monitoring (5)
+- `/monitoring-status` - System status overview
+- `/monitoring-agents` - Agent status monitoring
+- `/monitoring-agent-metrics` - Performance metrics
+- `/monitoring-swarm-monitor` - Real-time swarm monitoring
+- `/monitoring-real-time-view` - Live dashboard
+
+#### Optimization (5)
+- `/optimization-topology-optimize` - Auto-optimize topology
+- `/optimization-auto-topology` - Automatic topology selection
+- `/optimization-parallel-execution` - Parallel task execution
+- `/optimization-parallel-execute` - Execute tasks in parallel
+- `/optimization-cache-manage` - Cache management
+
+#### Analysis (5)
+- `/analysis-performance-report` - Performance reports
+- `/analysis-performance-bottlenecks` - Bottleneck detection
+- `/analysis-bottleneck-detect` - Real-time bottleneck analysis
+- `/analysis-token-usage` - Token consumption analysis
+- `/analysis-token-efficiency` - Token optimization
+
+#### Automation (6)
+- `/automation-smart-spawn` - Intelligent agent spawning
+- `/automation-smart-agents` - Auto-agent selection
+- `/automation-auto-agent` - Automated agent management
+- `/automation-self-healing` - Self-healing workflows
+- `/automation-session-memory` - Session persistence
+- `/automation-workflow-select` - Workflow selection
+
+#### Hooks (7)
+- `/hooks-setup` - Configure hooks system
+- `/hooks-overview` - Hooks documentation
+- `/hooks-pre-task` - Pre-task hook setup
+- `/hooks-post-task` - Post-task hook setup
+- `/hooks-pre-edit` - Pre-edit hook setup
+- `/hooks-post-edit` - Post-edit hook setup
+- `/hooks-session-end` - Session end hook setup
+
+#### Swarm Management (15)
+- `/swarm` - Main swarm command
+- `/swarm-init` - Initialize swarm
+- `/swarm-spawn` - Spawn swarm agents
+- `/swarm-status` - Swarm status
+- `/swarm-monitor` - Real-time monitoring
+- `/swarm-modes` - Available swarm modes
+- `/swarm-strategies` - Execution strategies
+- `/swarm-background` - Background swarm execution
+- `/swarm-analysis` - Swarm analysis workflows
+- `/swarm-research` - Research swarms
+- `/swarm-development` - Development swarms
+- `/swarm-testing` - Testing swarms
+- `/swarm-maintenance` - Maintenance swarms
+- `/swarm-optimization` - Optimization swarms
+- `/swarm-examples` - Swarm examples
+
+#### Workflows (5)
+- `/workflows-create` - Create custom workflows
+- `/workflows-execute` - Execute workflows
+- `/workflows-export` - Export workflow definitions
+- `/workflows-development` - Development workflows
+- `/workflows-research` - Research workflows
+
+#### Neural Training (5)
+- `/training-neural-train` - Train neural patterns
+- `/training-neural-patterns` - Pattern management
+- `/training-pattern-learn` - Pattern learning
+- `/training-model-update` - Model updates
+- `/training-specialization` - Agent specialization
+
+#### Flow Nexus (9)
+- `/flow-nexus-swarm` - Cloud swarm orchestration
+- `/flow-nexus-workflow` - Event-driven workflows
+- `/flow-nexus-neural-network` - Distributed neural training
+- `/flow-nexus-sandbox` - E2B sandbox management
+- `/flow-nexus-app-store` - Application marketplace
+- `/flow-nexus-challenges` - Coding challenges
+- `/flow-nexus-payments` - Credit management
+- `/flow-nexus-user-tools` - User management
+- `/flow-nexus-login` - Authentication
+
+#### And 50+ more commands!
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install Claude Code Plugin
+
+In Claude Code:
+
+```
+/plugin add ruvnet/claude-flow
+```
+
+Or from local directory:
+
+```bash
+git clone https://github.com/ruvnet/claude-flow.git
+cd claude-flow
+```
+
+Then in Claude Code:
+```
+/plugin add .
+```
+
+### 2. Restart Claude Code
+
+```
+/restart
+```
+
+### 3. Configure MCP Servers (Optional)
+
+```bash
+# Add MCP servers to Claude Code
+claude mcp add claude-flow npx claude-flow@alpha mcp start
+claude mcp add ruv-swarm npx ruv-swarm mcp start  # Optional
+claude mcp add flow-nexus npx flow-nexus@latest mcp start  # Optional
+```
+
+### 4. Verify Installation
+
+```bash
+# Check plugin status
+claude plugin list
+
+# Test a command
+# In Claude Code, type:
+/coordination-swarm-init
+```
+
+---
+
+## 📦 Installation
+
+### Prerequisites
+
+- **Claude Code CLI** >= 2.0.0
+- **Node.js** >= 20.0.0
+- **Git** (for GitHub integration features)
+- Read/write permissions in project directory
+
+### Method 1: Direct Installation (Recommended)
+
+In Claude Code:
+```
+/plugin add ruvnet/claude-flow
+/restart
+```
+
+### Method 2: Local Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/ruvnet/claude-flow.git
+cd claude-flow/claude-plugin
+
+# Run installation script
+bash scripts/install.sh
+
+# Or copy manually
+cp -r commands ~/.claude/commands/
+cp -r agents ~/.claude/agents/
+```
+
+### Method 3: NPX (One-Time Setup)
+
+```bash
+# Run setup via npx
+npx claude-flow@alpha init --plugin
+
+# This will:
+# 1. Create .claude directory
+# 2. Copy all commands and agents
+# 3. Configure MCP servers
+# 4. Setup hooks
+```
+
+---
+
+## 🏗️ Components
+
+### Directory Structure
+
+```
+claude-flow/
+├── .claude-plugin/
+│   ├── plugin.json          # Plugin metadata
+│   ├── README.md            # This file
+│   └── ...
+├── commands/                 # 150+ slash commands
+│   ├── coordination/         # Swarm coordination commands
+│   ├── sparc/                # SPARC methodology commands
+│   ├── github/               # GitHub integration commands
+│   ├── hive-mind/            # Hive mind commands
+│   ├── hooks/                # Hooks configuration commands
+│   ├── memory/               # Memory management commands
+│   ├── monitoring/           # Monitoring commands
+│   ├── optimization/         # Optimization commands
+│   ├── analysis/             # Analysis commands
+│   ├── automation/           # Automation commands
+│   ├── swarm/                # Swarm management commands
+│   ├── workflows/            # Workflow commands
+│   ├── training/             # Neural training commands
+│   ├── flow-nexus/           # Flow Nexus integration
+│   └── ...                   # And more!
+├── agents/                   # 74+ specialized agents
+│   ├── core/                 # Core development agents
+│   ├── consensus/            # Consensus protocol agents
+│   ├── github/               # GitHub automation agents
+│   ├── swarm/                # Swarm coordination agents
+│   ├── hive-mind/            # Hive mind agents
+│   ├── sparc/                # SPARC methodology agents
+│   ├── optimization/         # Optimization agents
+│   ├── specialized/          # Domain-specific agents
+│   ├── templates/            # Template agents
+│   ├── testing/              # Testing agents
+│   └── ...                   # And more!
+├── hooks/                    # Hook scripts
+│   ├── pre-tool-use.sh
+│   ├── post-tool-use.sh
+│   ├── pre-task.sh
+│   ├── post-task.sh
+│   ├── session-start.sh
+│   └── session-end.sh
+├── scripts/                  # Installation and setup scripts
+│   ├── install.sh
+│   ├── setup-mcp.sh
+│   ├── verify.sh
+│   └── uninstall.sh
+└── docs/                     # Documentation
+    ├── QUICKSTART.md
+    ├── USER_GUIDE.md
+    ├── API_REFERENCE.md
+    ├── EXAMPLES.md
+    └── TROUBLESHOOTING.md
+```
+
+---
+
+## 💡 Usage
+
+### Basic Swarm Coordination
+
+```bash
+# Initialize a hierarchical swarm
+/coordination-swarm-init
+
+# Spawn specialized agents
+/coordination-agent-spawn
+
+# Orchestrate a complex task
+/coordination-task-orchestrate "Build REST API with authentication"
+```
+
+### SPARC Development Workflow
+
+```bash
+# Start with specification
+/sparc-modes specification "User authentication system"
+
+# Design architecture
+/sparc-architect
+
+# Implement with TDD
+/sparc-tdd "Implement JWT authentication"
+
+# Code review
+/sparc-reviewer
+
+# Optimize performance
+/sparc-optimizer
+```
+
+### GitHub Automation
+
+```bash
+# Analyze repository
+/github-repo-analyze
+
+# Create PR with automated review
+/github-pr-manager
+
+# Multi-agent code review
+/github-code-review-swarm
+
+# Coordinate release across repos
+/github-multi-repo-swarm
+```
+
+### Hive Mind Coordination
+
+```bash
+# Initialize hive mind
+/hive-mind-init
+
+# Spawn hive agents with consensus
+/hive-mind-spawn
+
+# Check consensus status
+/hive-mind-consensus
+
+# View shared memory
+/hive-mind-memory
+```
+
+---
+
+## 🔌 MCP Integration
+
+Claude Flow integrates with 3 MCP servers providing 110+ tools:
+
+### Claude Flow MCP (Required)
+
+```json
+{
+  "mcpServers": {
+    "claude-flow": {
+      "command": "npx",
+      "args": ["claude-flow@alpha", "mcp", "start"]
+    }
+  }
+}
+```
+
+**Tools**: 40+ orchestration tools
+- Swarm initialization and management
+- Agent spawning and coordination
+- Task orchestration
+- Memory management
+- Neural training
+- Performance monitoring
+
+### ruv-swarm MCP (Optional)
+
+```json
+{
+  "mcpServers": {
+    "ruv-swarm": {
+      "command": "npx",
+      "args": ["ruv-swarm", "mcp", "start"]
+    }
+  }
+}
+```
+
+**Tools**: Enhanced coordination features
+- WASM acceleration (2.8-4.4x speed)
+- SIMD optimization
+- Advanced topology management
+- Byzantine fault tolerance
+
+### Flow Nexus MCP (Optional - Requires Auth)
+
+```json
+{
+  "mcpServers": {
+    "flow-nexus": {
+      "command": "npx",
+      "args": ["flow-nexus@latest", "mcp", "start"]
+    }
+  }
+}
+```
+
+**Tools**: 70+ cloud features
+- E2B sandbox execution
+- Distributed neural training
+- Event-driven workflows
+- Application marketplace
+- Real-time collaboration
+
+---
+
+## 📚 Examples
+
+### Example 1: Full-Stack Development with Swarm
+
+```bash
+# Initialize hierarchical swarm
+/coordination-swarm-init
+
+# The swarm automatically spawns:
+# - backend-dev agent
+# - coder agent for frontend
+# - tester agent
+# - reviewer agent
+
+# Orchestrate the full-stack build
+/coordination-task-orchestrate "Build a todo app with React frontend and Express backend"
+
+# Monitor progress
+/monitoring-swarm-monitor
+
+# Get performance metrics
+/analysis-performance-report
+```
+
+### Example 2: SPARC TDD Workflow
+
+```bash
+# Start with specification
+/sparc-modes specification "Shopping cart with inventory management"
+
+# Generate pseudocode
+/sparc-modes pseudocode
+
+# Design architecture
+/sparc-architect
+
+# TDD implementation
+/sparc-tdd
+
+# Automated review
+/sparc-reviewer
+
+# Performance optimization
+/sparc-optimizer
+```
+
+### Example 3: GitHub PR Automation
+
+```bash
+# Analyze current PR
+/github-pr-manager
+
+# Multi-agent code review
+/github-code-review-swarm
+
+# Auto-fix issues
+/github-pr-enhance
+
+# Sync across repositories
+/github-sync-coordinator
+
+# Prepare release
+/github-release-manager
+```
+
+---
+
+## 📖 Documentation
+
+- **[Quickstart Guide](docs/QUICKSTART.md)** - Get started in 5 minutes
+- **[User Guide](docs/USER_GUIDE.md)** - Complete usage documentation
+- **[API Reference](docs/API_REFERENCE.md)** - All commands and agents
+- **[Examples](docs/EXAMPLES.md)** - Real-world usage examples
+- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions
+
+---
+
+## 🤝 Support
+
+- **Documentation**: [GitHub Wiki](https://github.com/ruvnet/claude-flow/wiki)
+- **Issues**: [GitHub Issues](https://github.com/ruvnet/claude-flow/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/ruvnet/claude-flow/discussions)
+- **Website**: [Flow Nexus](https://flow-nexus.ruv.io)
+
+---
+
+## 📊 Performance
+
+- **84.8%** SWE-Bench solve rate
+- **32.3%** token reduction vs. sequential execution
+- **2.8-4.4x** speed improvement with WASM acceleration
+- **27+** neural models for pattern recognition
+- **100** max concurrent agents
+
+---
+
+## 🔧 Advanced Configuration
+
+### Custom Swarm Topology
+
+```json
+{
+  "swarmCoordination": {
+    "topology": "mesh",
+    "maxAgents": 50,
+    "autoSpawn": true,
+    "autoOptimize": true
+  }
+}
+```
+
+### Enable Neural Training
+
+```json
+{
+  "neuralTraining": {
+    "enabled": true,
+    "wasmAcceleration": true,
+    "simdOptimization": true
+  }
+}
+```
+
+### Configure Hooks
+
+```json
+{
+  "hooks": {
+    "PreToolUse": { "enabled": true },
+    "PostToolUse": { "enabled": true },
+    "SessionEnd": { "enabled": true }
+  }
+}
+```
+
+---
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) file for details
+
+---
+
+## 🌟 Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ruvnet/claude-flow&type=Date)](https://star-history.com/#ruvnet/claude-flow&Date)
+
+---
+
+**Made with ❤️ by rUv**
+
+*Enterprise AI Agent Orchestration for Claude Code*