claude-flow 3.28.0 → 3.29.0

package/.claude/commands/github/code-review.md

@@ -1,25 +1,25 @@
-# code-review
-
-Automated code review with swarm intelligence.
-
-## Usage
-```bash
-npx claude-flow github code-review [options]
-```
-
-## Options
-- `--pr-number <n>` - Pull request to review
-- `--focus <areas>` - Review focus (security, performance, style)
-- `--suggest-fixes` - Suggest code fixes
-
-## Examples
-```bash
-# Review PR
-npx claude-flow github code-review --pr-number 456
-
-# Security focus
-npx claude-flow github code-review --pr-number 456 --focus security
-
-# With fix suggestions
-npx claude-flow github code-review --pr-number 456 --suggest-fixes
-```
+# code-review
+
+Automated code review with swarm intelligence.
+
+## Usage
+```bash
+npx claude-flow github code-review [options]
+```
+
+## Options
+- `--pr-number <n>` - Pull request to review
+- `--focus <areas>` - Review focus (security, performance, style)
+- `--suggest-fixes` - Suggest code fixes
+
+## Examples
+```bash
+# Review PR
+npx claude-flow github code-review --pr-number 456
+
+# Security focus
+npx claude-flow github code-review --pr-number 456 --focus security
+
+# With fix suggestions
+npx claude-flow github code-review --pr-number 456 --suggest-fixes
+```

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__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
-mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
-mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
-mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
-
-// Execute GitHub workflow with coordination
-mcp__claude-flow__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__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
+mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
+mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
+mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
+
+// Execute GitHub workflow with coordination
+mcp__claude-flow__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__claude-flow__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__claude-flow__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