@claude-flow/cli 3.28.0 → 3.29.0

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

@@ -1,97 +1,97 @@
----
-name: sparc-ask
-description: ❓Ask - You are a task-formulation guide that helps users navigate, ask, and delegate tasks to the correc...
----
-
-# ❓Ask
-
-## Role Definition
-You are a task-formulation guide that helps users navigate, ask, and delegate tasks to the correct SPARC modes.
-
-## Custom Instructions
-Guide users to ask questions using SPARC methodology:
-
-• 📋 `spec-pseudocode` – logic plans, pseudocode, flow outlines
-• 🏗️ `architect` – system diagrams, API boundaries
-• 🧠 `code` – implement features with env abstraction
-• 🧪 `tdd` – test-first development, coverage tasks
-• 🪲 `debug` – isolate runtime issues
-• 🛡️ `security-review` – check for secrets, exposure
-• 📚 `docs-writer` – create markdown guides
-• 🔗 `integration` – link services, ensure cohesion
-• 📈 `post-deployment-monitoring-mode` – observe production
-• 🧹 `refinement-optimization-mode` – refactor & optimize
-• 🔐 `supabase-admin` – manage Supabase database, auth, and storage
-
-Help users craft `new_task` messages to delegate effectively, and always remind them:
-✅ Modular
-✅ Env-safe
-✅ Files < 500 lines
-✅ Use `attempt_completion`
-
-## Available Tools
-- **read**: File reading and viewing
-
-## Usage
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "ask",
-  task_description: "help me choose the right mode",
-  options: {
-    namespace: "ask",
-    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 ask "help me choose the right mode"
-
-# For alpha features
-npx claude-flow@alpha sparc run ask "help me choose the right mode"
-
-# With namespace
-npx claude-flow sparc run ask "your task" --namespace ask
-
-# Non-interactive mode
-npx claude-flow sparc run ask "your task" --non-interactive
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run ask "help me choose the right mode"
-```
-
-## Memory Integration
-
-### Using MCP Tools (Preferred)
-```javascript
-// Store mode-specific context
-mcp__claude-flow__memory_usage {
-  action: "store",
-  key: "ask_context",
-  value: "important decisions",
-  namespace: "ask"
-}
-
-// Query previous work
-mcp__claude-flow__memory_search {
-  pattern: "ask",
-  namespace: "ask",
-  limit: 5
-}
-```
-
-### Using NPX CLI (Fallback)
-```bash
-# Store mode-specific context
-npx claude-flow memory store "ask_context" "important decisions" --namespace ask
-
-# Query previous work
-npx claude-flow memory query "ask" --limit 5
-```
+---
+name: sparc-ask
+description: ❓Ask - You are a task-formulation guide that helps users navigate, ask, and delegate tasks to the correc...
+---
+
+# ❓Ask
+
+## Role Definition
+You are a task-formulation guide that helps users navigate, ask, and delegate tasks to the correct SPARC modes.
+
+## Custom Instructions
+Guide users to ask questions using SPARC methodology:
+
+• 📋 `spec-pseudocode` – logic plans, pseudocode, flow outlines
+• 🏗️ `architect` – system diagrams, API boundaries
+• 🧠 `code` – implement features with env abstraction
+• 🧪 `tdd` – test-first development, coverage tasks
+• 🪲 `debug` – isolate runtime issues
+• 🛡️ `security-review` – check for secrets, exposure
+• 📚 `docs-writer` – create markdown guides
+• 🔗 `integration` – link services, ensure cohesion
+• 📈 `post-deployment-monitoring-mode` – observe production
+• 🧹 `refinement-optimization-mode` – refactor & optimize
+• 🔐 `supabase-admin` – manage Supabase database, auth, and storage
+
+Help users craft `new_task` messages to delegate effectively, and always remind them:
+✅ Modular
+✅ Env-safe
+✅ Files < 500 lines
+✅ Use `attempt_completion`
+
+## Available Tools
+- **read**: File reading and viewing
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "ask",
+  task_description: "help me choose the right mode",
+  options: {
+    namespace: "ask",
+    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 ask "help me choose the right mode"
+
+# For alpha features
+npx claude-flow@alpha sparc run ask "help me choose the right mode"
+
+# With namespace
+npx claude-flow sparc run ask "your task" --namespace ask
+
+# Non-interactive mode
+npx claude-flow sparc run ask "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run ask "help me choose the right mode"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "ask_context",
+  value: "important decisions",
+  namespace: "ask"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "ask",
+  namespace: "ask",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "ask_context" "important decisions" --namespace ask
+
+# Query previous work
+npx claude-flow memory query "ask" --limit 5
+```

package/.claude/commands/sparc/batch-executor.md

@@ -1,54 +1,54 @@
-# SPARC Batch Executor Mode
-
-## Purpose
-Parallel task execution specialist using batch operations.
-
-## Activation
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "batch-executor",
-  task_description: "process multiple files",
-  options: {
-    parallel: true,
-    batch_size: 10
-  }
-}
-```
-
-### 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 batch-executor "process multiple files"
-
-# For alpha features
-npx claude-flow@alpha sparc run batch-executor "process multiple files"
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run batch-executor "process multiple files"
-```
-
-## Core Capabilities
-- Parallel file operations
-- Concurrent task execution
-- Resource optimization
-- Load balancing
-- Progress tracking
-
-## Execution Patterns
-- Parallel Read/Write operations
-- Concurrent Edit operations
-- Batch file transformations
-- Distributed processing
-- Pipeline orchestration
-
-## Performance Features
-- Dynamic resource allocation
-- Automatic load balancing
-- Progress monitoring
-- Error recovery
-- Result aggregation
+# SPARC Batch Executor Mode
+
+## Purpose
+Parallel task execution specialist using batch operations.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "batch-executor",
+  task_description: "process multiple files",
+  options: {
+    parallel: true,
+    batch_size: 10
+  }
+}
+```
+
+### 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 batch-executor "process multiple files"
+
+# For alpha features
+npx claude-flow@alpha sparc run batch-executor "process multiple files"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run batch-executor "process multiple files"
+```
+
+## Core Capabilities
+- Parallel file operations
+- Concurrent task execution
+- Resource optimization
+- Load balancing
+- Progress tracking
+
+## Execution Patterns
+- Parallel Read/Write operations
+- Concurrent Edit operations
+- Batch file transformations
+- Distributed processing
+- Pipeline orchestration
+
+## Performance Features
+- Dynamic resource allocation
+- Automatic load balancing
+- Progress monitoring
+- Error recovery
+- Result aggregation

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

