claude-flow 3.28.0 → 3.29.0

package/.claude/commands/automation/session-memory.md

@@ -1,90 +1,90 @@
-# Cross-Session Memory
-
-## Purpose
-Maintain context and learnings across Claude Code sessions for continuous improvement.
-
-## Memory Features
-
-### 1. Automatic State Persistence
-At session end, automatically saves:
-- Active agents and specializations
-- Task history and patterns
-- Performance metrics
-- Neural network weights
-- Knowledge base updates
-
-### 2. Session Restoration
-```javascript
-// Using MCP tools for memory operations
-mcp__claude-flow__memory_usage({
-  "action": "retrieve",
-  "key": "session-state",
-  "namespace": "sessions"
-})
-
-// Restore swarm state
-mcp__claude-flow__context_restore({
-  "snapshotId": "sess-123"
-})
-```
-
-**Fallback with npx:**
-```bash
-npx claude-flow hook session-restore --session-id "sess-123"
-```
-
-### 3. Memory Types
-
-**Project Memory:**
-- File relationships
-- Common edit patterns
-- Testing approaches
-- Build configurations
-
-**Agent Memory:**
-- Specialization levels
-- Task success rates
-- Optimization strategies
-- Error patterns
-
-**Performance Memory:**
-- Bottleneck history
-- Optimization results
-- Token usage patterns
-- Efficiency trends
-
-### 4. Privacy & Control
-```javascript
-// List memory contents
-mcp__claude-flow__memory_usage({
-  "action": "list",
-  "namespace": "sessions"
-})
-
-// Delete specific memory
-mcp__claude-flow__memory_usage({
-  "action": "delete",
-  "key": "session-123",
-  "namespace": "sessions"
-})
-
-// Backup memory
-mcp__claude-flow__memory_backup({
-  "path": "./backups/memory-backup.json"
-})
-```
-
-**Manual control:**
-```bash
-# View stored memory
-ls .claude-flow/memory/
-
-# Disable memory
-export CLAUDE_FLOW_MEMORY_PERSIST=false
-```
-
-## Benefits
-- 🧠 Contextual awareness
-- 📈 Cumulative learning
-- ⚡ Faster task completion
+# Cross-Session Memory
+
+## Purpose
+Maintain context and learnings across Claude Code sessions for continuous improvement.
+
+## Memory Features
+
+### 1. Automatic State Persistence
+At session end, automatically saves:
+- Active agents and specializations
+- Task history and patterns
+- Performance metrics
+- Neural network weights
+- Knowledge base updates
+
+### 2. Session Restoration
+```javascript
+// Using MCP tools for memory operations
+mcp__claude-flow__memory_usage({
+  "action": "retrieve",
+  "key": "session-state",
+  "namespace": "sessions"
+})
+
+// Restore swarm state
+mcp__claude-flow__context_restore({
+  "snapshotId": "sess-123"
+})
+```
+
+**Fallback with npx:**
+```bash
+npx claude-flow hook session-restore --session-id "sess-123"
+```
+
+### 3. Memory Types
+
+**Project Memory:**
+- File relationships
+- Common edit patterns
+- Testing approaches
+- Build configurations
+
+**Agent Memory:**
+- Specialization levels
+- Task success rates
+- Optimization strategies
+- Error patterns
+
+**Performance Memory:**
+- Bottleneck history
+- Optimization results
+- Token usage patterns
+- Efficiency trends
+
+### 4. Privacy & Control
+```javascript
+// List memory contents
+mcp__claude-flow__memory_usage({
+  "action": "list",
+  "namespace": "sessions"
+})
+
+// Delete specific memory
+mcp__claude-flow__memory_usage({
+  "action": "delete",
+  "key": "session-123",
+  "namespace": "sessions"
+})
+
+// Backup memory
+mcp__claude-flow__memory_backup({
+  "path": "./backups/memory-backup.json"
+})
+```
+
+**Manual control:**
+```bash
+# View stored memory
+ls .claude-flow/memory/
+
+# Disable memory
+export CLAUDE_FLOW_MEMORY_PERSIST=false
+```
+
+## Benefits
+- 🧠 Contextual awareness
+- 📈 Cumulative learning
+- ⚡ Faster task completion
 - 🎯 Personalized optimization

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

