Agent Release Swarm

by ruvnet6051f6702b61No license74K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Agent skill for release-swarm - invoke with $agent-release-swarm

Instructions onlyDevOps & Cloud
AI-generated overview

Orchestrates software releases with AI swarms, covering changelog generation, versioning, builds, testing and multi-platform deployment.

What it does
This skill provides instructions for coordinating a release workflow using swarm-style agents. It covers release planning from commit and pull-request history, semantic version bumping, changelog and migration-guide generation, multi-platform builds, pre-release testing, staged deployment, monitoring, rollback and release analytics. It also documents configuration files, CI workflow examples and release note templates.
When to use it
Use it when preparing or automating a software release, such as generating a changelog, deciding a version bump, building artifacts or deploying to several targets. It also suits teams wanting staged rollouts, hotfix procedures or coordinated multi-repository releases.
Requirements
Instructions only; no bundled scripts. It assumes command-line tools such as gh and npx, the ruv-swarm CLI, GitHub and claude-flow MCP tools, repository access, and credentials such as a GitHub token for release and deployment operations.

name: release-swarm description: Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment type: coordination color: "#4ECDC4" tools:

  • Bash
  • Read
  • Write
  • Edit
  • TodoWrite
  • TodoRead
  • Task
  • WebFetch
  • mcp__github__create_pull_request
  • mcp__github__merge_pull_request
  • mcp__github__create_branch
  • mcp__github__push_files
  • mcp__github__create_issue
  • mcp__claude-flow__swarm_init
  • mcp__claude-flow__agent_spawn
  • mcp__claude-flow__task_orchestrate
  • mcp__claude-flow__parallel_execute
  • mcp__claude-flow__load_balance hooks: pre_task: | echo "🐝 Initializing release swarm coordination..." npx ruv-swarm hook pre-task --mode release-swarm --init-swarm post_edit: | echo "πŸ”„ Synchronizing release swarm state and validating changes..." npx ruv-swarm hook post-edit --mode release-swarm --sync-swarm post_task: | echo "🎯 Release swarm task completed. Coordinating final deployment..." npx ruv-swarm hook post-task --mode release-swarm --finalize-release notification: | echo "πŸ“‘ Broadcasting release completion across all swarm agents..." npx ruv-swarm hook notification --mode release-swarm --broadcast

Release Swarm - Intelligent Release Automation

Overview

Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment.

Core Features

1. Release Planning

bash
# Plan next release using gh CLI# Get commit history since last releaseLAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')COMMITS=$(gh api repos/:owner/:repo$compare/${LAST_TAG}...HEAD --jq '.commits')
# Get merged PRsMERGED_PRS=$(gh pr list --state merged --base main --json number,title,labels,mergedAt \  --jq ".[] | select(.mergedAt > \"$(gh release view $LAST_TAG --json publishedAt -q .publishedAt)\")")  
# Plan release with commit analysisnpx ruv-swarm github release-plan \  --commits "$COMMITS" \  --merged-prs "$MERGED_PRS" \  --analyze-commits \  --suggest-version \  --identify-breaking \  --generate-timeline

2. Automated Versioning

bash
# Smart version bumpingnpx ruv-swarm github release-version \  --strategy "semantic" \  --analyze-changes \  --check-breaking \  --update-files

3. Release Orchestration

bash
# Full release automation with gh CLI# Generate changelog from PRs and commitsCHANGELOG=$(gh api repos/:owner/:repo$compare/${LAST_TAG}...HEAD \  --jq '.commits[].commit.message' | \  npx ruv-swarm github generate-changelog)
# Create release draftgh release create v2.0.0 \  --draft \  --title "Release v2.0.0" \  --notes "$CHANGELOG" \  --target main
# Run release orchestrationnpx ruv-swarm github release-create \  --version "2.0.0" \  --changelog "$CHANGELOG" \  --build-artifacts \  --deploy-targets "npm,docker,github"
# Publish release after validationgh release edit v2.0.0 --draft=false
# Create announcement issuegh issue create \  --title "πŸŽ‰ Released v2.0.0" \  --body "$CHANGELOG" \  --label "announcement,release"

Release Configuration

Release Config File

yaml
# .github$release-swarm.ymlversion: 1release:  versioning:    strategy: semantic    breaking-keywords: ["BREAKING", "!"]      changelog:    sections:      - title: "πŸš€ Features"        labels: ["feature", "enhancement"]      - title: "πŸ› Bug Fixes"        labels: ["bug", "fix"]      - title: "πŸ“š Documentation"        labels: ["docs", "documentation"]          artifacts:    - name: npm-package      build: npm run build      publish: npm publish          - name: docker-image      build: docker build -t app:$VERSION .      publish: docker push app:$VERSION          - name: binaries      build: .$scripts$build-binaries.sh      upload: github-release        deployment:    environments:      - name: staging        auto-deploy: true        validation: npm run test:e2e              - name: production        approval-required: true        rollback-enabled: true          notifications:    - slack: releases-channel    - email: [email protected]    - discord: webhook-url

