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

package/.claude-plugin/docs/INSTALLATION.md

@@ -1,261 +0,0 @@
-# 📦 Claude Flow Plugin Installation Guide
-
-## Quick Installation
-
-### Method 1: Install from GitHub (Recommended)
-
-In Claude Code:
-
-```
-/plugin add ruvnet/claude-flow
-```
-
-This will:
-- Clone the repository
-- Install all 150+ commands
-- Install all 74+ agents
-- Configure MCP servers
-- Set up hooks
-
-### Method 2: Install from Local Directory
-
-If you've cloned the repository:
-
-```bash
-# Clone the repository
-git clone https://github.com/ruvnet/claude-flow.git
-cd claude-flow
-
-# In Claude Code, install the plugin
-/plugin add .
-```
-
-### Step 2: Restart Claude Code
-
-Restart to activate the plugin:
-
-```
-/restart
-```
-
-### Step 3: Verify Installation
-
-```
-/plugin list
-```
-
-Look for `claude-flow` in the active plugins list.
-
-Try a command:
-```
-/coordination-swarm-init
-```
-
-Or type `/` to see all 150+ available commands.
-
----
-
-## What Gets Installed
-
-### ✅ 150+ Slash Commands
-
-Commands organized by category:
-- **Coordination** (6): swarm-init, agent-spawn, task-orchestrate
-- **SPARC** (18): coder, tdd, architect, reviewer, optimizer
-- **GitHub** (18): pr-manager, code-review-swarm, release-manager
-- **Hive Mind** (11): init, spawn, consensus, memory
-- **Memory** (5): usage, persist, search
-- **Monitoring** (5): status, agents, metrics
-- **Optimization** (5): topology-optimize, parallel-execution
-- **Analysis** (5): performance-report, bottleneck-detect
-- **Automation** (6): smart-spawn, auto-agent
-- **Swarm** (15): init, spawn, status, monitor
-- **Workflows** (5): create, execute, export
-- **Training** (5): neural-train, pattern-learn
-- **Flow Nexus** (9): swarm, workflow, sandbox
-- And more...
-
-### ✅ 74+ Specialized Agents
-
-Available for delegation:
-- **Core Development** (5): coder, planner, researcher, reviewer, tester
-- **Swarm Coordination** (5): hierarchical, mesh, adaptive coordinators
-- **Consensus** (7): Byzantine, Raft, Gossip protocols
-- **GitHub** (13): PR manager, code review, releases
-- **Specialized** (8): backend, mobile, ML, CI/CD
-- And more...
-
-### ✅ MCP Integration
-
-3 MCP servers with 110+ tools:
-- **claude-flow**: Core orchestration (40+ tools) - Required
-- **ruv-swarm**: Enhanced coordination - Optional
-- **flow-nexus**: Cloud features (70+ tools) - Optional
-
----
-
-## Managing the Plugin
-
-### List Installed Plugins
-
-```
-/plugin list
-```
-
-### Update Plugin
-
-```
-/plugin update claude-flow
-```
-
-Or pull latest from GitHub:
-```
-cd /path/to/claude-flow
-git pull
-```
-
-### Remove Plugin
-
-```
-/plugin remove claude-flow
-```
-
----
-
-## MCP Server Setup (Optional)
-
-The plugin defines MCP servers, but you may need to install the packages:
-
-### Install MCP Packages
-
-```bash
-# Core MCP (recommended)
-npm install -g claude-flow@alpha
-
-# Optional enhanced coordination
-npm install -g ruv-swarm
-
-# Optional cloud features (requires authentication)
-npm install -g flow-nexus@latest
-```
-
-MCP servers are automatically configured when you install the plugin.
-
----
-
-## Verification
-
-### Check Plugin Status
-
-In Claude Code:
-```
-/plugin list
-```
-
-Look for `claude-flow` in the list with status "active".
-
-### Test Commands
-
-Type `/` in Claude Code and look for:
-- Commands starting with `coordination-`
-- Commands starting with `sparc-`
-- Commands starting with `github-`
-- Commands starting with `hive-mind-`
-
-### Test Agents
-
-Agents are automatically available for Claude Code to delegate to when appropriate.
-
----
-
-## Troubleshooting
-
-### Plugin Not Found
-
-```
-# Verify plugin is installed
-/plugin list
-
-# Try installing again
-/plugin add ruvnet/claude-flow
-```
-
-### Commands Not Showing
-
-```
-# Verify plugin is installed
-/plugin list
-
-# Check directory structure
-ls -la .claude-plugin/
-ls -la commands/
-ls -la agents/
-
-# Restart Claude Code
-/restart
-```
-
-### Installation Fails
-
-```
-# Try local installation
-git clone https://github.com/ruvnet/claude-flow.git
-cd claude-flow
-/plugin add .
-```
-
----
-
-## Getting Help
-
-- **Documentation**: See README.md for complete documentation
-- **Quick Start**: See docs/QUICKSTART.md for 5-minute guide
-- **GitHub Issues**: https://github.com/ruvnet/claude-flow/issues
-- **Discussions**: https://github.com/ruvnet/claude-flow/discussions
-
----
-
-## Uninstalling
-
-To remove the plugin:
-
-```
-/plugin remove claude-flow
-```
-
-This will remove all commands, agents, and hooks.
-
----
-
-**Version**: 2.5.0
-**License**: MIT
-**Author**: rUv
-
----
-
-## Plugin Structure
-
-After installation, the plugin structure is:
-
-```
-claude-flow/
-├── .claude-plugin/
-│   ├── plugin.json          # Plugin metadata
-│   ├── README.md            # Documentation
-│   ├── INSTALLATION.md      # This file
-│   └── PLUGIN_SUMMARY.md    # Status overview
-├── commands/                 # 150+ slash commands
-│   ├── coordination/
-│   ├── sparc/
-│   ├── github/
-│   ├── hive-mind/
-│   └── ...
-├── agents/                   # 74+ specialized agents
-│   ├── core/
-│   ├── swarm/
-│   ├── consensus/
-│   ├── github/
-│   └── ...
-└── hooks/                    # Event handlers
-    └── hooks.json
-```

