claude-flow 2.0.0-alpha.69 → 2.0.0-alpha.70

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

@@ -1,18 +1,33 @@
-# SPARC TDD Mode
+---
+name: sparc-tdd
+description: 🧪 Tester (TDD) - You implement Test-Driven Development (TDD, London School), writing tests first and refactoring a...
+---
 
-## Purpose
-Test-driven development with TodoWrite planning and comprehensive testing.
+# 🧪 Tester (TDD)
 
-## Activation
+## Role Definition
+You implement Test-Driven Development (TDD, London School), writing tests first and refactoring after minimal implementation passes.
+
+## Custom Instructions
+Write failing tests first. Implement only enough code to pass. Refactor after green. Ensure tests do not hardcode secrets. Keep files < 500 lines. Validate modularity, test coverage, and clarity before using `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: "tdd",
-  task_description: "shopping cart feature",
+  task_description: "create user authentication tests",
   options: {
-    coverage_target: 90,
-    test_framework: "jest"
+    namespace: "tdd",
+    non_interactive: false
   }
 }
 ```
@@ -20,35 +35,49 @@ mcp__claude-flow__sparc_mode {
 ### 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 tdd "shopping cart feature"
+npx claude-flow sparc run tdd "create user authentication tests"
 
 # For alpha features
-npx claude-flow@alpha sparc run tdd "shopping cart feature"
+npx claude-flow@alpha sparc run tdd "create user authentication tests"
+
+# With namespace
+npx claude-flow sparc run tdd "your task" --namespace tdd
+
+# Non-interactive mode
+npx claude-flow sparc run tdd "your task" --non-interactive
 ```
 
 ### Option 3: Local Installation
 ```bash
 # If claude-flow is installed locally
-./claude-flow sparc run tdd "shopping cart feature"
+./claude-flow sparc run tdd "create user authentication tests"
 ```
 
-## Core Capabilities
-- Test-first development
-- Red-green-refactor cycle
-- Test suite design
-- Coverage optimization
-- Continuous testing
-
-## TDD Workflow
-1. Write failing tests
-2. Implement minimum code
-3. Make tests pass
-4. Refactor code
-5. Repeat cycle
-
-## Testing Strategies
-- Unit testing
-- Integration testing
-- End-to-end testing
-- Performance testing
-- Security testing
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "tdd_context",
+  value: "important decisions",
+  namespace: "tdd"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "tdd",
+  namespace: "tdd",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "tdd_context" "important decisions" --namespace tdd
+
+# Query previous work
+npx claude-flow memory query "tdd" --limit 5
+```

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

@@ -0,0 +1,79 @@
+---
+name: sparc-tutorial
+description: 📘 SPARC Tutorial - You are the SPARC onboarding and education assistant. Your job is to guide users through the full...
+---
+
+# 📘 SPARC Tutorial
+
+## Role Definition
+You are the SPARC onboarding and education assistant. Your job is to guide users through the full SPARC development process using structured thinking models. You help users understand how to navigate complex projects using the specialized SPARC modes and properly formulate tasks using new_task.
+
+## Custom Instructions
+You teach developers how to apply the SPARC methodology through actionable examples and mental models.
+
+## Available Tools
+- **read**: File reading and viewing
+
+## Usage
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+mcp__claude-flow__sparc_mode {
+  mode: "tutorial",
+  task_description: "guide me through SPARC methodology",
+  options: {
+    namespace: "tutorial",
+    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 tutorial "guide me through SPARC methodology"
+
+# For alpha features
+npx claude-flow@alpha sparc run tutorial "guide me through SPARC methodology"
+
+# With namespace
+npx claude-flow sparc run tutorial "your task" --namespace tutorial
+
+# Non-interactive mode
+npx claude-flow sparc run tutorial "your task" --non-interactive
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc run tutorial "guide me through SPARC methodology"
+```
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store mode-specific context
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "tutorial_context",
+  value: "important decisions",
+  namespace: "tutorial"
+}
+
+// Query previous work
+mcp__claude-flow__memory_search {
+  pattern: "tutorial",
+  namespace: "tutorial",
+  limit: 5
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store mode-specific context
+npx claude-flow memory store "tutorial_context" "important decisions" --namespace tutorial
+
+# Query previous work
+npx claude-flow memory query "tutorial" --limit 5
+```

package/.claude/commands/sparc.md

@@ -0,0 +1,166 @@
+---
+name: sparc
+description: Execute SPARC methodology workflows with Claude-Flow
+---
+
+# ⚡️ SPARC Development Methodology
+
+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.
+
+## SPARC Workflow
+
+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
+
+## Available SPARC Modes
+
+- `/sparc-architect` - 🏗️ Architect
+- `/sparc-code` - 🧠 Auto-Coder
+- `/sparc-tdd` - 🧪 Tester (TDD)
+- `/sparc-debug` - 🪲 Debugger
+- `/sparc-security-review` - 🛡️ Security Reviewer
+- `/sparc-docs-writer` - 📚 Documentation Writer
+- `/sparc-integration` - 🔗 System Integrator
+- `/sparc-post-deployment-monitoring-mode` - 📈 Deployment Monitor
+- `/sparc-refinement-optimization-mode` - 🧹 Optimizer
+- `/sparc-ask` - ❓Ask
+- `/sparc-devops` - 🚀 DevOps
+- `/sparc-tutorial` - 📘 SPARC Tutorial
+- `/sparc-supabase-admin` - 🔐 Supabase Admin
+- `/sparc-spec-pseudocode` - 📋 Specification Writer
+- `/sparc-mcp` - ♾️ MCP Integration
+- `/sparc-sparc` - ⚡️ SPARC Orchestrator
+
+## Quick Start
+
+### Option 1: Using MCP Tools (Preferred in Claude Code)
+```javascript
+// Run SPARC orchestrator (default)
+mcp__claude-flow__sparc_mode {
+  mode: "sparc",
+  task_description: "build complete authentication system"
+}
+
+// Run a specific mode
+mcp__claude-flow__sparc_mode {
+  mode: "architect",
+  task_description: "design API structure"
+}
+
+// TDD workflow
+mcp__claude-flow__sparc_mode {
+  mode: "tdd",
+  task_description: "implement user authentication",
+  options: {workflow: "full"}
+}
+```
+
+### Option 2: Using NPX CLI (Fallback when MCP not available)
+```bash
+# Run SPARC orchestrator (default)
+npx claude-flow sparc "build complete authentication system"
+
+# Run a specific mode
+npx claude-flow sparc run architect "design API structure"
+npx claude-flow sparc run tdd "implement user service"
+
+# Execute full TDD workflow
+npx claude-flow sparc tdd "implement user authentication"
+
+# List all modes with details
+npx claude-flow sparc modes --verbose
+
+# For alpha features
+npx claude-flow@alpha sparc run <mode> "your task"
+```
+
+### Option 3: Local Installation
+```bash
+# If claude-flow is installed locally
+./claude-flow sparc "build complete authentication system"
+./claude-flow sparc run architect "design API structure"
+```
+
+## SPARC Methodology Phases
+
+1. **📋 Specification**: Define requirements, constraints, and acceptance criteria
+2. **🧠 Pseudocode**: Create detailed logic flows and algorithmic planning
+3. **🏗️ Architecture**: Design system structure, APIs, and component boundaries
+4. **🔄 Refinement**: Implement with TDD (Red-Green-Refactor cycle)
+5. **✅ Completion**: Integrate, document, and validate against requirements
+
+## Memory Integration
+
+### Using MCP Tools (Preferred)
+```javascript
+// Store specifications
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "spec_auth",
+  value: "OAuth2 + JWT requirements",
+  namespace: "spec"
+}
+
+// Store architectural decisions
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "arch_decisions",
+  value: "Microservices with API Gateway",
+  namespace: "architecture"
+}
+```
+
+### Using NPX CLI (Fallback)
+```bash
+# Store specifications
+npx claude-flow memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec
+
+# Store architectural decisions
+./claude-flow memory store "arch_api" "RESTful microservices design" --namespace arch
+
+# Query previous work
+./claude-flow memory query "authentication" --limit 10
+
+# Export project memory
+./claude-flow memory export sparc-project-backup.json
+```
+
+## Advanced Swarm Mode
+
+For complex tasks requiring multiple agents with timeout-free execution:
+```bash
+# Development swarm with monitoring
+./claude-flow swarm "Build e-commerce platform" --strategy development --monitor --review
+
+# Background optimization swarm
+./claude-flow swarm "Optimize system performance" --strategy optimization --background
+
+# Distributed research swarm
+./claude-flow swarm "Analyze market trends" --strategy research --distributed --ui
+```
+
+## Non-Interactive Mode
+
+For CI/CD integration and automation:
+```bash
+./claude-flow sparc run code "implement API" --non-interactive
+./claude-flow sparc tdd "user tests" --non-interactive --enable-permissions
+```
+
+## Best Practices
+
+✅ **Modular Design**: Keep files under 500 lines
+✅ **Environment Safety**: Never hardcode secrets or env values
+✅ **Test-First**: Always write tests before implementation
+✅ **Memory Usage**: Store important decisions and context
+✅ **Task Completion**: All tasks should end with `attempt_completion`
+
+See `/claude-flow-help` for all available commands.

package/.claude/commands/training/README.md

@@ -0,0 +1,9 @@
+# Training Commands
+
+Commands for training operations in Claude Flow.
+
+## Available Commands
+
+- [neural-train](./neural-train.md)
+- [pattern-learn](./pattern-learn.md)
+- [model-update](./model-update.md)

package/.claude/commands/training/model-update.md

@@ -0,0 +1,25 @@
+# model-update
+
+Update neural models with new data.
+
+## Usage
+```bash
+npx claude-flow training model-update [options]
+```
+
+## Options
+- `--model <name>` - Model to update
+- `--incremental` - Incremental update
+- `--validate` - Validate after update
+
+## Examples
+```bash
+# Update all models
+npx claude-flow training model-update
+
+# Specific model
+npx claude-flow training model-update --model agent-selector
+
+# Incremental with validation
+npx claude-flow training model-update --incremental --validate
+```

package/.claude/commands/training/neural-train.md

@@ -0,0 +1,25 @@
+# neural-train
+
+Train neural patterns from operations.
+
+## Usage
+```bash
+npx claude-flow training neural-train [options]
+```
+
+## Options
+- `--data <source>` - Training data source
+- `--model <name>` - Target model
+- `--epochs <n>` - Training epochs
+
+## Examples
+```bash
+# Train from recent ops
+npx claude-flow training neural-train --data recent
+
+# Specific model
+npx claude-flow training neural-train --model task-predictor
+
+# Custom epochs
+npx claude-flow training neural-train --epochs 100
+```

package/.claude/commands/training/pattern-learn.md

@@ -0,0 +1,25 @@
+# pattern-learn
+
+Learn patterns from successful operations.
+
+## Usage
+```bash
+npx claude-flow training pattern-learn [options]
+```
+
+## Options
+- `--source <type>` - Pattern source
+- `--threshold <score>` - Success threshold
+- `--save <name>` - Save pattern set
+
+## Examples
+```bash
+# Learn from all ops
+npx claude-flow training pattern-learn
+
+# High success only
+npx claude-flow training pattern-learn --threshold 0.9
+
+# Save patterns
+npx claude-flow training pattern-learn --save optimal-patterns
+```

package/.claude/commands/workflows/README.md

@@ -0,0 +1,9 @@
+# Workflows Commands
+
+Commands for workflows operations in Claude Flow.
+
+## Available Commands
+
+- [workflow-create](./workflow-create.md)
+- [workflow-execute](./workflow-execute.md)
+- [workflow-export](./workflow-export.md)

package/.claude/commands/workflows/workflow-create.md

@@ -0,0 +1,25 @@
+# workflow-create
+
+Create reusable workflow templates.
+
+## Usage
+```bash
+npx claude-flow workflow create [options]
+```
+
+## Options
+- `--name <name>` - Workflow name
+- `--from-history` - Create from history
+- `--interactive` - Interactive creation
+
+## Examples
+```bash
+# Create workflow
+npx claude-flow workflow create --name "deploy-api"
+
+# From history
+npx claude-flow workflow create --name "test-suite" --from-history
+
+# Interactive mode
+npx claude-flow workflow create --interactive
+```

package/.claude/commands/workflows/workflow-execute.md

@@ -0,0 +1,25 @@
+# workflow-execute
+
+Execute saved workflows.
+
+## Usage
+```bash
+npx claude-flow workflow execute [options]
+```
+
+## Options
+- `--name <name>` - Workflow name
+- `--params <json>` - Workflow parameters
+- `--dry-run` - Preview execution
+
+## Examples
+```bash
+# Execute workflow
+npx claude-flow workflow execute --name "deploy-api"
+
+# With parameters
+npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'
+
+# Dry run
+npx claude-flow workflow execute --name "deploy-api" --dry-run
+```

package/.claude/commands/workflows/workflow-export.md

@@ -0,0 +1,25 @@
+# workflow-export
+
+Export workflows for sharing.
+
+## Usage
+```bash
+npx claude-flow workflow export [options]
+```
+
+## Options
+- `--name <name>` - Workflow to export
+- `--format <type>` - Export format
+- `--include-history` - Include execution history
+
+## Examples
+```bash
+# Export workflow
+npx claude-flow workflow export --name "deploy-api"
+
+# As YAML
+npx claude-flow workflow export --name "test-suite" --format yaml
+
+# With history
+npx claude-flow workflow export --name "deploy-api" --include-history
+```

package/.claude/helpers/github-setup.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Setup GitHub integration for Claude Flow
+
+echo "🔗 Setting up GitHub integration..."
+
+# Check for gh CLI
+if ! command -v gh &> /dev/null; then
+    echo "⚠️  GitHub CLI (gh) not found"
+    echo "Install from: https://cli.github.com/"
+    echo "Continuing without GitHub features..."
+else
+    echo "✅ GitHub CLI found"
+    
+    # Check auth status
+    if gh auth status &> /dev/null; then
+        echo "✅ GitHub authentication active"
+    else
+        echo "⚠️  Not authenticated with GitHub"
+        echo "Run: gh auth login"
+    fi
+fi
+
+echo ""
+echo "📦 GitHub swarm commands available:"
+echo "  - npx claude-flow github swarm"
+echo "  - npx claude-flow repo analyze"
+echo "  - npx claude-flow pr enhance"
+echo "  - npx claude-flow issue triage"

package/.claude/helpers/quick-start.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Quick start guide for Claude Flow
+
+echo "🚀 Claude Flow Quick Start"
+echo "=========================="
+echo ""
+echo "1. Initialize a swarm:"
+echo "   npx claude-flow swarm init --topology hierarchical"
+echo ""
+echo "2. Spawn agents:"
+echo "   npx claude-flow agent spawn --type coder --name "API Developer""
+echo ""
+echo "3. Orchestrate tasks:"
+echo "   npx claude-flow task orchestrate --task "Build REST API""
+echo ""
+echo "4. Monitor progress:"
+echo "   npx claude-flow swarm monitor"
+echo ""
+echo "📚 For more examples, see .claude/commands/"

package/.claude/helpers/setup-mcp.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Setup MCP server for Claude Flow
+
+echo "🚀 Setting up Claude Flow MCP server..."
+
+# Check if claude command exists
+if ! command -v claude &> /dev/null; then
+    echo "❌ Error: Claude Code CLI not found"
+    echo "Please install Claude Code first"
+    exit 1
+fi
+
+# Add MCP server
+echo "📦 Adding Claude Flow MCP server..."
+claude mcp add claude-flow npx claude-flow mcp start
+
+echo "✅ MCP server setup complete!"
+echo "🎯 You can now use mcp__claude-flow__ tools in Claude Code"