moflo 4.8.27 → 4.8.30

package/.claude/commands/automation/smart-agents.md

@@ -0,0 +1,73 @@
+# Smart Agent Auto-Spawning
+
+## Purpose
+Automatically spawn the right agents at the right time without manual intervention.
+
+## Auto-Spawning Triggers
+
+### 1. File Type Detection
+When editing files, agents auto-spawn:
+- **JavaScript/TypeScript**: Coder agent
+- **Markdown**: Researcher agent
+- **JSON/YAML**: Analyst agent
+- **Multiple files**: Coordinator agent
+
+### 2. Task Complexity
+```
+Simple task: "Fix typo"
+→ Single coordinator agent
+
+Complex task: "Implement OAuth with Google"
+→ Architect + Coder + Tester + Researcher
+```
+
+### 3. Dynamic Scaling
+The system monitors workload and spawns additional agents when:
+- Task queue grows
+- Complexity increases
+- Parallel opportunities exist
+
+**Status Monitoring:**
+```javascript
+// Check swarm health
+mcp__moflo__swarm_status({
+  "swarmId": "current"
+})
+
+// Monitor agent performance
+mcp__moflo__agent_metrics({
+  "agentId": "agent-123"
+})
+```
+
+## Configuration
+
+### MCP Tool Integration
+Uses Claude Flow MCP tools for agent coordination:
+```javascript
+// Initialize swarm with appropriate topology
+mcp__moflo__swarm_init({
+  "topology": "mesh",
+  "maxAgents": 8,
+  "strategy": "auto"
+})
+
+// Spawn agents based on file type
+mcp__moflo__agent_spawn({
+  "type": "coder",
+  "name": "JavaScript Handler",
+  "capabilities": ["javascript", "typescript"]
+})
+```
+
+### Fallback Configuration
+If MCP tools are unavailable:
+```bash
+npx claude-flow hook pre-task --auto-spawn-agents
+```
+
+## Benefits
+- 🤖 Zero manual agent management
+- 🎯 Perfect agent selection
+- 📈 Dynamic scaling
+- 💾 Resource efficiency

package/.claude/commands/automation/smart-spawn.md

@@ -0,0 +1,25 @@
+# smart-spawn
+
+Intelligently spawn agents based on workload analysis.
+
+## Usage
+```bash
+npx claude-flow automation smart-spawn [options]
+```
+
+## Options
+- `--analyze` - Analyze before spawning
+- `--threshold <n>` - Spawn threshold
+- `--topology <type>` - Preferred topology
+
+## Examples
+```bash
+# Smart spawn with analysis
+npx claude-flow automation smart-spawn --analyze
+
+# Set spawn threshold
+npx claude-flow automation smart-spawn --threshold 5
+
+# Force topology
+npx claude-flow automation smart-spawn --topology hierarchical
+```

package/.claude/commands/automation/workflow-select.md

@@ -0,0 +1,25 @@
+# workflow-select
+
+Automatically select optimal workflow based on task type.
+
+## Usage
+```bash
+npx claude-flow automation workflow-select [options]
+```
+
+## Options
+- `--task <description>` - Task description
+- `--constraints <list>` - Workflow constraints
+- `--preview` - Preview without executing
+
+## Examples
+```bash
+# Select workflow for task
+npx claude-flow automation workflow-select --task "Deploy to production"
+
+# With constraints
+npx claude-flow automation workflow-select --constraints "no-downtime,rollback"
+
+# Preview mode
+npx claude-flow automation workflow-select --task "Database migration" --preview
+```

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

