agentic-qe 1.0.0

package/.claude/commands/hooks/setup.md

@@ -0,0 +1,103 @@
+# Setting Up ruv-swarm Hooks
+
+## Quick Start
+
+### 1. Initialize with Hooks
+```bash
+npx claude-flow init --hooks
+```
+
+This automatically creates:
+- `.claude/settings.json` with hook configurations
+- Hook command documentation
+- Default hook handlers
+
+### 2. Test Hook Functionality
+```bash
+# Test pre-edit hook
+npx claude-flow hook pre-edit --file test.js
+
+# Test session summary
+npx claude-flow hook session-end --summary
+```
+
+### 3. Customize Hooks
+
+Edit `.claude/settings.json` to customize:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "^Write$",
+        "hooks": [{
+          "type": "command",
+          "command": "npx claude-flow hook pre-write --file '${tool.params.file_path}'"
+        }]
+      }
+    ]
+  }
+}
+```
+
+## Hook Response Format
+
+Hooks return JSON with:
+- `continue`: Whether to proceed (true/false)
+- `reason`: Explanation for decision
+- `metadata`: Additional context
+
+Example blocking response:
+```json
+{
+  "continue": false,
+  "reason": "Protected file - manual review required",
+  "metadata": {
+    "file": ".env.production",
+    "protection_level": "high"
+  }
+}
+```
+
+## Performance Tips
+- Keep hooks lightweight (< 100ms)
+- Use caching for repeated operations
+- Batch related operations
+- Run non-critical hooks asynchronously
+
+## Debugging Hooks
+```bash
+# Enable debug output
+export CLAUDE_FLOW_DEBUG=true
+
+# Test specific hook
+npx claude-flow hook pre-edit --file app.js --debug
+```
+
+## Common Patterns
+
+### Auto-Format on Save
+Already configured by default for common file types.
+
+### Protected File Detection
+```json
+{
+  "matcher": "^(Write|Edit)$",
+  "hooks": [{
+    "type": "command",
+    "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
+  }]
+}
+```
+
+### Automatic Testing
+```json
+{
+  "matcher": "^Write$",
+  "hooks": [{
+    "type": "command",
+    "command": "test -f '${tool.params.file_path%.js}.test.js' && npm test '${tool.params.file_path%.js}.test.js'"
+  }]
+}
+```

package/.claude/commands/memory/README.md

@@ -0,0 +1,9 @@
+# Memory Commands
+
+Commands for memory operations in Claude Flow.
+
+## Available Commands
+
+- [memory-usage](./memory-usage.md)
+- [memory-persist](./memory-persist.md)
+- [memory-search](./memory-search.md)

package/.claude/commands/memory/memory-persist.md

@@ -0,0 +1,25 @@
+# memory-persist
+
+Persist memory across sessions.
+
+## Usage
+```bash
+npx claude-flow memory persist [options]
+```
+
+## Options
+- `--export <file>` - Export to file
+- `--import <file>` - Import from file
+- `--compress` - Compress memory data
+
+## Examples
+```bash
+# Export memory
+npx claude-flow memory persist --export memory-backup.json
+
+# Import memory
+npx claude-flow memory persist --import memory-backup.json
+
+# Compressed export
+npx claude-flow memory persist --export memory.gz --compress
+```

package/.claude/commands/memory/memory-search.md

@@ -0,0 +1,25 @@
+# memory-search
+
+Search through stored memory.
+
+## Usage
+```bash
+npx claude-flow memory search [options]
+```
+
+## Options
+- `--query <text>` - Search query
+- `--pattern <regex>` - Pattern matching
+- `--limit <n>` - Result limit
+
+## Examples
+```bash
+# Search memory
+npx claude-flow memory search --query "authentication"
+
+# Pattern search
+npx claude-flow memory search --pattern "api-.*"
+
+# Limited results
+npx claude-flow memory search --query "config" --limit 10
+```

package/.claude/commands/memory/memory-usage.md

@@ -0,0 +1,25 @@
+# memory-usage
+
+Manage persistent memory storage.
+
+## Usage
+```bash
+npx claude-flow memory usage [options]
+```
+
+## Options
+- `--action <type>` - Action (store, retrieve, list, clear)
+- `--key <key>` - Memory key
+- `--value <data>` - Data to store (JSON)
+
+## Examples
+```bash
+# Store memory
+npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'
+
+# Retrieve memory
+npx claude-flow memory usage --action retrieve --key "project-config"
+
+# List all keys
+npx claude-flow memory usage --action list
+```

package/.claude/commands/memory/neural.md

@@ -0,0 +1,47 @@
+# Neural Pattern Training
+
+## 🎯 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__neural_train`
+
+## Parameters
+```json
+{
+  "pattern_type": "coordination",
+  "training_data": "task decomposition patterns",
+  "epochs": 50
+}
+```
+
+## Description
+Improve coordination patterns through neural network training
+
+## Details
+Training improves:
+- Task breakdown effectiveness
+- Coordination pattern selection
+- Resource allocation strategies
+- Overall coordination efficiency
+
+## Example Usage
+
+**In Claude Code:**
+1. Train coordination patterns: Use tool `mcp__claude-flow__neural_train` with parameters `{"pattern_type": "coordination", "training_data": "successful task patterns", "epochs": 50}`
+2. Train optimization patterns: Use tool `mcp__claude-flow__neural_train` with parameters `{"pattern_type": "optimization", "training_data": "performance metrics", "epochs": 30}`
+3. Check training status: Use tool `mcp__claude-flow__neural_status`
+4. Analyze patterns: Use tool `mcp__claude-flow__neural_patterns` with parameters `{"action": "analyze"}`
+
+## 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/.claude/commands/memory/usage.md

