claude-flow 2.0.0-alpha.2 → 2.0.0-alpha.21

package/.claude/commands/analysis/bottleneck-detect.md

@@ -1,150 +0,0 @@
-# bottleneck detect
-
-Analyze performance bottlenecks in swarm operations and suggest optimizations.
-
-## Usage
-
-```bash
-npx claude-flow bottleneck detect [options]
-```
-
-## Options
-
-- `--swarm-id, -s <id>` - Analyze specific swarm (default: current)
-- `--time-range, -t <range>` - Analysis period: 1h, 24h, 7d, all (default: 1h)
-- `--threshold <percent>` - Bottleneck threshold percentage (default: 20)
-- `--export, -e <file>` - Export analysis to file
-- `--fix` - Apply automatic optimizations
-
-## Examples
-
-### Basic bottleneck detection
-```bash
-npx claude-flow bottleneck detect
-```
-
-### Analyze specific swarm
-```bash
-npx claude-flow bottleneck detect --swarm-id swarm-123
-```
-
-### Last 24 hours with export
-```bash
-npx claude-flow bottleneck detect -t 24h -e bottlenecks.json
-```
-
-### Auto-fix detected issues
-```bash
-npx claude-flow bottleneck detect --fix --threshold 15
-```
-
-## Metrics Analyzed
-
-### Communication Bottlenecks
-- Message queue delays
-- Agent response times
-- Coordination overhead
-- Memory access patterns
-
-### Processing Bottlenecks
-- Task completion times
-- Agent utilization rates
-- Parallel execution efficiency
-- Resource contention
-
-### Memory Bottlenecks
-- Cache hit rates
-- Memory access patterns
-- Storage I/O performance
-- Neural pattern loading
-
-### Network Bottlenecks
-- API call latency
-- MCP communication delays
-- External service timeouts
-- Concurrent request limits
-
-## Output Format
-
-```
-🔍 Bottleneck Analysis Report
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 Summary
-├── Time Range: Last 1 hour
-├── Agents Analyzed: 6
-├── Tasks Processed: 42
-└── Critical Issues: 2
-
-🚨 Critical Bottlenecks
-1. Agent Communication (35% impact)
-   └── coordinator → coder-1 messages delayed by 2.3s avg
-   
-2. Memory Access (28% impact)
-   └── Neural pattern loading taking 1.8s per access
-
-⚠️ Warning Bottlenecks
-1. Task Queue (18% impact)
-   └── 5 tasks waiting > 10s for assignment
-
-💡 Recommendations
-1. Switch to hierarchical topology (est. 40% improvement)
-2. Enable memory caching (est. 25% improvement)
-3. Increase agent concurrency to 8 (est. 20% improvement)
-
-✅ Quick Fixes Available
-Run with --fix to apply:
-- Enable smart caching
-- Optimize message routing
-- Adjust agent priorities
-```
-
-## Automatic Fixes
-
-When using `--fix`, the following optimizations may be applied:
-
-1. **Topology Optimization**
-   - Switch to more efficient topology
-   - Adjust communication patterns
-   - Reduce coordination overhead
-
-2. **Caching Enhancement**
-   - Enable memory caching
-   - Optimize cache strategies
-   - Preload common patterns
-
-3. **Concurrency Tuning**
-   - Adjust agent counts
-   - Optimize parallel execution
-   - Balance workload distribution
-
-4. **Priority Adjustment**
-   - Reorder task queues
-   - Prioritize critical paths
-   - Reduce wait times
-
-## Performance Impact
-
-Typical improvements after bottleneck resolution:
-- **Communication**: 30-50% faster message delivery
-- **Processing**: 20-40% reduced task completion time
-- **Memory**: 40-60% fewer cache misses
-- **Overall**: 25-45% performance improvement
-
-## Integration with Claude Code
-
-```javascript
-// Check for bottlenecks in Claude Code
-mcp__claude-flow__bottleneck_detect { 
-  timeRange: "1h",
-  threshold: 20,
-  autoFix: false
-}
-```
-
-## See Also
-
-- `performance report` - Detailed performance analysis
-- `token usage` - Token optimization analysis
-- `swarm monitor` - Real-time monitoring
-- `cache manage` - Cache optimization

package/.claude/commands/analysis/performance-report.md

