agent-release-swarm

Orchestrates software releases with AI swarms handling changelogs, versioning, builds, and multi-platform deployment.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill agent-release-swarm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-release-swarm
Source: https://github.com/ruvnet/claude-flow/tree/main/.agents/skills/agent-release-swarm
Command: npx skills add https://github.com/ruvnet/claude-flow --skill agent-release-swarm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating a software release involves many error-prone manual steps: analyzing commits, generating changelogs, bumping versions, building artifacts for multiple platforms, running tests, deploying to registries, and monitoring for regressions. This Skill automates that entire pipeline using coordinated AI swarm agents.

Core Features & Use Cases

  • Automated Changelog & Versioning: Analyzes commits and merged PRs via the GitHub CLI to generate categorized changelogs, detect breaking changes, and suggest semantic version bumps.
  • Multi-Agent Release Orchestration: Spawns specialized agents (changelog, version, build, test, deploy) that run builds across platforms, execute test suites, and publish to npm, Docker, and GitHub Releases.
  • Progressive Deployment & Rollback: Supports staged canary rollouts with metric thresholds, release monitoring, and automated rollback triggers based on error rates and latency.
  • Use Case: A maintainer tagging v2.0.0 can trigger the swarm to generate release notes from merged PRs, build binaries for Linux/macOS/Windows, publish packages, and post an announcement issue automatically.

Quick Start

Ask the agent to plan and execute a new release for the current repository, including changelog generation, version bumping, and deployment to npm and GitHub Releases.

Frequently Asked Questions about agent-release-swarm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate a GitHub release with AI agents?

Initialize the release swarm with npx ruv-swarm github release-init, which spawns changelog, version, build, test, and deploy agents. The swarm analyzes merged PRs and commits via the GitHub CLI, generates release notes, builds artifacts, and publishes to configured targets.

How to generate a changelog from merged pull requests?

Use gh pr list to collect merged PRs since the last release tag, then pass them to npx ruv-swarm github changelog with the --categorize flag. It groups entries by labels such as feature, bug, and docs, and adds contributor attribution.

Does the release swarm support semantic versioning?

Yes, the version agent analyzes commit messages for breaking-change keywords like BREAKING or exclamation marks and suggests major, minor, or patch bumps. It also handles pre-release versions and validates version constraints before tagging.

Can I deploy to npm and Docker in the same release?

Yes, the deploy agent accepts multiple targets such as npm, docker, github, and s3 in a single command. The release configuration file defines per-target build and publish commands, including multi-architecture Docker images.

How does automated rollback work after a failed release?

Configure rollback triggers with thresholds for error rate, p99 latency, and availability using npx ruv-swarm github rollback-config. When metrics breach thresholds during the monitoring window, the swarm rolls back to the previous version and notifies stakeholders.

What are the limitations of swarm-based release automation?

It depends on the GitHub CLI and ruv-swarm tooling being installed and authenticated, and on well-labeled PRs for accurate changelog categorization. Emergency hotfixes can bypass checks, but only security-only bypass mode is recommended.