@@ -1,73 +1,73 @@
-# Smart Agent Auto-Spawning
-
-## Purpose
-Automatically spawn the right agents at the right time without manual intervention.
-
-## Auto-Spawning Triggers
-
-### 1. File Type Detection
-When editing files, agents auto-spawn:
-- **JavaScript/TypeScript**: Coder agent
-- **Markdown**: Researcher agent
-- **JSON/YAML**: Analyst agent
-- **Multiple files**: Coordinator agent
-
-### 2. Task Complexity
-```
-Simple task: "Fix typo"
-→ Single coordinator agent
-
-Complex task: "Implement OAuth with Google"
-→ Architect + Coder + Tester + Researcher
-```
-
-### 3. Dynamic Scaling
-The system monitors workload and spawns additional agents when:
-- Task queue grows
-- Complexity increases
-- Parallel opportunities exist
-
-**Status Monitoring:**
-```javascript
-// Check swarm health
-mcp__claude-flow__swarm_status({
-  "swarmId": "current"
-})
-
-// Monitor agent performance
-mcp__claude-flow__agent_metrics({
-  "agentId": "agent-123"
-})
-```
-
-## Configuration
-
-### MCP Tool Integration
-Uses Claude Flow MCP tools for agent coordination:
-```javascript
-// Initialize swarm with appropriate topology
-mcp__claude-flow__swarm_init({
-  "topology": "mesh",
-  "maxAgents": 8,
-  "strategy": "auto"
-})
-
-// Spawn agents based on file type
-mcp__claude-flow__agent_spawn({
-  "type": "coder",
-  "name": "JavaScript Handler",
-  "capabilities": ["javascript", "typescript"]
-})
-```
-
-### Fallback Configuration
-If MCP tools are unavailable:
-```bash
-npx claude-flow hook pre-task --auto-spawn-agents
-```
-
-## Benefits
-- 🤖 Zero manual agent management
-- 🎯 Perfect agent selection
-- 📈 Dynamic scaling
+# Smart Agent Auto-Spawning
+
+## Purpose
+Automatically spawn the right agents at the right time without manual intervention.
+
+## Auto-Spawning Triggers
+
+### 1. File Type Detection
+When editing files, agents auto-spawn:
+- **JavaScript/TypeScript**: Coder agent
+- **Markdown**: Researcher agent
+- **JSON/YAML**: Analyst agent
+- **Multiple files**: Coordinator agent
+
+### 2. Task Complexity
+```
+Simple task: "Fix typo"
+→ Single coordinator agent
+
+Complex task: "Implement OAuth with Google"
+→ Architect + Coder + Tester + Researcher
+```
+
+### 3. Dynamic Scaling
+The system monitors workload and spawns additional agents when:
+- Task queue grows
+- Complexity increases
+- Parallel opportunities exist
+
+**Status Monitoring:**
+```javascript
+// Check swarm health
+mcp__claude-flow__swarm_status({
+  "swarmId": "current"
+})
+
+// Monitor agent performance
+mcp__claude-flow__agent_metrics({
+  "agentId": "agent-123"
+})
+```
+
+## Configuration
+
+### MCP Tool Integration
+Uses Claude Flow MCP tools for agent coordination:
+```javascript
+// Initialize swarm with appropriate topology
+mcp__claude-flow__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 8,
+  "strategy": "auto"
+})
+
+// Spawn agents based on file type
+mcp__claude-flow__agent_spawn({
+  "type": "coder",
+  "name": "JavaScript Handler",
+  "capabilities": ["javascript", "typescript"]
+})
+```
+
+### Fallback Configuration
+If MCP tools are unavailable:
+```bash
+npx claude-flow hook pre-task --auto-spawn-agents
+```
+
+## Benefits
+- 🤖 Zero manual agent management
+- 🎯 Perfect agent selection
+- 📈 Dynamic scaling
 - 💾 Resource efficiency

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

@@ -1,25 +1,25 @@
-# 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
-```
+# 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 +1,25 @@
-# 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
-```
+# 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/claude-flow-help.md