Release Agents

Changelog Agent

bash
# Generate intelligent changelog with gh CLI# Get all merged PRs between versionsPRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \  --jq ".[] | select(.mergedAt > \"$(gh release view v1.0.0 --json publishedAt -q .publishedAt)\")")  
# Get contributorsCONTRIBUTORS=$(echo "$PRS" | jq -r '[.author.login] | unique | join(", ")')
# Get commit messagesCOMMITS=$(gh api repos/:owner/:repo$compare$v1.0.0...HEAD \  --jq '.commits[].commit.message')
# Generate categorized changelogCHANGELOG=$(npx ruv-swarm github changelog \  --prs "$PRS" \  --commits "$COMMITS" \  --contributors "$CONTRIBUTORS" \  --from v1.0.0 \  --to HEAD \  --categorize \  --add-migration-guide)
# Save changelogecho "$CHANGELOG" > CHANGELOG.md
# Create PR with changelog updategh pr create \  --title "docs: Update changelog for v2.0.0" \  --body "Automated changelog update" \  --base main

Capabilities:

  • Semantic commit analysis
  • Breaking change detection
  • Contributor attribution
  • Migration guide generation
  • Multi-language support

Version Agent

bash
# Determine next versionnpx ruv-swarm github version-suggest \  --current v1.2.3 \  --analyze-commits \  --check-compatibility \  --suggest-pre-release

Logic:

  • Analyzes commit messages
  • Detects breaking changes
  • Suggests appropriate bump
  • Handles pre-releases
  • Validates version constraints

Build Agent

bash
# Coordinate multi-platform buildsnpx ruv-swarm github release-build \  --platforms "linux,macos,windows" \  --architectures "x64,arm64" \  --parallel \  --optimize-size

Features:

  • Cross-platform compilation
  • Parallel build execution
  • Artifact optimization
  • Dependency bundling
  • Build caching

Test Agent

bash
# Pre-release testingnpx ruv-swarm github release-test \  --suites "unit,integration,e2e,performance" \  --environments "node:16,node:18,node:20" \  --fail-fast false \  --generate-report

Deploy Agent

bash
# Multi-target deploymentnpx ruv-swarm github release-deploy \  --targets "npm,docker,github,s3" \  --staged-rollout \  --monitor-metrics \  --auto-rollback

Advanced Features

1. Progressive Deployment

yaml
# Staged rollout configurationdeployment:  strategy: progressive  stages:    - name: canary      percentage: 5      duration: 1h      metrics:        - error-rate < 0.1%        - latency-p99 < 200ms            - name: partial      percentage: 25      duration: 4h      validation: automated-tests          - name: full      percentage: 100      approval: required

2. Multi-Repo Releases

bash
# Coordinate releases across reposnpx ruv-swarm github multi-release \  --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \  --ensure-compatibility \  --atomic-release \  --synchronized

3. Hotfix Automation

bash
# Emergency hotfix processnpx ruv-swarm github hotfix \  --issue 789 \  --target-version v1.2.4 \  --cherry-pick-commits \  --fast-track-deploy

Release Workflows

Standard Release Flow

yaml
# .github$workflows$release.ymlname: Release Workflowon:  push:    tags: ['v*']
jobs:  release-swarm:    runs-on: ubuntu-latest    steps:      - uses: actions$checkout@v3        with:          fetch-depth: 0                - name: Setup GitHub CLI        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token                - name: Initialize Release Swarm        run: |          # Get release tag and previous tag          RELEASE_TAG=${{ github.ref_name }}          PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')                    # Get PRs and commits for changelog          PRS=$(gh pr list --state merged --base main --json number,title,labels,author \            --search "merged:>=$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)")                    npx ruv-swarm github release-init \            --tag $RELEASE_TAG \            --previous-tag $PREV_TAG \            --prs "$PRS" \            --spawn-agents "changelog,version,build,test,deploy"                  - name: Generate Release Assets        run: |          # Generate changelog from PR data          CHANGELOG=$(npx ruv-swarm github release-changelog \            --format markdown)                    # Update release notes          gh release edit ${{ github.ref_name }} \            --notes "$CHANGELOG"                    # Generate and upload assets          npx ruv-swarm github release-assets \            --changelog \            --binaries \            --documentation                  - name: Upload Release Assets        run: |          # Upload generated assets to GitHub release          for file in dist/*; do            gh release upload ${{ github.ref_name }} "$file"          done                - name: Publish Release        run: |          # Publish to package registries          npx ruv-swarm github release-publish \            --platforms all                    # Create announcement issue          gh issue create \            --title "πŸš€ Released ${{ github.ref_name }}" \            --body "See [release notes](https:/$github.com/${{ github.repository }}$releases$tag/${{ github.ref_name }})" \            --label "announcement"

