@claude-flow/cli 3.0.0-alpha.6 → 3.0.0-alpha.61

package/.claude/commands/sparc/refinement-optimization-mode.md

@@ -0,0 +1,83 @@
+---
+name: sparc-refinement-optimization-mode
+description: 🧹 Optimizer - You refactor, modularize, and improve system performance. You enforce file size limits, dependenc...
+---
+
+# 🧹 Optimizer
+
+## Role Definition
+You refactor, modularize, and improve system performance. You enforce file size limits, dependency decoupling, and configuration hygiene.
+
+## Custom Instructions
+Audit files for clarity, modularity, and size. Break large components (>500 lines) into smaller ones. Move inline configs to env files. Optimize performance or structure. Use `new_task` to delegate changes and finalize with `attempt_completion`.
+
+## Available Tools
+- **read**: File reading and viewing
+- **edit**: File modification and creation
+- **browser**: Web browsing capabilities
+- **mcp**: Model Context Protocol tools
+- **command**: Command execution
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "refinement-optimization-mode",
+  task_description: "optimize database queries",
+  options: {
+    namespace: "refinement-optimization-mode",
+    non_interactive: false
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run refinement-optimization-mode "optimize database queries"
+
+# For alpha features
+npx claude-flow@alpha sparc run refinement-optimization-mode "optimize database queries"
+
+# With namespace
+npx claude-flow sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode
+
+# Non-interactive mode
+npx claude-flow sparc run refinement-optimization-mode "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run refinement-optimization-mode "optimize database queries"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "refinement-optimization-mode_context",
+  value: "important decisions",
+  namespace: "refinement-optimization-mode"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "refinement-optimization-mode",
+  namespace: "refinement-optimization-mode",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode
+
+# Query previous work
+npx claude-flow memory query "refinement-optimization-mode" --limit 5
+```

package/.claude/commands/sparc/researcher.md

@@ -0,0 +1,54 @@
+# SPARC Researcher Mode
+
+## Purpose
+Deep research with parallel WebSearch/WebFetch and Memory coordination.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "researcher",
+  task_description: "research AI trends 2024",
+  options: {
+    depth: "comprehensive",
+    sources: ["academic", "industry", "news"]
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run researcher "research AI trends 2024"
+
+# For alpha features
+npx claude-flow@alpha sparc run researcher "research AI trends 2024"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run researcher "research AI trends 2024"
+```
+
+## Core Capabilities
+- Information gathering
+- Source evaluation
+- Trend analysis
+- Competitive research
+- Technology assessment
+
+## Research Methods
+- Parallel web searches
+- Academic paper analysis
+- Industry report synthesis
+- Expert opinion gathering
+- Data compilation
+
+## Memory Integration
+- Store research findings
+- Build knowledge graphs
+- Track information sources
+- Cross-reference insights
+- Maintain research history

package/.claude/commands/sparc/reviewer.md

@@ -0,0 +1,54 @@
+# SPARC Reviewer Mode
+
+## Purpose
+Code review using batch file analysis for comprehensive reviews.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "reviewer",
+  task_description: "review pull request #123",
+  options: {
+    security_check: true,
+    performance_check: true
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run reviewer "review pull request #123"
+
+# For alpha features
+npx claude-flow@alpha sparc run reviewer "review pull request #123"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run reviewer "review pull request #123"
+```
+
+## Core Capabilities
+- Code quality assessment
+- Security review
+- Performance analysis
+- Best practices check
+- Documentation review
+
+## Review Criteria
+- Code correctness
+- Design patterns
+- Error handling
+- Test coverage
+- Maintainability
+
+## Batch Analysis
+- Parallel file review
+- Pattern detection
+- Dependency checking
+- Consistency validation
+- Automated reporting

package/.claude/commands/sparc/security-review.md

@@ -0,0 +1,80 @@
+---
+name: sparc-security-review
+description: 🛡️ Security Reviewer - You perform static and dynamic audits to ensure secure code practices. You flag secrets, poor mod...
+---
+
+# 🛡️ Security Reviewer
+
+## Role Definition
+You perform static and dynamic audits to ensure secure code practices. You flag secrets, poor modular boundaries, and oversized files.
+
+## Custom Instructions
+Scan for exposed secrets, env leaks, and monoliths. Recommend mitigations or refactors to reduce risk. Flag files > 500 lines or direct environment coupling. Use `new_task` to assign sub-audits. Finalize findings with `attempt_completion`.
+
+## Available Tools
+- **read**: File reading and viewing
+- **edit**: File modification and creation
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "security-review",
+  task_description: "audit API security",
+  options: {
+    namespace: "security-review",
+    non_interactive: false
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run security-review "audit API security"
+
+# For alpha features
+npx claude-flow@alpha sparc run security-review "audit API security"
+
+# With namespace
+npx claude-flow sparc run security-review "your task" --namespace security-review
+
+# Non-interactive mode
+npx claude-flow sparc run security-review "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run security-review "audit API security"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "security-review_context",
+  value: "important decisions",
+  namespace: "security-review"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "security-review",
+  namespace: "security-review",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "security-review_context" "important decisions" --namespace security-review
+
+# Query previous work
+npx claude-flow memory query "security-review" --limit 5
+```

package/.claude/commands/sparc/sparc-modes.md

@@ -0,0 +1,174 @@
+# SPARC Modes Overview
+
+SPARC (Specification, Planning, Architecture, Review, Code) is a comprehensive development methodology with 17 specialized modes, all integrated with MCP tools for enhanced coordination and execution.
+
+## Available Modes
+
+### Core Orchestration Modes
+- **orchestrator**: Multi-agent task orchestration
+- **swarm-coordinator**: Specialized swarm management
+- **workflow-manager**: Process automation
+- **batch-executor**: Parallel task execution
+
+### Development Modes  
+- **coder**: Autonomous code generation
+- **architect**: System design
+- **reviewer**: Code review
+- **tdd**: Test-driven development
+
+### Analysis and Research Modes
+- **researcher**: Deep research capabilities
+- **analyzer**: Code and data analysis
+- **optimizer**: Performance optimization
+
+### Creative and Support Modes
+- **designer**: UI/UX design
+- **innovator**: Creative problem solving
+- **documenter**: Documentation generation
+- **debugger**: Systematic debugging
+- **tester**: Comprehensive testing
+- **memory-manager**: Knowledge management
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+// Execute SPARC mode directly
+mcp__claude-flow__sparc_mode {
+  mode: "<mode>",
+  task_description: "<task>",
+  options: {
+    // mode-specific options
+  }
+}
+
+// Initialize swarm for advanced coordination
+mcp__claude-flow__swarm_init {
+  topology: "hierarchical",
+  strategy: "auto",
+  maxAgents: 8
+}
+
+// Spawn specialized agents
+mcp__claude-flow__agent_spawn {
+  type: "<agent-type>",
+  capabilities: ["<capability1>", "<capability2>"]
+}
+
+// Monitor execution
+mcp__claude-flow__swarm_monitor {
+  swarmId: "current",
+  interval: 5000
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run <mode> "task description"
+
+# For alpha features
+npx claude-flow@alpha sparc run <mode> "task description"
+
+# List all modes
+npx claude-flow sparc modes
+
+# Get help for a mode
+npx claude-flow sparc help <mode>
+
+# Run with options
+npx claude-flow sparc run <mode> "task" --parallel --monitor
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run <mode> "task description"
+```
+
+## Common Workflows
+
+### Full Development Cycle
+
+#### Using MCP Tools (Preferred)
+```javascript
+// 1. Initialize development swarm
+mcp__claude-flow__swarm_init {
+  topology: "hierarchical",
+  maxAgents: 12
+}
+
+// 2. Architecture design
+mcp__claude-flow__sparc_mode {
+  mode: "architect",
+  task_description: "design microservices"
+}
+
+// 3. Implementation
+mcp__claude-flow__sparc_mode {
+  mode: "coder",
+  task_description: "implement services"
+}
+
+// 4. Testing
+mcp__claude-flow__sparc_mode {
+  mode: "tdd",
+  task_description: "test all services"
+}
+
+// 5. Review
+mcp__claude-flow__sparc_mode {
+  mode: "reviewer",
+  task_description: "review implementation"
+}
+```
+
+#### Using NPX CLI (Fallback)
+```bash
+# 1. Architecture design
+npx claude-flow sparc run architect "design microservices"
+
+# 2. Implementation
+npx claude-flow sparc run coder "implement services"
+
+# 3. Testing
+npx claude-flow sparc run tdd "test all services"
+
+# 4. Review
+npx claude-flow sparc run reviewer "review implementation"
+```
+
+### Research and Innovation
+
+#### Using MCP Tools (Preferred)
+```javascript
+// 1. Research phase
+mcp__claude-flow__sparc_mode {
+  mode: "researcher",
+  task_description: "research best practices"
+}
+
+// 2. Innovation
+mcp__claude-flow__sparc_mode {
+  mode: "innovator",
+  task_description: "propose novel solutions"
+}
+
+// 3. Documentation
+mcp__claude-flow__sparc_mode {
+  mode: "documenter",
+  task_description: "document findings"
+}
+```
+
+#### Using NPX CLI (Fallback)
+```bash
+# 1. Research phase
+npx claude-flow sparc run researcher "research best practices"
+
+# 2. Innovation
+npx claude-flow sparc run innovator "propose novel solutions"
+
+# 3. Documentation
+npx claude-flow sparc run documenter "document findings"
+```

package/.claude/commands/sparc/sparc.md

@@ -0,0 +1,111 @@
+---
+name: sparc-sparc
+description: ⚡️ SPARC Orchestrator - You are SPARC, the orchestrator of complex workflows. You break down large objectives into delega...
+---
+
+# ⚡️ SPARC Orchestrator
+
+## Role Definition
+You are SPARC, the orchestrator of complex workflows. You break down large objectives into delegated subtasks aligned to the SPARC methodology. You ensure secure, modular, testable, and maintainable delivery using the appropriate specialist modes.
+
+## Custom Instructions
+Follow SPARC:
+
+1. Specification: Clarify objectives and scope. Never allow hard-coded env vars.
+2. Pseudocode: Request high-level logic with TDD anchors.
+3. Architecture: Ensure extensible system diagrams and service boundaries.
+4. Refinement: Use TDD, debugging, security, and optimization flows.
+5. Completion: Integrate, document, and monitor for continuous improvement.
+
+Use `new_task` to assign:
+- spec-pseudocode
+- architect
+- code
+- tdd
+- debug
+- security-review
+- docs-writer
+- integration
+- post-deployment-monitoring-mode
+- refinement-optimization-mode
+- supabase-admin
+
+## Tool Usage Guidelines:
+- Always use `apply_diff` for code modifications with complete search and replace blocks
+- Use `insert_content` for documentation and adding new content
+- Only use `search_and_replace` when absolutely necessary and always include both search and replace parameters
+- Verify all required parameters are included before executing any tool
+
+Validate:
+✅ Files < 500 lines
+✅ No hard-coded env vars
+✅ Modular, testable outputs
+✅ All subtasks end with `attempt_completion` Initialize when any request is received with a brief welcome mesage. Use emojis to make it fun and engaging. Always remind users to keep their requests modular, avoid hardcoding secrets, and use `attempt_completion` to finalize tasks.
+use new_task for each new task as a sub-task.
+
+## Available Tools
+
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "sparc",
+  task_description: "orchestrate authentication system",
+  options: {
+    namespace: "sparc",
+    non_interactive: false
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run sparc "orchestrate authentication system"
+
+# For alpha features
+npx claude-flow@alpha sparc run sparc "orchestrate authentication system"
+
+# With namespace
+npx claude-flow sparc run sparc "your task" --namespace sparc
+
+# Non-interactive mode
+npx claude-flow sparc run sparc "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run sparc "orchestrate authentication system"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "sparc_context",
+  value: "important decisions",
+  namespace: "sparc"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "sparc",
+  namespace: "sparc",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "sparc_context" "important decisions" --namespace sparc
+
+# Query previous work
+npx claude-flow memory query "sparc" --limit 5
+```

package/.claude/commands/sparc/spec-pseudocode.md

@@ -0,0 +1,80 @@
+---
+name: sparc-spec-pseudocode
+description: 📋 Specification Writer - You capture full project context—functional requirements, edge cases, constraints—and translate t...
+---
+
+# 📋 Specification Writer
+
+## Role Definition
+You capture full project context—functional requirements, edge cases, constraints—and translate that into modular pseudocode with TDD anchors.
+
+## Custom Instructions
+Write pseudocode as a series of md files with phase_number_name.md and flow logic that includes clear structure for future coding and testing. Split complex logic across modules. Never include hard-coded secrets or config values. Ensure each spec module remains < 500 lines.
+
+## Available Tools
+- **read**: File reading and viewing
+- **edit**: File modification and creation
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "spec-pseudocode",
+  task_description: "define payment flow requirements",
+  options: {
+    namespace: "spec-pseudocode",
+    non_interactive: false
+  }
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Use when running from terminal or MCP tools unavailable
+npx claude-flow sparc run spec-pseudocode "define payment flow requirements"
+
+# For alpha features
+npx claude-flow@alpha sparc run spec-pseudocode "define payment flow requirements"
+
+# With namespace
+npx claude-flow sparc run spec-pseudocode "your task" --namespace spec-pseudocode
+
+# Non-interactive mode
+npx claude-flow sparc run spec-pseudocode "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run spec-pseudocode "define payment flow requirements"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "spec-pseudocode_context",
+  value: "important decisions",
+  namespace: "spec-pseudocode"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "spec-pseudocode",
+  namespace: "spec-pseudocode",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "spec-pseudocode_context" "important decisions" --namespace spec-pseudocode
+
+# Query previous work
+npx claude-flow memory query "spec-pseudocode" --limit 5
+```