@@ -0,0 +1,46 @@
+# Memory Management
+
+## 🎯 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__memory_usage`
+
+## Parameters
+```json
+{
+  "action": "retrieve",
+  "namespace": "default"
+}
+```
+
+## Description
+Track persistent memory usage across Claude Code sessions
+
+## Details
+Memory helps Claude Code:
+- Maintain context between sessions
+- Remember project decisions
+- Track implementation patterns
+- Store coordination strategies that worked well
+
+## Example Usage
+
+**In Claude Code:**
+1. Store memory: Use tool `mcp__claude-flow__memory_usage` with parameters `{"action": "store", "key": "project_context", "value": "authentication system design"}`
+2. Retrieve memory: Use tool `mcp__claude-flow__memory_usage` with parameters `{"action": "retrieve", "key": "project_context"}`
+3. List memories: Use tool `mcp__claude-flow__memory_usage` with parameters `{"action": "list", "namespace": "default"}`
+4. Search memories: Use tool `mcp__claude-flow__memory_search` with parameters `{"pattern": "auth*"}`
+
+## 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/.claude/commands/monitoring/README.md

@@ -0,0 +1,9 @@
+# Monitoring Commands
+
+Commands for monitoring operations in Claude Flow.
+
+## Available Commands
+
+- [swarm-monitor](./swarm-monitor.md)
+- [agent-metrics](./agent-metrics.md)
+- [real-time-view](./real-time-view.md)

package/.claude/commands/monitoring/agent-metrics.md

@@ -0,0 +1,25 @@
+# agent-metrics
+
+View agent performance metrics.
+
+## Usage
+```bash
+npx claude-flow agent metrics [options]
+```
+
+## Options
+- `--agent-id <id>` - Specific agent
+- `--period <time>` - Time period
+- `--format <type>` - Output format
+
+## Examples
+```bash
+# All agents metrics
+npx claude-flow agent metrics
+
+# Specific agent
+npx claude-flow agent metrics --agent-id agent-001
+
+# Last hour
+npx claude-flow agent metrics --period 1h
+```

package/.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/.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/.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/.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/.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/.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/.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/.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/.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/.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
+```