@@ -1,103 +1,103 @@
----
-name: claude-flow-help
-description: Show Claude-Flow commands and usage
----
-
-# Claude-Flow Commands
-
-## 🌊 Claude-Flow: Agent Orchestration Platform
-
-Claude-Flow is the ultimate multi-terminal orchestration platform that revolutionizes how you work with Claude Code.
-
-## Core Commands
-
-### 🚀 System Management
-- `./claude-flow start` - Start orchestration system
-- `./claude-flow start --ui` - Start with interactive process management UI
-- `./claude-flow status` - Check system status
-- `./claude-flow monitor` - Real-time monitoring
-- `./claude-flow stop` - Stop orchestration
-
-### 🤖 Agent Management
-- `./claude-flow agent spawn <type>` - Create new agent
-- `./claude-flow agent list` - List active agents
-- `./claude-flow agent info <id>` - Agent details
-- `./claude-flow agent terminate <id>` - Stop agent
-
-### 📋 Task Management
-- `./claude-flow task create <type> "description"` - Create task
-- `./claude-flow task list` - List all tasks
-- `./claude-flow task status <id>` - Task status
-- `./claude-flow task cancel <id>` - Cancel task
-- `./claude-flow task workflow <file>` - Execute workflow
-
-### 🧠 Memory Operations
-- `./claude-flow memory store "key" "value"` - Store data
-- `./claude-flow memory query "search"` - Search memory
-- `./claude-flow memory stats` - Memory statistics
-- `./claude-flow memory export <file>` - Export memory
-- `./claude-flow memory import <file>` - Import memory
-
-### ⚡ SPARC Development
-- `./claude-flow sparc "task"` - Run SPARC orchestrator
-- `./claude-flow sparc modes` - List all 17+ SPARC modes
-- `./claude-flow sparc run <mode> "task"` - Run specific mode
-- `./claude-flow sparc tdd "feature"` - TDD workflow
-- `./claude-flow sparc info <mode>` - Mode details
-
-### 🐝 Swarm Coordination
-- `./claude-flow swarm "task" --strategy <type>` - Start swarm
-- `./claude-flow swarm "task" --background` - Long-running swarm
-- `./claude-flow swarm "task" --monitor` - With monitoring
-- `./claude-flow swarm "task" --ui` - Interactive UI
-- `./claude-flow swarm "task" --distributed` - Distributed coordination
-
-### 🌍 MCP Integration
-- `./claude-flow mcp status` - MCP server status
-- `./claude-flow mcp tools` - List available tools
-- `./claude-flow mcp config` - Show configuration
-- `./claude-flow mcp logs` - View MCP logs
-
-### 🤖 Claude Integration
-- `./claude-flow claude spawn "task"` - Spawn Claude with enhanced guidance
-- `./claude-flow claude batch <file>` - Execute workflow configuration
-
-## 🌟 Quick Examples
-
-### Initialize with SPARC:
-```bash
-npx -y claude-flow@latest init --sparc
-```
-
-### Start a development swarm:
-```bash
-./claude-flow swarm "Build REST API" --strategy development --monitor --review
-```
-
-### Run TDD workflow:
-```bash
-./claude-flow sparc tdd "user authentication"
-```
-
-### Store project context:
-```bash
-./claude-flow memory store "project_requirements" "e-commerce platform specs" --namespace project
-```
-
-### Spawn specialized agents:
-```bash
-./claude-flow agent spawn researcher --name "Senior Researcher" --priority 8
-./claude-flow agent spawn developer --name "Lead Developer" --priority 9
-```
-
-## 🎯 Best Practices
-- Use `./claude-flow` instead of `npx claude-flow` after initialization
-- Store important context in memory for cross-session persistence
-- Use swarm mode for complex tasks requiring multiple agents
-- Enable monitoring for real-time progress tracking
-- Use background mode for tasks > 30 minutes
-
-## 📚 Resources
-- Documentation: https://github.com/ruvnet/claude-code-flow/docs
-- Examples: https://github.com/ruvnet/claude-code-flow/examples
-- Issues: https://github.com/ruvnet/claude-code-flow/issues
+---
+name: claude-flow-help
+description: Show Claude-Flow commands and usage
+---
+
+# Claude-Flow Commands
+
+## 🌊 Claude-Flow: Agent Orchestration Platform
+
+Claude-Flow is the ultimate multi-terminal orchestration platform that revolutionizes how you work with Claude Code.
+
+## Core Commands
+
+### 🚀 System Management
+- `./claude-flow start` - Start orchestration system
+- `./claude-flow start --ui` - Start with interactive process management UI
+- `./claude-flow status` - Check system status
+- `./claude-flow monitor` - Real-time monitoring
+- `./claude-flow stop` - Stop orchestration
+
+### 🤖 Agent Management
+- `./claude-flow agent spawn <type>` - Create new agent
+- `./claude-flow agent list` - List active agents
+- `./claude-flow agent info <id>` - Agent details
+- `./claude-flow agent terminate <id>` - Stop agent
+
+### 📋 Task Management
+- `./claude-flow task create <type> "description"` - Create task
+- `./claude-flow task list` - List all tasks
+- `./claude-flow task status <id>` - Task status
+- `./claude-flow task cancel <id>` - Cancel task
+- `./claude-flow task workflow <file>` - Execute workflow
+
+### 🧠 Memory Operations
+- `./claude-flow memory store "key" "value"` - Store data
+- `./claude-flow memory query "search"` - Search memory
+- `./claude-flow memory stats` - Memory statistics
+- `./claude-flow memory export <file>` - Export memory
+- `./claude-flow memory import <file>` - Import memory
+
+### ⚡ SPARC Development
+- `./claude-flow sparc "task"` - Run SPARC orchestrator
+- `./claude-flow sparc modes` - List all 17+ SPARC modes
+- `./claude-flow sparc run <mode> "task"` - Run specific mode
+- `./claude-flow sparc tdd "feature"` - TDD workflow
+- `./claude-flow sparc info <mode>` - Mode details
+
+### 🐝 Swarm Coordination
+- `./claude-flow swarm "task" --strategy <type>` - Start swarm
+- `./claude-flow swarm "task" --background` - Long-running swarm
+- `./claude-flow swarm "task" --monitor` - With monitoring
+- `./claude-flow swarm "task" --ui` - Interactive UI
+- `./claude-flow swarm "task" --distributed` - Distributed coordination
+
+### 🌍 MCP Integration
+- `./claude-flow mcp status` - MCP server status
+- `./claude-flow mcp tools` - List available tools
+- `./claude-flow mcp config` - Show configuration
+- `./claude-flow mcp logs` - View MCP logs
+
+### 🤖 Claude Integration
+- `./claude-flow claude spawn "task"` - Spawn Claude with enhanced guidance
+- `./claude-flow claude batch <file>` - Execute workflow configuration
+
+## 🌟 Quick Examples
+
+### Initialize with SPARC:
+```bash
+npx -y claude-flow@latest init --sparc
+```
+
+### Start a development swarm:
+```bash
+./claude-flow swarm "Build REST API" --strategy development --monitor --review
+```
+
+### Run TDD workflow:
+```bash
+./claude-flow sparc tdd "user authentication"
+```
+
+### Store project context:
+```bash
+./claude-flow memory store "project_requirements" "e-commerce platform specs" --namespace project
+```
+
+### Spawn specialized agents:
+```bash
+./claude-flow agent spawn researcher --name "Senior Researcher" --priority 8
+./claude-flow agent spawn developer --name "Lead Developer" --priority 9
+```
+
+## 🎯 Best Practices
+- Use `./claude-flow` instead of `npx claude-flow` after initialization
+- Store important context in memory for cross-session persistence
+- Use swarm mode for complex tasks requiring multiple agents
+- Enable monitoring for real-time progress tracking
+- Use background mode for tasks > 30 minutes
+
+## 📚 Resources
+- Documentation: https://github.com/ruvnet/claude-code-flow/docs
+- Examples: https://github.com/ruvnet/claude-code-flow/examples
+- Issues: https://github.com/ruvnet/claude-code-flow/issues