@@ -1,147 +1,147 @@
-# GitHub Integration Modes
-
-## Overview
-This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
-
-## GitHub Workflow Modes
-
-### gh-coordinator
-**GitHub workflow orchestration and coordination**
-- **Coordination Mode**: Hierarchical
-- **Max Parallel Operations**: 10
-- **Batch Optimized**: Yes
-- **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
-- **Usage**: `/github gh-coordinator <GitHub workflow description>`
-- **Best For**: Complex GitHub workflows, multi-repo coordination
-
-### pr-manager
-**Pull request management and review coordination**
-- **Review Mode**: Automated
-- **Multi-reviewer**: Yes
-- **Conflict Resolution**: Intelligent
-- **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
-- **Usage**: `/github pr-manager <PR management task>`
-- **Best For**: PR reviews, merge coordination, conflict resolution
-
-### issue-tracker
-**Issue management and project coordination**
-- **Issue Workflow**: Automated
-- **Label Management**: Smart
-- **Progress Tracking**: Real-time
-- **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
-- **Usage**: `/github issue-tracker <issue management task>`
-- **Best For**: Project management, issue coordination, progress tracking
-
-### release-manager
-**Release coordination and deployment**
-- **Release Pipeline**: Automated
-- **Versioning**: Semantic
-- **Deployment**: Multi-stage
-- **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
-- **Usage**: `/github release-manager <release task>`
-- **Best For**: Release management, version coordination, deployment pipelines
-
-## Repository Management Modes
-
-### repo-architect
-**Repository structure and organization**
-- **Structure Optimization**: Yes
-- **Multi-repo**: Support
-- **Template Management**: Advanced
-- **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash
-- **Usage**: `/github repo-architect <repository management task>`
-- **Best For**: Repository setup, structure optimization, multi-repo management
-
-### code-reviewer
-**Automated code review and quality assurance**
-- **Review Quality**: Deep
-- **Security Analysis**: Yes
-- **Performance Check**: Automated
-- **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write
-- **Usage**: `/github code-reviewer <review task>`
-- **Best For**: Code quality, security reviews, performance analysis
-
-### branch-manager
-**Branch management and workflow coordination**
-- **Branch Strategy**: GitFlow
-- **Merge Strategy**: Intelligent
-- **Conflict Prevention**: Proactive
-- **Tools**: gh api (for branch operations), git commands, Bash
-- **Usage**: `/github branch-manager <branch management task>`
-- **Best For**: Branch coordination, merge strategies, workflow management
-
-## Integration Commands
-
-### sync-coordinator
-**Multi-package synchronization**
-- **Package Sync**: Intelligent
-- **Version Alignment**: Automatic
-- **Dependency Resolution**: Advanced
-- **Tools**: git commands, gh pr create, Read, Write, Bash
-- **Usage**: `/github sync-coordinator <sync task>`
-- **Best For**: Package synchronization, version management, dependency updates
-
-### ci-orchestrator
-**CI/CD pipeline coordination**
-- **Pipeline Management**: Advanced
-- **Test Coordination**: Parallel
-- **Deployment**: Automated
-- **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
-- **Usage**: `/github ci-orchestrator <CI/CD task>`
-- **Best For**: CI/CD coordination, test management, deployment automation
-
-### security-guardian
-**Security and compliance management**
-- **Security Scan**: Automated
-- **Compliance Check**: Continuous
-- **Vulnerability Management**: Proactive
-- **Tools**: gh search code, gh issue create, gh secret list, Read, Write
-- **Usage**: `/github security-guardian <security task>`
-- **Best For**: Security audits, compliance checks, vulnerability management
-
-## Usage Examples
-
-### Creating a coordinated pull request workflow:
-```bash
-/github pr-manager "Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination"
-```
-
-### Managing repository synchronization:
-```bash
-/github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
-```
-
-### Setting up automated issue tracking:
-```bash
-/github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
-```
-
-## Batch Operations
-
-All GitHub modes support batch operations for maximum efficiency:
-
-### Parallel GitHub Operations Example:
-```javascript
-[Single Message with BatchTool]:
-  Bash("gh issue create --title 'Feature A' --body '...'")
-  Bash("gh issue create --title 'Feature B' --body '...'")
-  Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
-  Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
-  TodoWrite { todos: [todo1, todo2, todo3] }
-  Bash("git checkout main && git pull")
-```
-
-## Integration with ruv-swarm
-
-All GitHub modes can be enhanced with ruv-swarm coordination:
-
-```javascript
-// Initialize swarm for GitHub workflow
-mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 5 }
-mcp__moflo__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
-mcp__moflo__agent_spawn { type: "reviewer", name: "Code Reviewer" }
-mcp__moflo__agent_spawn { type: "tester", name: "QA Agent" }
-
-// Execute GitHub workflow with coordination
-mcp__moflo__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
+# GitHub Integration Modes
+
+## Overview
+This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
+
+## GitHub Workflow Modes
+
+### gh-coordinator
+**GitHub workflow orchestration and coordination**
+- **Coordination Mode**: Hierarchical
+- **Max Parallel Operations**: 10
+- **Batch Optimized**: Yes
+- **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
+- **Usage**: `/github gh-coordinator <GitHub workflow description>`
+- **Best For**: Complex GitHub workflows, multi-repo coordination
+
+### pr-manager
+**Pull request management and review coordination**
+- **Review Mode**: Automated
+- **Multi-reviewer**: Yes
+- **Conflict Resolution**: Intelligent
+- **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
+- **Usage**: `/github pr-manager <PR management task>`
+- **Best For**: PR reviews, merge coordination, conflict resolution
+
+### issue-tracker
+**Issue management and project coordination**
+- **Issue Workflow**: Automated
+- **Label Management**: Smart
+- **Progress Tracking**: Real-time
+- **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
+- **Usage**: `/github issue-tracker <issue management task>`
+- **Best For**: Project management, issue coordination, progress tracking
+
+### release-manager
+**Release coordination and deployment**
+- **Release Pipeline**: Automated
+- **Versioning**: Semantic
+- **Deployment**: Multi-stage
+- **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
+- **Usage**: `/github release-manager <release task>`
+- **Best For**: Release management, version coordination, deployment pipelines
+
+## Repository Management Modes
+
+### repo-architect
+**Repository structure and organization**
+- **Structure Optimization**: Yes
+- **Multi-repo**: Support
+- **Template Management**: Advanced
+- **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash
+- **Usage**: `/github repo-architect <repository management task>`
+- **Best For**: Repository setup, structure optimization, multi-repo management
+
+### code-reviewer
+**Automated code review and quality assurance**
+- **Review Quality**: Deep
+- **Security Analysis**: Yes
+- **Performance Check**: Automated
+- **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write
+- **Usage**: `/github code-reviewer <review task>`
+- **Best For**: Code quality, security reviews, performance analysis
+
+### branch-manager
+**Branch management and workflow coordination**
+- **Branch Strategy**: GitFlow
+- **Merge Strategy**: Intelligent
+- **Conflict Prevention**: Proactive
+- **Tools**: gh api (for branch operations), git commands, Bash
+- **Usage**: `/github branch-manager <branch management task>`
+- **Best For**: Branch coordination, merge strategies, workflow management
+
+## Integration Commands
+
+### sync-coordinator
+**Multi-package synchronization**
+- **Package Sync**: Intelligent
+- **Version Alignment**: Automatic
+- **Dependency Resolution**: Advanced
+- **Tools**: git commands, gh pr create, Read, Write, Bash
+- **Usage**: `/github sync-coordinator <sync task>`
+- **Best For**: Package synchronization, version management, dependency updates
+
+### ci-orchestrator
+**CI/CD pipeline coordination**
+- **Pipeline Management**: Advanced
+- **Test Coordination**: Parallel
+- **Deployment**: Automated
+- **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
+- **Usage**: `/github ci-orchestrator <CI/CD task>`
+- **Best For**: CI/CD coordination, test management, deployment automation
+
+### security-guardian
+**Security and compliance management**
+- **Security Scan**: Automated
+- **Compliance Check**: Continuous
+- **Vulnerability Management**: Proactive
+- **Tools**: gh search code, gh issue create, gh secret list, Read, Write
+- **Usage**: `/github security-guardian <security task>`
+- **Best For**: Security audits, compliance checks, vulnerability management
+
+## Usage Examples
+
+### Creating a coordinated pull request workflow:
+```bash
+/github pr-manager "Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination"
+```
+
+### Managing repository synchronization:
+```bash
+/github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
+```
+
+### Setting up automated issue tracking:
+```bash
+/github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
+```
+
+## Batch Operations
+
+All GitHub modes support batch operations for maximum efficiency:
+
+### Parallel GitHub Operations Example:
+```javascript
+[Single Message with BatchTool]:
+  Bash("gh issue create --title 'Feature A' --body '...'")
+  Bash("gh issue create --title 'Feature B' --body '...'")
+  Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
+  Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
+  TodoWrite { todos: [todo1, todo2, todo3] }
+  Bash("git checkout main && git pull")
+```
+
+## Integration with ruv-swarm
+
+All GitHub modes can be enhanced with ruv-swarm coordination:
+
+```javascript
+// Initialize swarm for GitHub workflow
+mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 5 }
+mcp__moflo__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
+mcp__moflo__agent_spawn { type: "reviewer", name: "Code Reviewer" }
+mcp__moflo__agent_spawn { type: "tester", name: "QA Agent" }
+
+// Execute GitHub workflow with coordination
+mcp__moflo__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
 ```

package/.claude/commands/github/github-swarm.md

@@ -1,121 +1,121 @@
-# github swarm
-
-Create a specialized swarm for GitHub repository management.
-
-## Usage
-
-```bash
-npx claude-flow github swarm [options]
-```
-
-## Options
-
-- `--repository, -r <owner/repo>` - Target GitHub repository
-- `--agents, -a <number>` - Number of specialized agents (default: 5)
-- `--focus, -f <type>` - Focus area: maintenance, development, review, triage
-- `--auto-pr` - Enable automatic pull request enhancements
-- `--issue-labels` - Auto-categorize and label issues
-- `--code-review` - Enable AI-powered code reviews
-
-## Examples
-
-### Basic GitHub swarm
-
-```bash
-npx claude-flow github swarm --repository owner/repo
-```
-
-### Maintenance-focused swarm
-
-```bash
-npx claude-flow github swarm -r owner/repo -f maintenance --issue-labels
-```
-
-### Development swarm with PR automation
-
-```bash
-npx claude-flow github swarm -r owner/repo -f development --auto-pr --code-review
-```
-
-### Full-featured triage swarm
-
-```bash
-npx claude-flow github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr
-```
-
-## Agent Types
-
-### Issue Triager
-
-- Analyzes and categorizes issues
-- Suggests labels and priorities
-- Identifies duplicates and related issues
-
-### PR Reviewer
-
-- Reviews code changes
-- Suggests improvements
-- Checks for best practices
-
-### Documentation Agent
-
-- Updates README files
-- Creates API documentation
-- Maintains changelog
-
-### Test Agent
-
-- Identifies missing tests
-- Suggests test cases
-- Validates test coverage
-
-### Security Agent
-
-- Scans for vulnerabilities
-- Reviews dependencies
-- Suggests security improvements
-
-## Workflows
-
-### Issue Triage Workflow
-
-1. Scan all open issues
-2. Categorize by type and priority
-3. Apply appropriate labels
-4. Suggest assignees
-5. Link related issues
-
-### PR Enhancement Workflow
-
-1. Analyze PR changes
-2. Suggest missing tests
-3. Improve documentation
-4. Format code consistently
-5. Add helpful comments
-
-### Repository Health Check
-
-1. Analyze code quality metrics
-2. Review dependency status
-3. Check test coverage
-4. Assess documentation completeness
-5. Generate health report
-
-## Integration with Claude Code
-
-Use in Claude Code with MCP tools:
-
-```javascript
-mcp__moflo__github_swarm {
-  repository: "owner/repo",
-  agents: 6,
-  focus: "maintenance"
-}
-```
-
-## See Also
-
-- `repo analyze` - Deep repository analysis
-- `pr enhance` - Enhance pull requests
-- `issue triage` - Intelligent issue management
-- `code review` - Automated reviews
+# github swarm
+
+Create a specialized swarm for GitHub repository management.
+
+## Usage
+
+```bash
+npx claude-flow github swarm [options]
+```
+
+## Options
+
+- `--repository, -r <owner/repo>` - Target GitHub repository
+- `--agents, -a <number>` - Number of specialized agents (default: 5)
+- `--focus, -f <type>` - Focus area: maintenance, development, review, triage
+- `--auto-pr` - Enable automatic pull request enhancements
+- `--issue-labels` - Auto-categorize and label issues
+- `--code-review` - Enable AI-powered code reviews
+
+## Examples
+
+### Basic GitHub swarm
+
+```bash
+npx claude-flow github swarm --repository owner/repo
+```
+
+### Maintenance-focused swarm
+
+```bash
+npx claude-flow github swarm -r owner/repo -f maintenance --issue-labels
+```
+
+### Development swarm with PR automation
+
+```bash
+npx claude-flow github swarm -r owner/repo -f development --auto-pr --code-review
+```
+
+### Full-featured triage swarm
+
+```bash
+npx claude-flow github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr
+```
+
+## Agent Types
+
+### Issue Triager
+
+- Analyzes and categorizes issues
+- Suggests labels and priorities
+- Identifies duplicates and related issues
+
+### PR Reviewer
+
+- Reviews code changes
+- Suggests improvements
+- Checks for best practices
+
+### Documentation Agent
+
+- Updates README files
+- Creates API documentation
+- Maintains changelog
+
+### Test Agent
+
+- Identifies missing tests
+- Suggests test cases
+- Validates test coverage
+
+### Security Agent
+
+- Scans for vulnerabilities
+- Reviews dependencies
+- Suggests security improvements
+
+## Workflows
+
+### Issue Triage Workflow
+
+1. Scan all open issues
+2. Categorize by type and priority
+3. Apply appropriate labels
+4. Suggest assignees
+5. Link related issues
+
+### PR Enhancement Workflow
+
+1. Analyze PR changes
+2. Suggest missing tests
+3. Improve documentation
+4. Format code consistently
+5. Add helpful comments
+
+### Repository Health Check
+
+1. Analyze code quality metrics
+2. Review dependency status
+3. Check test coverage
+4. Assess documentation completeness
+5. Generate health report
+
+## Integration with Claude Code
+
+Use in Claude Code with MCP tools:
+
+```javascript
+mcp__moflo__github_swarm {
+  repository: "owner/repo",
+  agents: 6,
+  focus: "maintenance"
+}
+```
+
+## See Also
+
+- `repo analyze` - Deep repository analysis
+- `pr enhance` - Enhance pull requests
+- `issue triage` - Intelligent issue management
+- `code review` - Automated reviews