@@ -1,25 +0,0 @@
-# performance-report
-
-Generate comprehensive performance reports for swarm operations.
-
-## Usage
-```bash
-npx claude-flow analysis performance-report [options]
-```
-
-## Options
-- `--format <type>` - Report format (json, html, markdown)
-- `--include-metrics` - Include detailed metrics
-- `--compare <id>` - Compare with previous swarm
-
-## Examples
-```bash
-# Generate HTML report
-npx claude-flow analysis performance-report --format html
-
-# Compare swarms
-npx claude-flow analysis performance-report --compare swarm-123
-
-# Full metrics report
-npx claude-flow analysis performance-report --include-metrics --format markdown
-```

package/.claude/commands/analysis/token-usage.md

@@ -1,25 +0,0 @@
-# token-usage
-
-Analyze token usage patterns and optimize for efficiency.
-
-## Usage
-```bash
-npx claude-flow analysis token-usage [options]
-```
-
-## Options
-- `--period <time>` - Analysis period (1h, 24h, 7d, 30d)
-- `--by-agent` - Break down by agent
-- `--by-operation` - Break down by operation type
-
-## Examples
-```bash
-# Last 24 hours token usage
-npx claude-flow analysis token-usage --period 24h
-
-# By agent breakdown
-npx claude-flow analysis token-usage --by-agent
-
-# Export detailed report
-npx claude-flow analysis token-usage --period 7d --export tokens.csv
-```

package/.claude/commands/automation/README.md

@@ -1,9 +0,0 @@
-# Automation Commands
-
-Commands for automation operations in Claude Flow.
-
-## Available Commands
-
-- [auto-agent](./auto-agent.md)
-- [smart-spawn](./smart-spawn.md)
-- [workflow-select](./workflow-select.md)

package/.claude/commands/automation/auto-agent.md

@@ -1,112 +0,0 @@
-# auto agent
-
-Automatically spawn and manage agents based on task requirements.
-
-## Usage
-
-```bash
-npx claude-flow auto agent [options]
-```
-
-## Options
-
-- `--task, -t <description>` - Task description for agent analysis
-- `--max-agents, -m <number>` - Maximum agents to spawn (default: auto)
-- `--min-agents <number>` - Minimum agents required (default: 1)
-- `--strategy, -s <type>` - Selection strategy: optimal, minimal, balanced
-- `--no-spawn` - Analyze only, don't spawn agents
-
-## Examples
-
-### Basic auto-spawning
-```bash
-npx claude-flow auto agent --task "Build a REST API with authentication"
-```
-
-### Constrained spawning
-```bash
-npx claude-flow auto agent -t "Debug performance issue" --max-agents 3
-```
-
-### Analysis only
-```bash
-npx claude-flow auto agent -t "Refactor codebase" --no-spawn
-```
-
-### Minimal strategy
-```bash
-npx claude-flow auto agent -t "Fix bug in login" -s minimal
-```
-
-## How It Works
-
-1. **Task Analysis**
-   - Parses task description
-   - Identifies required skills
-   - Estimates complexity
-   - Determines parallelization opportunities
-
-2. **Agent Selection**
-   - Matches skills to agent types
-   - Considers task dependencies
-   - Optimizes for efficiency
-   - Respects constraints
-
-3. **Topology Selection**
-   - Chooses optimal swarm structure
-   - Configures communication patterns
-   - Sets up coordination rules
-   - Enables monitoring
-
-4. **Automatic Spawning**
-   - Creates selected agents
-   - Assigns specific roles
-   - Distributes subtasks
-   - Initiates coordination
-
-## Agent Types Selected
-
-- **Architect**: System design, architecture decisions
-- **Coder**: Implementation, code generation
-- **Tester**: Test creation, quality assurance
-- **Analyst**: Performance, optimization
-- **Researcher**: Documentation, best practices
-- **Coordinator**: Task management, progress tracking
-
-## Strategies
-
-### Optimal
-- Maximum efficiency
-- May spawn more agents
-- Best for complex tasks
-- Highest resource usage
-
-### Minimal
-- Minimum viable agents
-- Conservative approach
-- Good for simple tasks
-- Lowest resource usage
-
-### Balanced
-- Middle ground
-- Adaptive to complexity
-- Default strategy
-- Good performance/resource ratio
-
-## Integration with Claude Code
-
-```javascript
-// In Claude Code after auto-spawning
-mcp__claude-flow__auto_agent { 
-  task: "Build authentication system",
-  strategy: "balanced",
-  maxAgents: 6
-}
-```
-
-## See Also
-
-- `agent spawn` - Manual agent creation
-- `swarm init` - Initialize swarm manually
-- `smart spawn` - Intelligent agent spawning
-- `workflow select` - Choose predefined workflows