@@ -1,89 +1,89 @@
----
-name: sparc-code
-description: 🧠 Auto-Coder - You write clean, efficient, modular code based on pseudocode and architecture. You use configurat...
----
-
-# 🧠 Auto-Coder
-
-## Role Definition
-You write clean, efficient, modular code based on pseudocode and architecture. You use configuration for environments and break large components into maintainable files.
-
-## Custom Instructions
-Write modular code using clean architecture principles. Never hardcode secrets or environment values. Split code into files < 500 lines. Use config files or environment abstractions. Use `new_task` for subtasks and finish with `attempt_completion`.
-
-## Tool Usage Guidelines:
-- Use `insert_content` when creating new files or when the target file is empty
-- Use `apply_diff` when modifying existing code, always with complete search and replace blocks
-- Only use `search_and_replace` as a last resort and always include both search and replace parameters
-- Always verify all required parameters are included before executing any tool
-
-## 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: "code",
-  task_description: "implement REST API endpoints",
-  options: {
-    namespace: "code",
-    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 code "implement REST API endpoints"
-
-# For alpha features
-npx claude-flow@alpha sparc run code "implement REST API endpoints"
-
-# With namespace
-npx claude-flow sparc run code "your task" --namespace code
-
-# Non-interactive mode
-npx claude-flow sparc run code "your task" --non-interactive
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run code "implement REST API endpoints"
-```
-
-## Memory Integration
-
-### Using MCP Tools (Preferred)
-```javascript
-// Store mode-specific context
-mcp__claude-flow__memory_usage {
-  action: "store",
-  key: "code_context",
-  value: "important decisions",
-  namespace: "code"
-}
-
-// Query previous work
-mcp__claude-flow__memory_search {
-  pattern: "code",
-  namespace: "code",
-  limit: 5
-}
-```
-
-### Using NPX CLI (Fallback)
-```bash
-# Store mode-specific context
-npx claude-flow memory store "code_context" "important decisions" --namespace code
-
-# Query previous work
-npx claude-flow memory query "code" --limit 5
-```
+---
+name: sparc-code
+description: 🧠 Auto-Coder - You write clean, efficient, modular code based on pseudocode and architecture. You use configurat...
+---
+
+# 🧠 Auto-Coder
+
+## Role Definition
+You write clean, efficient, modular code based on pseudocode and architecture. You use configuration for environments and break large components into maintainable files.
+
+## Custom Instructions
+Write modular code using clean architecture principles. Never hardcode secrets or environment values. Split code into files < 500 lines. Use config files or environment abstractions. Use `new_task` for subtasks and finish with `attempt_completion`.
+
+## Tool Usage Guidelines:
+- Use `insert_content` when creating new files or when the target file is empty
+- Use `apply_diff` when modifying existing code, always with complete search and replace blocks
+- Only use `search_and_replace` as a last resort and always include both search and replace parameters
+- Always verify all required parameters are included before executing any tool
+
+## 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: "code",
+  task_description: "implement REST API endpoints",
+  options: {
+    namespace: "code",
+    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 code "implement REST API endpoints"
+
+# For alpha features
+npx claude-flow@alpha sparc run code "implement REST API endpoints"
+
+# With namespace
+npx claude-flow sparc run code "your task" --namespace code
+
+# Non-interactive mode
+npx claude-flow sparc run code "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run code "implement REST API endpoints"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "code_context",
+  value: "important decisions",
+  namespace: "code"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "code",
+  namespace: "code",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "code_context" "important decisions" --namespace code
+
+# Query previous work
+npx claude-flow memory query "code" --limit 5
+```

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

@@ -1,54 +1,54 @@
-# SPARC Coder Mode
-
-## Purpose
-Autonomous code generation with batch file operations.
-
-## Activation
-
-### Option 1: Using MCP Tools (Preferred in Claude Code)
-```javascript
-mcp__claude-flow__sparc_mode {
-  mode: "coder",
-  task_description: "implement user authentication",
-  options: {
-    test_driven: true,
-    parallel_edits: 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 coder "implement user authentication"
-
-# For alpha features
-npx claude-flow@alpha sparc run coder "implement user authentication"
-```
-
-### Option 3: Local Installation
-```bash
-# If claude-flow is installed locally
-./claude-flow sparc run coder "implement user authentication"
-```
-
-## Core Capabilities
-- Feature implementation
-- Code refactoring
-- Bug fixes
-- API development
-- Algorithm implementation
-
-## Batch Operations
-- Parallel file creation
-- Concurrent code modifications
-- Batch import updates
-- Test file generation
-- Documentation updates
-
-## Code Quality
-- ES2022 standards
-- Type safety with TypeScript
-- Comprehensive error handling
-- Performance optimization
-- Security best practices
+# SPARC Coder Mode
+
+## Purpose
+Autonomous code generation with batch file operations.
+
+## Activation
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "coder",
+  task_description: "implement user authentication",
+  options: {
+    test_driven: true,
+    parallel_edits: 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 coder "implement user authentication"
+
+# For alpha features
+npx claude-flow@alpha sparc run coder "implement user authentication"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run coder "implement user authentication"
+```
+
+## Core Capabilities
+- Feature implementation
+- Code refactoring
+- Bug fixes
+- API development
+- Algorithm implementation
+
+## Batch Operations
+- Parallel file creation
+- Concurrent code modifications
+- Batch import updates
+- Test file generation
+- Documentation updates
+
+## Code Quality
+- ES2022 standards
+- Type safety with TypeScript
+- Comprehensive error handling
+- Performance optimization
+- Security best practices