GitHub Release Manager Skill

Overview

Automated release coordination with swarm orchestration. This skill handles release pipelines, multi-package version coordination, deployment orchestration with rollback capabilities, release documentation generation, and multi-stage validation.

Quick Start

# List releases
gh release list

# Create a release
gh release create v1.0.0 --title "Release v1.0.0" --notes "Release notes..."

# View release
gh release view v1.0.0

# Download release assets
gh release download v1.0.0

# Delete release
gh release delete v1.0.0 --yes

When to Use

Creating and managing software releases
Coordinating versions across multiple packages
Automating deployment with validation
Generating release documentation
Multi-stage release validation
Rollback and recovery procedures

Core Capabilities

Capability	Description
Automated pipelines	Comprehensive testing and validation
Version coordination	Multi-package version sync
Deployment orchestration	Staged deployment with rollback
Release documentation	Changelog and notes generation
Multi-stage validation	Swarm-coordinated testing

Usage Examples

1. Coordinated Release Preparation

// Initialize release management swarm

// Orchestrate release preparation
    task: "Prepare release v1.0.72 with comprehensive testing and validation",
    strategy: "sequential",
    priority: "critical"
})

2. Create Release with gh CLI

# Create release branch
git checkout -b release/v1.0.72 main

# Get commits since last release
LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
COMMITS=$(gh api repos/owner/repo/compare/${LAST_TAG}...HEAD --jq '.commits[].commit.message')

# Generate changelog
echo "$COMMITS" > CHANGELOG_DRAFT.md

# Create draft release
gh release create v1.0.72 \
  --draft \
  --title "Release v1.0.72" \
  --notes-file CHANGELOG_DRAFT.md \
  --target release/v1.0.72

# Upload assets
gh release upload v1.0.72 dist/*.tar.gz dist/*.zip

# Publish release
gh release edit v1.0.72 --draft=false

3. Multi-Package Version Coordination

# Update package versions
cd ../ruv-swarm && npm version 1.0.12 --no-git-tag-version

# Run tests for all packages
npm test --workspaces

# Create coordinated release PR
gh pr create \
  --title "Release v1.0.72: GitHub Integration and Swarm Enhancements" \
  --head release/v1.0.72 \
  --base main \
  --body "## Release v1.0.72

### Package Updates
- **ruv-swarm**: v1.0.11 -> v1.0.12

### Changes
- GitHub workflow integration
- Enhanced swarm coordination
- Advanced MCP tools integration

### Validation
- [x] Unit tests passing
- [x] Integration tests: 89% success
- [x] Build verification successful"

4. Automated Release Validation

# Run comprehensive validation
npm install && npm test && npm run lint && npm run build

# Security audit
npm audit

# Create validation report
gh issue create \
  --title "Release Validation: v1.0.72" \
  --body "## Validation Results
- Unit tests: PASS
- Integration tests: 89% success
- Lint: PASS
- Build: PASS
- Security: No vulnerabilities" \
  --label "release,validation"

5. Batch Release Workflow

[Single Message - Complete Release Management]:
    // Initialize comprehensive release swarm

    // Create release branch
    Bash("git checkout -b release/v1.0.72 main")

    // Run comprehensive validation
    Bash("npm install && npm test && npm run lint && npm run build")

    // Create release PR
    Bash(`gh pr create \
      --title "Release v1.0.72" \
      --head "release/v1.0.72" \
      --base "main" \
      --body "[release description]"`)

    // Track release progress
    TodoWrite({ todos: [
      { id: "rel-prep", content: "Prepare release branch", status: "completed" },
      { id: "rel-test", content: "Run comprehensive tests", status: "completed" },
      { id: "rel-pr", content: "Create release PR", status: "completed" },
      { id: "rel-review", content: "Code review and approval", status: "pending" },
      { id: "rel-merge", content: "Merge and deploy", status: "pending" }
    ]})

    // Store release state
        action: "store",
        key: "release/v1.0.72/status",
        value: JSON.stringify({
            version: "1.0.72",
            stage: "validation_complete",
            validation_passed: true
        })
    })

Release Strategies

Semantic Versioning

const versionStrategy = {
    major: "Breaking changes or architecture overhauls",
    minor: "New features, GitHub integration, swarm enhancements",
    patch: "Bug fixes, documentation updates, dependency updates",
    coordination: "Cross-package version alignment"
}

Multi-Stage Validation

const validationStages = [
    "unit_tests",           // Individual package testing
    "integration_tests",    // Cross-package integration
    "performance_tests",    // Performance regression detection
    "compatibility_tests",  // Version compatibility validation
    "documentation_tests",  // Documentation accuracy verification
    "deployment_tests"      // Deployment simulation
]

Rollback Strategy

const rollbackPlan = {
    triggers: ["test_failures", "deployment_issues", "critical_bugs"],
    automatic: ["failed_tests", "build_failures"],
    manual: ["user_reported_issues", "performance_degradation"],
    recovery: "Previous stable version restoration"
}

MCP Tool Integration

Swarm Coordination

    topology: "hierarchical",
    maxAgents: 6,
    strategy: "sequential"  // Release stages run in order
})

Memory for Release State

// Store release state
    action: "store",
    key: "release/v1.0.72/state",
    namespace: "releases",
    value: JSON.stringify({
        version: "1.0.72",
        stage: "testing",
        timestamp: Date.now()
    })
})

GitHub Actions Integration

name: Release Management
on:
  pull_request:
    branches: [main]
    paths: ['**/package.json', 'CHANGELOG.md']

jobs:
  release-validation:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'
      - name: Install and Test
        run: |
          npm install
          npm test
          npm run lint
          npm run build
      - name: Validate Release

Best Practices

1. Comprehensive Testing

Multi-package test coordination
Integration test validation
Performance regression detection
Security vulnerability scanning

2. Documentation Management

Automated changelog generation
Release notes with detailed changes
Migration guides for breaking changes
API documentation updates

3. Deployment Coordination

Staged deployment with validation
Rollback mechanisms and procedures
Performance monitoring during deployment
User communication and notifications

4. Version Management

Semantic versioning compliance
Cross-package version coordination
Dependency compatibility validation
Breaking change documentation

Monitoring and Metrics

Release Quality Metrics

Test coverage percentage
Integration success rate
Deployment time metrics
Rollback frequency

Automated Monitoring

Performance regression detection
Error rate monitoring
User adoption metrics
Feedback collection and analysis

Version History

1.0.0 (2025-01-02): Initial release - converted from release-manager agent

github-release-manager