package/.claude-plugin/docs/PLUGIN_SUMMARY.md

@@ -1,361 +0,0 @@
-# 🎉 Claude Flow Plugin - Complete Summary
-
-## ✅ Plugin Status: PRODUCTION READY
-
-**Version**: 2.5.0
-**License**: MIT
-**Author**: rUv
-**Repository**: https://github.com/ruvnet/claude-flow
-
----
-
-## 📦 Plugin Structure
-
-```
-claude-flow/
-├── .claude-plugin/
-│   ├── plugin.json           ✓ Official plugin metadata
-│   ├── marketplace.json      ✓ Marketplace distribution metadata
-│   ├── README.md             ✓ Comprehensive documentation (20KB)
-│   ├── scripts/
-│   │   ├── install.sh       ✓ Full installation script
-│   │   ├── verify.sh        ✓ Verification script
-│   │   └── uninstall.sh     ✓ Uninstallation script
-│   └── docs/
-│       └── QUICKSTART.md    ✓ 5-minute quickstart guide
-├── commands/                 ✓ 150+ slash commands
-│   ├── coordination/
-│   ├── sparc/
-│   ├── github/
-│   └── ...
-├── agents/                   ✓ 74+ specialized agents
-│   ├── core/
-│   ├── swarm/
-│   ├── consensus/
-│   └── ...
-└── hooks/                    ✓ Event handlers
-    └── hooks.json           ✓ Hook configuration
-```
-
----
-
-## 🚀 Installation (Official Method)
-
-### From GitHub (Recommended):
-
-```
-# Install plugin
-/plugin add ruvnet/claude-flow
-
-# Restart Claude Code
-/restart
-
-# Verify installation
-/plugin list
-
-# Try a command
-/coordination-swarm-init
-```
-
-### From Local Directory:
-
-```
-cd claude-flow
-/plugin add .
-/restart
-```
-
----
-
-## 📊 Plugin Contents
-
-### Commands: 150+
-
-| Category | Count | Examples |
-|----------|-------|----------|
-| Coordination | 6 | swarm-init, agent-spawn, task-orchestrate |
-| SPARC | 18 | coder, tdd, architect, reviewer, optimizer |
-| GitHub | 18 | pr-manager, code-review-swarm, release-manager |
-| Hive Mind | 11 | init, spawn, consensus, memory, metrics |
-| Memory | 5 | usage, persist, search, neural |
-| Monitoring | 5 | status, agents, metrics, swarm-monitor |
-| Optimization | 5 | topology-optimize, parallel-execution, cache |
-| Analysis | 5 | performance-report, bottleneck-detect, token-usage |
-| Automation | 6 | smart-spawn, auto-agent, self-healing |
-| Swarm | 15 | init, spawn, status, monitor, strategies |
-| Workflows | 5 | create, execute, export |
-| Training | 5 | neural-train, pattern-learn, model-update |
-| Flow Nexus | 9 | swarm, workflow, neural-network, sandbox |
-| **Total** | **150+** | **19 categories** |
-
-### Agents: 74+
-
-| Category | Count | Key Agents |
-|----------|-------|-----------|
-| Core Development | 5 | coder, planner, researcher, reviewer, tester |
-| Swarm Coordination | 5 | hierarchical, mesh, adaptive coordinators |
-| Consensus & Fault Tolerance | 7 | Byzantine, Raft, Gossip, CRDT, Quorum |
-| GitHub Automation | 13 | PR manager, code review, release coordination |
-| Specialized Development | 8 | backend, mobile, ML, CI/CD, API docs |
-| SPARC Methodology | 4 | specification, pseudocode, architecture, refinement |
-| Hive Mind | 5 | collective intelligence, queen, scout, worker |
-| Optimization | 5 | performance monitor, load balancer, benchmarking |
-| **Total** | **74+** | **20 categories** |
-
-### MCP Integration: 110+ Tools
-
-1. **claude-flow** (Required)
-   - 40+ orchestration tools
-   - Swarm coordination
-   - Agent management
-   - Task orchestration
-   - Memory management
-   - Neural training
-
-2. **ruv-swarm** (Optional)
-   - Enhanced coordination
-   - WASM acceleration (2.8-4.4x speed)
-   - SIMD optimization
-   - Advanced topology management
-
-3. **flow-nexus** (Optional)
-   - 70+ cloud tools
-   - E2B sandbox execution
-   - Distributed neural training
-   - Event-driven workflows
-   - Application marketplace
-
----
-
-## ✨ Key Features
-
-### Multi-Agent Swarm Coordination
-- 4 topology types: Hierarchical, Mesh, Ring, Star
-- Auto-spawning based on task complexity
-- Auto-optimization for performance
-- Up to 100 concurrent agents
-- Cross-session memory persistence
-
-### SPARC Methodology Integration
-- 18 specialized development modes
-- Systematic development workflow
-- Test-driven development support
-- Architecture design tools
-- Code review automation
-
-### GitHub Automation
-- Pull request management
-- Multi-agent code reviews
-- Issue tracking and triage
-- Release coordination
-- Workflow automation
-- Multi-repository synchronization
-
-### Neural Training
-- 27+ pre-trained models
-- WASM acceleration
-- SIMD optimization
-- Pattern learning
-- Context persistence
-
-### Performance
-- 84.8% SWE-Bench solve rate
-- 32.3% token reduction
-- 2.8-4.4x speed improvement with WASM
-- Real-time performance monitoring
-- Bottleneck detection
-
----
-
-## 📚 Documentation
-
-| Document | Description |
-|----------|-------------|
-| README.md | Complete documentation (20KB) |
-| marketplace.json | Marketplace distribution metadata |
-| docs/INSTALLATION.md | Installation guide with official commands |
-| docs/QUICKSTART.md | 5-minute quickstart guide |
-| docs/PLUGIN_SUMMARY.md | Status overview (this file) |
-
-All documentation follows official Claude Code plugin guidelines.
-
----
-
-## 🔧 Technical Specifications
-
-### Plugin Manifest
-- **Format**: `.claude-plugin/plugin.json` (plugin configuration)
-- **Marketplace**: `.claude-plugin/marketplace.json` (distribution metadata)
-- **Schema**: Official Claude Code plugin specification
-- **Compatibility**: Claude Code >= 2.0.0
-- **Node.js**: >= 20.0.0
-
-### Commands
-- **Format**: Markdown files (.md)
-- **Location**: `commands/` directory (root level)
-- **Naming**: Kebab-case with category prefixes
-- **Discovery**: Automatic via plugin system
-- **Count**: 150+ commands across 19 categories
-
-### Agents
-- **Format**: Markdown files with YAML frontmatter
-- **Location**: `agents/` directory (root level)
-- **Delegation**: Available for main agent to use
-- **Specialization**: Domain-specific capabilities
-- **Count**: 74+ specialized agents across 20 categories
-
-### Hooks
-- **Format**: JSON configuration
-- **Location**: `hooks/hooks.json`
-- **Events**: pre-task, post-task, post-edit, session-start, session-end
-- **Integration**: Claude Flow coordination
-
-### MCP Servers
-- **Protocol**: Model Context Protocol
-- **Installation**: NPM packages
-- **Configuration**: Defined in plugin.json
-- **Optional**: Graceful degradation if not available
-
----
-
-## 🎯 Plugin Management
-
-### Install
-```
-/plugin add ruvnet/claude-flow
-```
-
-### Update
-```
-/plugin update claude-flow
-```
-
-Or pull latest from GitHub:
-```
-cd /path/to/claude-flow
-git pull
-```
-
-### Remove
-```
-/plugin remove claude-flow
-```
-
-### List Installed
-```
-/plugin list
-```
-
----
-
-## ✅ Quality Assurance
-
-### Compliance Checklist
-- ✓ Official Claude Code plugin specification
-- ✓ Marketplace.json format validation
-- ✓ Command and agent format standards
-- ✓ MCP integration best practices
-- ✓ Documentation completeness
-- ✓ Installation via `/plugin` commands
-
-### Verification
-After installation, verify with:
-```
-/plugin list
-```
-
-Should show `claude-flow` as active.
-
----
-
-## 🚀 Use Cases
-
-1. **Full-Stack Development**: Coordinate backend, frontend, database agents
-2. **SPARC Workflows**: Systematic development from spec to deployment
-3. **GitHub Automation**: PR management, code review, releases
-4. **Multi-Agent Projects**: Complex tasks requiring specialized agents
-5. **Performance Optimization**: Bottleneck detection and optimization
-6. **Neural Training**: Pattern learning and self-improvement
-7. **Enterprise Workflows**: Large-scale coordination and automation
-
----
-
-## 📈 Performance Metrics
-
-- **SWE-Bench**: 84.8% solve rate
-- **Token Efficiency**: 32.3% reduction vs sequential
-- **Speed**: 2.8-4.4x with WASM acceleration
-- **Scale**: Up to 100 concurrent agents
-- **Models**: 27+ neural models available
-
----
-
-## 🤝 Support & Community
-
-- **Repository**: https://github.com/ruvnet/claude-flow
-- **Issues**: https://github.com/ruvnet/claude-flow/issues
-- **Discussions**: https://github.com/ruvnet/claude-flow/discussions
-- **Website**: https://flow-nexus.ruv.io
-
----
-
-## 📝 License & Attribution
-
-- **License**: MIT
-- **Author**: rUv (ruv@ruv.net)
-- **Copyright**: 2025
-- **Open Source**: Free for personal and commercial use
-
----
-
-## 🎉 Distribution Status
-
-✅ **Ready For:**
-- GitHub repository hosting
-- Claude Code plugin marketplace distribution
-- Production deployment
-- Enterprise use
-- Team collaboration
-- Community sharing
-
----
-
-## 📋 Plugin Configuration
-
-The plugin is configured via `.claude-plugin/plugin.json`:
-
-```json
-{
-  "name": "claude-flow",
-  "version": "2.5.0",
-  "description": "Enterprise AI agent orchestration plugin...",
-  "author": {
-    "name": "rUv",
-    "email": "ruv@ruv.net"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ruvnet/claude-flow.git"
-  },
-  "mcpServers": {
-    "claude-flow": {
-      "command": "npx",
-      "args": ["claude-flow@alpha", "mcp", "start"]
-    }
-  }
-}
-```
-
-Commands and agents are automatically discovered from `commands/` and `agents/` directories.
-
-Users install with:
-```
-/plugin add ruvnet/claude-flow
-```
-
----
-
-**Plugin Status**: PRODUCTION READY
-**Last Updated**: 2025-10-09
-**Version**: 2.5.0
-**Specification**: Claude Code Official Plugin Format