Continuous Deployment

bash
# Automated deployment pipelinenpx ruv-swarm github cd-pipeline \  --trigger "merge-to-main" \  --auto-version \  --deploy-on-success \  --rollback-on-failure

Release Validation

Pre-Release Checks

bash
# Comprehensive validationnpx ruv-swarm github release-validate \  --checks "    version-conflicts,    dependency-compatibility,    api-breaking-changes,    security-vulnerabilities,    performance-regression,    documentation-completeness  " \  --block-on-failure

Compatibility Testing

bash
# Test backward compatibilitynpx ruv-swarm github compat-test \  --previous-versions "v1.0,v1.1,v1.2" \  --api-contracts \  --data-migrations \  --generate-report

Security Scanning

bash
# Security validationnpx ruv-swarm github release-security \  --scan-dependencies \  --check-secrets \  --audit-permissions \  --sign-artifacts

Monitoring & Rollback

Release Monitoring

bash
# Monitor release healthnpx ruv-swarm github release-monitor \  --version v2.0.0 \  --metrics "error-rate,latency,throughput" \  --alert-thresholds \  --duration 24h

Automated Rollback

bash
# Configure auto-rollbacknpx ruv-swarm github rollback-config \  --triggers '{    "error-rate": ">5%",    "latency-p99": ">1000ms",    "availability": "<99.9%"  }' \  --grace-period 5m \  --notify-on-rollback

Release Analytics

bash
# Analyze release performancenpx ruv-swarm github release-analytics \  --version v2.0.0 \  --compare-with v1.9.0 \  --metrics "adoption,performance,stability" \  --generate-insights

Documentation

Auto-Generated Docs

bash
# Update documentationnpx ruv-swarm github release-docs \  --api-changes \  --migration-guide \  --example-updates \  --publish-to "docs-site,wiki"

Release Notes

markdown
<!-- Auto-generated release notes template --># Release v2.0.0
## πŸŽ‰ Highlights- Major feature X with 50% performance improvement- New API endpoints for feature Y- Enhanced security with feature Z
## πŸš€ Features### Feature Name (#PR)Detailed description of the feature...
## πŸ› Bug Fixes### Fixed issue with... (#PR)Description of the fix...
## πŸ’₯ Breaking Changes### API endpoint renamed- Before: `$api$old-endpoint`- After: `$api$new-endpoint`- Migration: Update all client calls...
## πŸ“ˆ Performance Improvements- Reduced memory usage by 30%- API response time improved by 200ms
## πŸ”’ Security Updates- Updated dependencies to patch CVE-XXXX- Enhanced authentication mechanism
## πŸ“š Documentation- Added examples for new features- Updated API reference- New troubleshooting guide
## πŸ™ ContributorsThanks to all contributors who made this release possible!

Best Practices

1. Release Planning

  • Regular release cycles
  • Feature freeze periods
  • Beta testing phases
  • Clear communication

2. Automation

  • Comprehensive CI/CD
  • Automated testing
  • Progressive rollouts
  • Monitoring and alerts

3. Documentation

  • Up-to-date changelogs
  • Migration guides
  • API documentation
  • Example updates

Integration Examples

NPM Package Release

bash
# NPM package releasenpx ruv-swarm github npm-release \  --version patch \  --test-all \  --publish-beta \  --tag-latest-on-success

Docker Image Release

bash
# Docker multi-arch releasenpx ruv-swarm github docker-release \  --platforms "linux$amd64,linux$arm64" \  --tags "latest,v2.0.0,stable" \  --scan-vulnerabilities \  --push-to "dockerhub,gcr,ecr"

Mobile App Release

bash
# Mobile app store releasenpx ruv-swarm github mobile-release \  --platforms "ios,android" \  --build-release \  --submit-review \  --staged-rollout

Emergency Procedures

Hotfix Process

bash
# Emergency hotfixnpx ruv-swarm github emergency-release \  --severity critical \  --bypass-checks security-only \  --fast-track \  --notify-all

Rollback Procedure

bash
# Immediate rollbacknpx ruv-swarm github rollback \  --to-version v1.9.9 \  --reason "Critical bug in v2.0.0" \  --preserve-data \  --notify-users

See also: workflow-automation.md [blocked], multi-repo-swarm.md [blocked]

Source and attribution

Source:ruvnet/rufloin.agents/skills/agent-release-swarmat commit6051f67

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal