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

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

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

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

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

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

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

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

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

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

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" }