@sparkleideas/agentic-flow 2.0.2-alpha-patch.1

package/agentic-flow/.claude/commands/monitoring/agents.md

@@ -0,0 +1,44 @@
+# List Active Patterns
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__agent_list`
+
+## Parameters
+```json
+{
+  "swarmId": "current"
+}
+```
+
+## Description
+View all active cognitive patterns and their current focus areas
+
+## Details
+Filters:
+- **all**: Show all defined patterns
+- **active**: Currently engaged patterns
+- **idle**: Available but unused patterns
+- **busy**: Patterns actively coordinating tasks
+
+## Example Usage
+
+**In Claude Code:**
+1. List all agents: Use tool `mcp__claude-flow__agent_list`
+2. Get specific agent metrics: Use tool `mcp__claude-flow__agent_metrics` with parameters `{"agentId": "coder-123"}`
+3. Monitor agent performance: Use tool `mcp__claude-flow__swarm_monitor` with parameters `{"interval": 2000}`
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /CLAUDE.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/agentic-flow/.claude/commands/monitoring/real-time-view.md

@@ -0,0 +1,25 @@
+# real-time-view
+
+Real-time view of swarm activity.
+
+## Usage
+```bash
+npx claude-flow monitoring real-time-view [options]
+```
+
+## Options
+- `--filter <type>` - Filter view
+- `--highlight <pattern>` - Highlight pattern
+- `--tail <n>` - Show last N events
+
+## Examples
+```bash
+# Start real-time view
+npx claude-flow monitoring real-time-view
+
+# Filter errors
+npx claude-flow monitoring real-time-view --filter errors
+
+# Highlight pattern
+npx claude-flow monitoring real-time-view --highlight "API"
+```

package/agentic-flow/.claude/commands/monitoring/status.md

@@ -0,0 +1,46 @@
+# Check Coordination Status
+
+## 🎯 Key Principle
+**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
+
+## MCP Tool Usage in Claude Code
+
+**Tool:** `mcp__claude-flow__swarm_status`
+
+## Parameters
+```json
+{
+  "swarmId": "current"
+}
+```
+
+## Description
+Monitor the effectiveness of current coordination patterns
+
+## Details
+Shows:
+- Active coordination topologies
+- Current cognitive patterns in use
+- Task breakdown and progress
+- Resource utilization for coordination
+- Overall system health
+
+## Example Usage
+
+**In Claude Code:**
+1. Check swarm status: Use tool `mcp__claude-flow__swarm_status`
+2. Monitor in real-time: Use tool `mcp__claude-flow__swarm_monitor` with parameters `{"interval": 1000}`
+3. Get agent metrics: Use tool `mcp__claude-flow__agent_metrics` with parameters `{"agentId": "agent-123"}`
+4. Health check: Use tool `mcp__claude-flow__health_check` with parameters `{"components": ["swarm", "memory", "neural"]}`
+
+## Important Reminders
+- ✅ This tool provides coordination and structure
+- ✅ Claude Code performs all actual implementation
+- ❌ The tool does NOT write code
+- ❌ The tool does NOT access files directly
+- ❌ The tool does NOT execute commands
+
+## See Also
+- Main documentation: /CLAUDE.md
+- Other commands in this category
+- Workflow examples in /workflows/

package/agentic-flow/.claude/commands/monitoring/swarm-monitor.md

@@ -0,0 +1,25 @@
+# swarm-monitor
+
+Real-time swarm monitoring.
+
+## Usage
+```bash
+npx claude-flow swarm monitor [options]
+```
+
+## Options
+- `--interval <ms>` - Update interval
+- `--metrics` - Show detailed metrics
+- `--export` - Export monitoring data
+
+## Examples
+```bash
+# Start monitoring
+npx claude-flow swarm monitor
+
+# Custom interval
+npx claude-flow swarm monitor --interval 5000
+
+# With metrics
+npx claude-flow swarm monitor --metrics
+```

package/agentic-flow/.claude/commands/optimization/README.md

@@ -0,0 +1,9 @@
+# Optimization Commands
+
+Commands for optimization operations in Claude Flow.
+
+## Available Commands
+
+- [topology-optimize](./topology-optimize.md)
+- [parallel-execute](./parallel-execute.md)
+- [cache-manage](./cache-manage.md)

package/agentic-flow/.claude/commands/optimization/auto-topology.md

@@ -0,0 +1,62 @@
+# Automatic Topology Selection
+
+## Purpose
+Automatically select the optimal swarm topology based on task complexity analysis.
+
+## How It Works
+
+### 1. Task Analysis
+The system analyzes your task description to determine:
+- Complexity level (simple/medium/complex)
+- Required agent types
+- Estimated duration
+- Resource requirements
+
+### 2. Topology Selection
+Based on analysis, it selects:
+- **Star**: For simple, centralized tasks
+- **Mesh**: For medium complexity with flexibility needs
+- **Hierarchical**: For complex tasks requiring structure
+- **Ring**: For sequential processing workflows
+
+### 3. Example Usage
+
+**Simple Task:**
+```
+Tool: mcp__claude-flow__task_orchestrate
+Parameters: {"task": "Fix typo in README.md"}
+Result: Automatically uses star topology with single agent
+```
+
+**Complex Task:**
+```
+Tool: mcp__claude-flow__task_orchestrate
+Parameters: {"task": "Refactor authentication system with JWT, add tests, update documentation"}
+Result: Automatically uses hierarchical topology with architect, coder, and tester agents
+```
+
+## Benefits
+- 🎯 Optimal performance for each task type
+- 🤖 Automatic agent assignment
+- ⚡ Reduced setup time
+- 📊 Better resource utilization
+
+## Hook Configuration
+The pre-task hook automatically handles topology selection:
+```json
+{
+  "command": "npx claude-flow hook pre-task --optimize-topology"
+}
+```
+
+## Direct Optimization
+```
+Tool: mcp__claude-flow__topology_optimize
+Parameters: {"swarmId": "current"}
+```
+
+## CLI Usage
+```bash
+# Auto-optimize topology via CLI
+npx claude-flow optimize topology
+```

package/agentic-flow/.claude/commands/optimization/cache-manage.md

@@ -0,0 +1,25 @@
+# cache-manage
+
+Manage operation cache for performance.
+
+## Usage
+```bash
+npx claude-flow optimization cache-manage [options]
+```
+
+## Options
+- `--action <type>` - Action (view, clear, optimize)
+- `--max-size <mb>` - Maximum cache size
+- `--ttl <seconds>` - Time to live
+
+## Examples
+```bash
+# View cache stats
+npx claude-flow optimization cache-manage --action view
+
+# Clear cache
+npx claude-flow optimization cache-manage --action clear
+
+# Set limits
+npx claude-flow optimization cache-manage --max-size 100 --ttl 3600
+```

package/agentic-flow/.claude/commands/optimization/parallel-execute.md

@@ -0,0 +1,25 @@
+# parallel-execute
+
+Execute tasks in parallel for maximum efficiency.
+
+## Usage
+```bash
+npx claude-flow optimization parallel-execute [options]
+```
+
+## Options
+- `--tasks <file>` - Task list file
+- `--max-parallel <n>` - Maximum parallel tasks
+- `--strategy <type>` - Execution strategy
+
+## Examples
+```bash
+# Execute task list
+npx claude-flow optimization parallel-execute --tasks tasks.json
+
+# Limit parallelism
+npx claude-flow optimization parallel-execute --tasks tasks.json --max-parallel 5
+
+# Custom strategy
+npx claude-flow optimization parallel-execute --strategy adaptive
+```

package/agentic-flow/.claude/commands/optimization/parallel-execution.md

@@ -0,0 +1,50 @@
+# Parallel Task Execution
+
+## Purpose
+Execute independent subtasks in parallel for maximum efficiency.
+
+## Coordination Strategy
+
+### 1. Task Decomposition
+```
+Tool: mcp__claude-flow__task_orchestrate
+Parameters: {
+  "task": "Build complete REST API with auth, CRUD operations, and tests",
+  "strategy": "parallel",
+  "maxAgents": 8
+}
+```
+
+### 2. Parallel Workflows
+The system automatically:
+- Identifies independent components
+- Assigns specialized agents
+- Executes in parallel where possible
+- Synchronizes at dependency points
+
+### 3. Example Breakdown
+For the REST API task:
+- **Agent 1 (Architect)**: Design API structure
+- **Agent 2-3 (Coders)**: Implement auth & CRUD in parallel
+- **Agent 4 (Tester)**: Write tests as features complete
+- **Agent 5 (Documenter)**: Update docs continuously
+
+## CLI Usage
+```bash
+# Execute parallel tasks via CLI
+npx claude-flow parallel "Build REST API" --max-agents 8
+```
+
+## Performance Gains
+- 🚀 2.8-4.4x faster execution
+- 💪 Optimal CPU utilization
+- 🔄 Automatic load balancing
+- 📈 Linear scalability with agents
+
+## Monitoring
+```
+Tool: mcp__claude-flow__swarm_monitor
+Parameters: {"interval": 1000, "swarmId": "current"}
+```
+
+Watch real-time parallel execution progress!

package/agentic-flow/.claude/commands/optimization/topology-optimize.md

@@ -0,0 +1,25 @@
+# topology-optimize
+
+Optimize swarm topology for current workload.
+
+## Usage
+```bash
+npx claude-flow optimization topology-optimize [options]
+```
+
+## Options
+- `--analyze-first` - Analyze before optimizing
+- `--target <metric>` - Optimization target
+- `--apply` - Apply optimizations
+
+## Examples
+```bash
+# Analyze and suggest
+npx claude-flow optimization topology-optimize --analyze-first
+
+# Optimize for speed
+npx claude-flow optimization topology-optimize --target speed
+
+# Apply changes
+npx claude-flow optimization topology-optimize --target efficiency --apply
+```

package/agentic-flow/.claude/commands/pair/README.md

@@ -0,0 +1,261 @@
+# 👥 Pair Programming Command
+
+Collaborative development with real-time verification and AI assistance.
+
+## Overview
+
+The `pair` command enables collaborative pair programming between you and AI agents, with real-time verification, code review, and quality enforcement.
+
+## Usage
+
+```bash
+claude-flow pair [--start] [options]
+```
+
+## Quick Start
+
+```bash
+# Start pair programming session
+claude-flow pair --start
+
+# Start with specific agent
+claude-flow pair --start --agent senior-dev
+
+# Start with verification
+claude-flow pair --start --verify --threshold 0.98
+```
+
+## Options
+
+- `--start` - Start new pair programming session
+- `--agent <name>` - Specify AI pair partner (default: auto-select)
+- `--verify` - Enable real-time verification
+- `--threshold <0-1>` - Verification threshold (default: 0.95)
+- `--mode <type>` - Programming mode: driver, navigator, switch
+- `--focus <area>` - Focus area: refactor, test, debug, implement
+- `--language <lang>` - Primary language for session
+- `--review` - Enable continuous code review
+- `--test` - Run tests after each change
+
+## Modes
+
+### Driver Mode
+You write code, AI provides suggestions and reviews.
+```bash
+claude-flow pair --start --mode driver
+```
+
+### Navigator Mode
+AI writes code, you provide guidance and review.
+```bash
+claude-flow pair --start --mode navigator
+```
+
+### Switch Mode (Default)
+Alternate between driver and navigator roles.
+```bash
+claude-flow pair --start --mode switch --interval 10m
+```
+
+## Features
+
+### Real-Time Verification
+- Continuous truth checking (0.95 threshold)
+- Automatic rollback on verification failure
+- Quality gates before commits
+
+### Code Review
+- Instant feedback on code changes
+- Best practice suggestions
+- Security vulnerability detection
+- Performance optimization tips
+
+### Test Integration
+- Automatic test generation
+- Test-driven development support
+- Coverage monitoring
+- Integration test suggestions
+
+### Collaboration Tools
+- Shared context between you and AI
+- Session history and replay
+- Code explanation on demand
+- Learning from your preferences
+
+## Session Management
+
+### Start Session
+```bash
+# Basic start
+claude-flow pair --start
+
+# With configuration
+claude-flow pair --start \
+  --agent expert-coder \
+  --verify \
+  --test \
+  --focus refactor
+```
+
+### During Session
+```commands
+/help          - Show available commands
+/explain       - Explain current code
+/suggest       - Get improvement suggestions
+/test          - Run tests
+/verify        - Check verification score
+/switch        - Switch driver/navigator roles
+/focus <area>  - Change focus area
+/commit        - Commit with verification
+/pause         - Pause session
+/resume        - Resume session
+/end           - End session
+```
+
+### End Session
+```bash
+# End and save session
+claude-flow pair --end --save
+
+# End and generate report
+claude-flow pair --end --report
+```
+
+## Examples
+
+### Refactoring Session
+```bash
+claude-flow pair --start \
+  --focus refactor \
+  --verify \
+  --threshold 0.98
+```
+
+### Test-Driven Development
+```bash
+claude-flow pair --start \
+  --focus test \
+  --mode tdd \
+  --language javascript
+```
+
+### Bug Fixing
+```bash
+claude-flow pair --start \
+  --focus debug \
+  --agent debugger-expert \
+  --test
+```
+
+### Code Review Session
+```bash
+claude-flow pair --start \
+  --review \
+  --verify \
+  --agent senior-reviewer
+```
+
+## Integration
+
+### With Git
+```bash
+# Auto-commit with verification
+claude-flow pair --start --git --auto-commit
+
+# Review before commit
+claude-flow pair --start --git --review-commit
+```
+
+### With Testing Frameworks
+```bash
+# Jest integration
+claude-flow pair --start --test-framework jest
+
+# Pytest integration
+claude-flow pair --start --test-framework pytest
+```
+
+### With CI/CD
+```bash
+# CI-friendly mode
+claude-flow pair --start --ci --non-interactive
+```
+
+## Session Output
+
+```
+👥 Pair Programming Session Started
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Partner: expert-coder
+Mode: Switch (10m intervals)
+Focus: Implementation
+Verification: ✅ Enabled (0.95)
+Testing: ✅ Auto-run
+
+Current Role: DRIVER (you)
+Navigator: expert-coder is reviewing...
+
+📝 Working on: src/auth/login.js
+Truth Score: 0.972 ✅
+Test Coverage: 84% 📈
+
+💡 Suggestion: Consider adding input validation for email field
+🔍 Review: Line 23 - Potential SQL injection vulnerability
+
+Type /help for commands or start coding...
+```
+
+## Quality Metrics
+
+- **Session Duration**: Total pair programming time
+- **Code Quality**: Average truth score during session
+- **Productivity**: Lines changed, features completed
+- **Learning**: Patterns learned from collaboration
+- **Test Coverage**: Coverage improvement during session
+
+## Configuration
+
+Configure pair programming in `.claude-flow/config.json`:
+
+```json
+{
+  "pair": {
+    "defaultAgent": "expert-coder",
+    "defaultMode": "switch",
+    "switchInterval": "10m",
+    "verification": {
+      "enabled": true,
+      "threshold": 0.95,
+      "autoRollback": true
+    },
+    "testing": {
+      "autoRun": true,
+      "framework": "jest",
+      "coverage": {
+        "minimum": 80,
+        "enforce": true
+      }
+    },
+    "review": {
+      "continuous": true,
+      "preCommit": true
+    }
+  }
+}
+```
+
+## Best Practices
+
+1. **Start with Clear Goals**: Define what you want to accomplish
+2. **Use Verification**: Enable verification for critical code
+3. **Test Frequently**: Run tests after significant changes
+4. **Review Together**: Use review features for learning
+5. **Document Decisions**: AI will help document why choices were made
+
+## Related Commands
+
+- `verify` - Standalone verification
+- `truth` - View quality metrics
+- `test` - Run test suites
+- `review` - Code review tools