package/.claude/commands/automation/smart-spawn.md

@@ -1,25 +0,0 @@
-# smart-spawn
-
-Intelligently spawn agents based on workload analysis.
-
-## Usage
-```bash
-npx claude-flow automation smart-spawn [options]
-```
-
-## Options
-- `--analyze` - Analyze before spawning
-- `--threshold <n>` - Spawn threshold
-- `--topology <type>` - Preferred topology
-
-## Examples
-```bash
-# Smart spawn with analysis
-npx claude-flow automation smart-spawn --analyze
-
-# Set spawn threshold
-npx claude-flow automation smart-spawn --threshold 5
-
-# Force topology
-npx claude-flow automation smart-spawn --topology hierarchical
-```

package/.claude/commands/automation/workflow-select.md

@@ -1,25 +0,0 @@
-# workflow-select
-
-Automatically select optimal workflow based on task type.
-
-## Usage
-```bash
-npx claude-flow automation workflow-select [options]
-```
-
-## Options
-- `--task <description>` - Task description
-- `--constraints <list>` - Workflow constraints
-- `--preview` - Preview without executing
-
-## Examples
-```bash
-# Select workflow for task
-npx claude-flow automation workflow-select --task "Deploy to production"
-
-# With constraints
-npx claude-flow automation workflow-select --constraints "no-downtime,rollback"
-
-# Preview mode
-npx claude-flow automation workflow-select --task "Database migration" --preview
-```

package/.claude/commands/coordination/README.md

@@ -1,9 +0,0 @@
-# Coordination Commands
-
-Commands for coordination operations in Claude Flow.
-
-## Available Commands
-
-- [swarm-init](./swarm-init.md)
-- [agent-spawn](./agent-spawn.md)
-- [task-orchestrate](./task-orchestrate.md)

package/.claude/commands/coordination/agent-spawn.md

@@ -1,25 +0,0 @@
-# agent-spawn
-
-Spawn a new agent in the current swarm.
-
-## Usage
-```bash
-npx claude-flow agent spawn [options]
-```
-
-## Options
-- `--type <type>` - Agent type (coder, researcher, analyst, tester, coordinator)
-- `--name <name>` - Custom agent name
-- `--skills <list>` - Specific skills (comma-separated)
-
-## Examples
-```bash
-# Spawn coder agent
-npx claude-flow agent spawn --type coder
-
-# With custom name
-npx claude-flow agent spawn --type researcher --name "API Expert"
-
-# With specific skills
-npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"
-```

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

@@ -1,76 +0,0 @@
-# swarm init
-
-Initialize a Claude Flow swarm with specified topology and configuration.
-
-## Usage
-
-```bash
-npx claude-flow swarm init [options]
-```
-
-## Options
-
-- `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
-- `--max-agents, -m <number>` - Maximum number of agents (default: 8)
-- `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
-- `--auto-spawn` - Automatically spawn agents based on task complexity
-- `--memory` - Enable cross-session memory persistence
-- `--github` - Enable GitHub integration features
-
-## Examples
-
-### Basic initialization
-```bash
-npx claude-flow swarm init
-```
-
-### Mesh topology for research
-```bash
-npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
-```
-
-### Hierarchical for development
-```bash
-npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
-```
-
-### GitHub-focused swarm
-```bash
-npx claude-flow swarm init --topology star --github --memory
-```
-
-## Topologies
-
-### Mesh
-- All agents connect to all others
-- Best for: Research, exploration, brainstorming
-- Communication: High overhead, maximum information sharing
-
-### Hierarchical
-- Tree structure with clear command chain
-- Best for: Development, structured tasks, large projects
-- Communication: Efficient, clear responsibilities
-
-### Ring
-- Agents connect in a circle
-- Best for: Pipeline processing, sequential workflows
-- Communication: Low overhead, ordered processing
-
-### Star
-- Central coordinator with satellite agents
-- Best for: Simple tasks, centralized control
-- Communication: Minimal overhead, clear coordination
-
-## Integration with Claude Code
-
-Once initialized, use MCP tools in Claude Code:
-```javascript
-mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8 }
-```
-
-## See Also
-
-- `agent spawn` - Create swarm agents
-- `task orchestrate` - Coordinate task execution
-- `swarm status` - Check swarm state
-- `swarm monitor` - Real-time monitoring

package/.claude/commands/coordination/task-orchestrate.md

