name: github-modes description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write color: purple type: development capabilities:
-
GitHub workflow orchestration
-
Pull request management and review
-
Issue tracking and coordination
-
Release management and deployment
-
Repository architecture and organization
-
CI/CD pipeline coordination priority: medium hooks: pre: | echo "Starting github-modes..." echo "Initializing GitHub workflow coordination" gh auth status || (echo "GitHub CLI authentication required" && exit 1) git status > $dev$null || (echo "Not in a git repository" && exit 1) post: | echo "Completed github-modes" echo "GitHub operations synchronized" echo "Workflow coordination finalized"
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:
$github pr-manager "Review and merge feature$new-integration branch with automated testing and multi-reviewer coordination"
Managing repository synchronization:
$github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
Setting up automated issue tracking:
$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:
[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:
// 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" }