moflo 4.8.21 → 4.8.23

package/.claude/commands/sparc.md

@@ -1,166 +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__moflo__sparc_mode {
-  mode: "sparc",
-  task_description: "build complete authentication system"
-}
-
-// Run a specific mode
-mcp__moflo__sparc_mode {
-  mode: "architect",
-  task_description: "design API structure"
-}
-
-// TDD workflow
-mcp__moflo__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__moflo__memory_usage {
-  action: "store",
-  key: "spec_auth",
-  value: "OAuth2 + JWT requirements",
-  namespace: "spec"
-}
-
-// Store architectural decisions
-mcp__moflo__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.
+---
+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__moflo__sparc_mode {
+  mode: "sparc",
+  task_description: "build complete authentication system"
+}
+
+// Run a specific mode
+mcp__moflo__sparc_mode {
+  mode: "architect",
+  task_description: "design API structure"
+}
+
+// TDD workflow
+mcp__moflo__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__moflo__memory_usage {
+  action: "store",
+  key: "spec_auth",
+  value: "OAuth2 + JWT requirements",
+  namespace: "spec"
+}
+
+// Store architectural decisions
+mcp__moflo__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/swarm/analysis.md

@@ -1,95 +1,95 @@
-# Analysis Swarm Strategy
-
-## Purpose
-Comprehensive analysis through distributed agent coordination.
-
-## Activation
-
-### Using MCP Tools
-```javascript
-// Initialize analysis swarm
-mcp__moflo__swarm_init({
-  "topology": "mesh",
-  "maxAgents": 6,
-  "strategy": "adaptive"
-})
-
-// Orchestrate analysis task
-mcp__moflo__task_orchestrate({
-  "task": "analyze system performance",
-  "strategy": "parallel",
-  "priority": "medium"
-})
-```
-
-### Using CLI (Fallback)
-`npx claude-flow swarm "analyze system performance" --strategy analysis`
-
-## Agent Roles
-
-### Agent Spawning with MCP
-```javascript
-// Spawn analysis agents
-mcp__moflo__agent_spawn({
-  "type": "analyst",
-  "name": "Data Collector",
-  "capabilities": ["metrics", "logging", "monitoring"]
-})
-
-mcp__moflo__agent_spawn({
-  "type": "analyst",
-  "name": "Pattern Analyzer",
-  "capabilities": ["pattern-recognition", "anomaly-detection"]
-})
-
-mcp__moflo__agent_spawn({
-  "type": "documenter",
-  "name": "Report Generator",
-  "capabilities": ["reporting", "visualization"]
-})
-
-mcp__moflo__agent_spawn({
-  "type": "coordinator",
-  "name": "Insight Synthesizer",
-  "capabilities": ["synthesis", "correlation"]
-})
-```
-
-## Coordination Modes
-- Mesh: For exploratory analysis
-- Pipeline: For sequential processing
-- Hierarchical: For complex systems
-
-## Analysis Operations
-```javascript
-// Run performance analysis
-mcp__moflo__performance_report({
-  "format": "detailed",
-  "timeframe": "24h"
-})
-
-// Identify bottlenecks
-mcp__moflo__bottleneck_analyze({
-  "component": "api",
-  "metrics": ["response-time", "throughput"]
-})
-
-// Pattern recognition
-mcp__moflo__pattern_recognize({
-  "data": performanceData,
-  "patterns": ["anomaly", "trend", "cycle"]
-})
-```
-
-## Status Monitoring
-```javascript
-// Monitor analysis progress
-mcp__moflo__task_status({
-  "taskId": "analysis-task-001"
-})
-
-// Get analysis results
-mcp__moflo__task_results({
-  "taskId": "analysis-task-001"
-})
-```
+# Analysis Swarm Strategy
+
+## Purpose
+Comprehensive analysis through distributed agent coordination.
+
+## Activation
+
+### Using MCP Tools
+```javascript
+// Initialize analysis swarm
+mcp__moflo__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 6,
+  "strategy": "adaptive"
+})
+
+// Orchestrate analysis task
+mcp__moflo__task_orchestrate({
+  "task": "analyze system performance",
+  "strategy": "parallel",
+  "priority": "medium"
+})
+```
+
+### Using CLI (Fallback)
+`npx claude-flow swarm "analyze system performance" --strategy analysis`
+
+## Agent Roles
+
+### Agent Spawning with MCP
+```javascript
+// Spawn analysis agents
+mcp__moflo__agent_spawn({
+  "type": "analyst",
+  "name": "Data Collector",
+  "capabilities": ["metrics", "logging", "monitoring"]
+})
+
+mcp__moflo__agent_spawn({
+  "type": "analyst",
+  "name": "Pattern Analyzer",
+  "capabilities": ["pattern-recognition", "anomaly-detection"]
+})
+
+mcp__moflo__agent_spawn({
+  "type": "documenter",
+  "name": "Report Generator",
+  "capabilities": ["reporting", "visualization"]
+})
+
+mcp__moflo__agent_spawn({
+  "type": "coordinator",
+  "name": "Insight Synthesizer",
+  "capabilities": ["synthesis", "correlation"]
+})
+```
+
+## Coordination Modes
+- Mesh: For exploratory analysis
+- Pipeline: For sequential processing
+- Hierarchical: For complex systems
+
+## Analysis Operations
+```javascript
+// Run performance analysis
+mcp__moflo__performance_report({
+  "format": "detailed",
+  "timeframe": "24h"
+})
+
+// Identify bottlenecks
+mcp__moflo__bottleneck_analyze({
+  "component": "api",
+  "metrics": ["response-time", "throughput"]
+})
+
+// Pattern recognition
+mcp__moflo__pattern_recognize({
+  "data": performanceData,
+  "patterns": ["anomaly", "trend", "cycle"]
+})
+```
+
+## Status Monitoring
+```javascript
+// Monitor analysis progress
+mcp__moflo__task_status({
+  "taskId": "analysis-task-001"
+})
+
+// Get analysis results
+mcp__moflo__task_results({
+  "taskId": "analysis-task-001"
+})
+```