@@ -1,25 +0,0 @@
-# task-orchestrate
-
-Orchestrate complex tasks across the swarm.
-
-## Usage
-```bash
-npx claude-flow task orchestrate [options]
-```
-
-## Options
-- `--task <description>` - Task description
-- `--strategy <type>` - Orchestration strategy
-- `--priority <level>` - Task priority (low, medium, high, critical)
-
-## Examples
-```bash
-# Orchestrate development task
-npx claude-flow task orchestrate --task "Implement user authentication"
-
-# High priority task
-npx claude-flow task orchestrate --task "Fix production bug" --priority critical
-
-# With specific strategy
-npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel
-```

package/.claude/commands/github/README.md

@@ -1,11 +0,0 @@
-# Github Commands
-
-Commands for github operations in Claude Flow.
-
-## Available Commands
-
-- [github-swarm](./github-swarm.md)
-- [repo-analyze](./repo-analyze.md)
-- [pr-enhance](./pr-enhance.md)
-- [issue-triage](./issue-triage.md)
-- [code-review](./code-review.md)

package/.claude/commands/github/code-review.md

@@ -1,25 +0,0 @@
-# code-review
-
-Automated code review with swarm intelligence.
-
-## Usage
-```bash
-npx claude-flow github code-review [options]
-```
-
-## Options
-- `--pr-number <n>` - Pull request to review
-- `--focus <areas>` - Review focus (security, performance, style)
-- `--suggest-fixes` - Suggest code fixes
-
-## Examples
-```bash
-# Review PR
-npx claude-flow github code-review --pr-number 456
-
-# Security focus
-npx claude-flow github code-review --pr-number 456 --focus security
-
-# With fix suggestions
-npx claude-flow github code-review --pr-number 456 --suggest-fixes
-```

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

@@ -1,108 +0,0 @@
-# github swarm
-
-Create a specialized swarm for GitHub repository management.
-
-## Usage
-
-```bash
-npx claude-flow github swarm [options]
-```
-
-## Options
-
-- `--repository, -r <owner/repo>` - Target GitHub repository
-- `--agents, -a <number>` - Number of specialized agents (default: 5)
-- `--focus, -f <type>` - Focus area: maintenance, development, review, triage
-- `--auto-pr` - Enable automatic pull request enhancements
-- `--issue-labels` - Auto-categorize and label issues
-- `--code-review` - Enable AI-powered code reviews
-
-## Examples
-
-### Basic GitHub swarm
-```bash
-npx claude-flow github swarm --repository owner/repo
-```
-
-### Maintenance-focused swarm
-```bash
-npx claude-flow github swarm -r owner/repo -f maintenance --issue-labels
-```
-
-### Development swarm with PR automation
-```bash
-npx claude-flow github swarm -r owner/repo -f development --auto-pr --code-review
-```
-
-### Full-featured triage swarm
-```bash
-npx claude-flow github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr
-```
-
-## Agent Types
-
-### Issue Triager
-- Analyzes and categorizes issues
-- Suggests labels and priorities
-- Identifies duplicates and related issues
-
-### PR Reviewer
-- Reviews code changes
-- Suggests improvements
-- Checks for best practices
-
-### Documentation Agent
-- Updates README files
-- Creates API documentation
-- Maintains changelog
-
-### Test Agent
-- Identifies missing tests
-- Suggests test cases
-- Validates test coverage
-
-### Security Agent
-- Scans for vulnerabilities
-- Reviews dependencies
-- Suggests security improvements
-
-## Workflows
-
-### Issue Triage Workflow
-1. Scan all open issues
-2. Categorize by type and priority
-3. Apply appropriate labels
-4. Suggest assignees
-5. Link related issues
-
-### PR Enhancement Workflow
-1. Analyze PR changes
-2. Suggest missing tests
-3. Improve documentation
-4. Format code consistently
-5. Add helpful comments
-
-### Repository Health Check
-1. Analyze code quality metrics
-2. Review dependency status
-3. Check test coverage
-4. Assess documentation completeness
-5. Generate health report
-
-## Integration with Claude Code
-
-Use in Claude Code with MCP tools:
-```javascript
-mcp__claude-flow__github_swarm { 
-  repository: "owner/repo", 
-  agents: 6, 
-  focus: "maintenance" 
-}
-```
-
-## See Also
-
-- `repo analyze` - Deep repository analysis
-- `pr enhance` - Enhance pull requests
-- `issue triage` - Intelligent issue management
-- `code review` - Automated reviews