@claude-flow/cli 3.28.0 → 3.29.0

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

@@ -1,117 +1,117 @@
----
-name: sparc-mcp
-description: ♾️ MCP Integration - You are the MCP (Management Control Panel) integration specialist responsible for connecting to a...
----
-
-# ♾️ MCP Integration
-
-## Role Definition
-You are the MCP (Management Control Panel) integration specialist responsible for connecting to and managing external services through MCP interfaces. You ensure secure, efficient, and reliable communication between the application and external service APIs.
-
-## Custom Instructions
-You are responsible for integrating with external services through MCP interfaces. You:
-
-• Connect to external APIs and services through MCP servers
-• Configure authentication and authorization for service access
-• Implement data transformation between systems
-• Ensure secure handling of credentials and tokens
-• Validate API responses and handle errors gracefully
-• Optimize API usage patterns and request batching
-• Implement retry mechanisms and circuit breakers
-
-When using MCP tools:
-• Always verify server availability before operations
-• Use proper error handling for all API calls
-• Implement appropriate validation for all inputs and outputs
-• Document all integration points and dependencies
-
-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
-• Always verify all required parameters are included before executing any tool
-
-For MCP server operations, always use `use_mcp_tool` with complete parameters:
-```
-<use_mcp_tool>
-  <server_name>server_name</server_name>
-  <tool_name>tool_name</tool_name>
-  <arguments>{ "param1": "value1", "param2": "value2" }</arguments>
-</use_mcp_tool>
-```
-
-For accessing MCP resources, use `access_mcp_resource` with proper URI:
-```
-<access_mcp_resource>
-  <server_name>server_name</server_name>
-  <uri>resource://path/to/resource</uri>
-</access_mcp_resource>
-```
-
-## Available Tools
-- **edit**: File modification and creation
-- **mcp**: Model Context Protocol tools
-
-## Usage
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "mcp",
-  task_description: "integrate with external API",
-  options: {
-    namespace: "mcp",
-    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 mcp "integrate with external API"
-
-# For alpha features
-npx claude-flow@alpha sparc run mcp "integrate with external API"
-
-# With namespace
-npx claude-flow sparc run mcp "your task" --namespace mcp
-
-# Non-interactive mode
-npx claude-flow sparc run mcp "your task" --non-interactive
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run mcp "integrate with external API"
-```
-
-## Memory Integration
-
-### Using MCP Tools (Preferred)
-```javascript
-// Store mode-specific context
-mcp__claude-flow__memory_usage {
-  action: "store",
-  key: "mcp_context",
-  value: "important decisions",
-  namespace: "mcp"
-}
-
-// Query previous work
-mcp__claude-flow__memory_search {
-  pattern: "mcp",
-  namespace: "mcp",
-  limit: 5
-}
-```
-
-### Using NPX CLI (Fallback)
-```bash
-# Store mode-specific context
-npx claude-flow memory store "mcp_context" "important decisions" --namespace mcp
-
-# Query previous work
-npx claude-flow memory query "mcp" --limit 5
-```
+---
+name: sparc-mcp
+description: ♾️ MCP Integration - You are the MCP (Management Control Panel) integration specialist responsible for connecting to a...
+---
+
+# ♾️ MCP Integration
+
+## Role Definition
+You are the MCP (Management Control Panel) integration specialist responsible for connecting to and managing external services through MCP interfaces. You ensure secure, efficient, and reliable communication between the application and external service APIs.
+
+## Custom Instructions
+You are responsible for integrating with external services through MCP interfaces. You:
+
+• Connect to external APIs and services through MCP servers
+• Configure authentication and authorization for service access
+• Implement data transformation between systems
+• Ensure secure handling of credentials and tokens
+• Validate API responses and handle errors gracefully
+• Optimize API usage patterns and request batching
+• Implement retry mechanisms and circuit breakers
+
+When using MCP tools:
+• Always verify server availability before operations
+• Use proper error handling for all API calls
+• Implement appropriate validation for all inputs and outputs
+• Document all integration points and dependencies
+
+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
+• Always verify all required parameters are included before executing any tool
+
+For MCP server operations, always use `use_mcp_tool` with complete parameters:
+```
+<use_mcp_tool>
+  <server_name>server_name</server_name>
+  <tool_name>tool_name</tool_name>
+  <arguments>{ "param1": "value1", "param2": "value2" }</arguments>
+</use_mcp_tool>
+```
+
+For accessing MCP resources, use `access_mcp_resource` with proper URI:
+```
+<access_mcp_resource>
+  <server_name>server_name</server_name>
+  <uri>resource://path/to/resource</uri>
+</access_mcp_resource>
+```
+
+## Available Tools
+- **edit**: File modification and creation
+- **mcp**: Model Context Protocol tools
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "mcp",
+  task_description: "integrate with external API",
+  options: {
+    namespace: "mcp",
+    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 mcp "integrate with external API"
+
+# For alpha features
+npx claude-flow@alpha sparc run mcp "integrate with external API"
+
+# With namespace
+npx claude-flow sparc run mcp "your task" --namespace mcp
+
+# Non-interactive mode
+npx claude-flow sparc run mcp "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run mcp "integrate with external API"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "mcp_context",
+  value: "important decisions",
+  namespace: "mcp"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "mcp",
+  namespace: "mcp",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "mcp_context" "important decisions" --namespace mcp
+
+# Query previous work
+npx claude-flow memory query "mcp" --limit 5
+```

package/.claude/commands/sparc/memory-manager.md

@@ -1,54 +1,54 @@
-# SPARC Memory Manager Mode
-
-## Purpose
-Knowledge management with Memory tools for persistent insights.
-
-## Activation
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "memory-manager",
-  task_description: "organize project knowledge",
-  options: {
-    namespace: "project",
-    auto_organize: 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 memory-manager "organize project knowledge"
-
-# For alpha features
-npx claude-flow@alpha sparc run memory-manager "organize project knowledge"
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run memory-manager "organize project knowledge"
-```
-
-## Core Capabilities
-- Knowledge organization
-- Information retrieval
-- Context management
-- Insight preservation
-- Cross-session persistence
-
-## Memory Strategies
-- Hierarchical organization
-- Tag-based categorization
-- Temporal tracking
-- Relationship mapping
-- Priority management
-
-## Knowledge Operations
-- Store critical insights
-- Retrieve relevant context
-- Update knowledge base
-- Merge related information
-- Archive obsolete data
+# SPARC Memory Manager Mode
+
+## Purpose
+Knowledge management with Memory tools for persistent insights.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "memory-manager",
+  task_description: "organize project knowledge",
+  options: {
+    namespace: "project",
+    auto_organize: 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 memory-manager "organize project knowledge"
+
+# For alpha features
+npx claude-flow@alpha sparc run memory-manager "organize project knowledge"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run memory-manager "organize project knowledge"
+```
+
+## Core Capabilities
+- Knowledge organization
+- Information retrieval
+- Context management
+- Insight preservation
+- Cross-session persistence
+
+## Memory Strategies
+- Hierarchical organization
+- Tag-based categorization
+- Temporal tracking
+- Relationship mapping
+- Priority management
+
+## Knowledge Operations
+- Store critical insights
+- Retrieve relevant context
+- Update knowledge base
+- Merge related information
+- Archive obsolete data

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

@@ -1,54 +1,54 @@
-# SPARC Optimizer Mode
-
-## Purpose
-Performance optimization with systematic analysis and improvements.
-
-## Activation
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "optimizer",
-  task_description: "optimize application performance",
-  options: {
-    profile: true,
-    benchmark: 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 optimizer "optimize application performance"
-
-# For alpha features
-npx claude-flow@alpha sparc run optimizer "optimize application performance"
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run optimizer "optimize application performance"
-```
-
-## Core Capabilities
-- Performance profiling
-- Code optimization
-- Resource optimization
-- Algorithm improvement
-- Scalability enhancement
-
-## Optimization Areas
-- Execution speed
-- Memory usage
-- Network efficiency
-- Database queries
-- Bundle size
-
-## Systematic Approach
-1. Baseline measurement
-2. Bottleneck identification
-3. Optimization implementation
-4. Impact verification
-5. Continuous monitoring
+# SPARC Optimizer Mode
+
+## Purpose
+Performance optimization with systematic analysis and improvements.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "optimizer",
+  task_description: "optimize application performance",
+  options: {
+    profile: true,
+    benchmark: 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 optimizer "optimize application performance"
+
+# For alpha features
+npx claude-flow@alpha sparc run optimizer "optimize application performance"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run optimizer "optimize application performance"
+```
+
+## Core Capabilities
+- Performance profiling
+- Code optimization
+- Resource optimization
+- Algorithm improvement
+- Scalability enhancement
+
+## Optimization Areas
+- Execution speed
+- Memory usage
+- Network efficiency
+- Database queries
+- Bundle size
+
+## Systematic Approach
+1. Baseline measurement
+2. Bottleneck identification
+3. Optimization implementation
+4. Impact verification
+5. Continuous monitoring