# release-swarm

release-swarm coordinates release work from change analysis and changelog preparation to builds, tests, and deployment across configured targets.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/github/release-swarm.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/release-swarm

## What it does

release-swarm can review commits and merged pull requests, flag breaking changes, and suggest a version. It also prepares categorized changelogs and can include migration guidance. GitHub tools cover pull requests, branches, and issues.

The subagent coordinates builds, tests, and deployments against configured targets. Its `.github/release-swarm.yml` file can define artifacts, environments, and validation; production can require approval and support rollback. The hooks call `npx ruv-swarm`, so make sure that command is available in the project before running the agent.

Install it in Claude Code at `.claude/agents/release-swarm.md`. The documented GitHub workflows use `gh` to read repository data and publish releases. Since release actions can affect repositories and deployment targets, review the configuration and permissions before publishing.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/release-swarm.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/release-swarm.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/release-swarm.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/github/release-swarm.md

## When to use it
- plan a release from commits and merged pull requests
- suggest a version and identify breaking changes
- create a categorized changelog with migration guidance
- coordinate builds and pre-release tests
- deploy a release to configured targets and environments

## Example prompts
- Review the commits and merged pull requests, suggest the next release version, and flag breaking changes.
- Prepare a categorized changelog from the previous release and add migration guidance.
- Coordinate the build and validation steps before deploying to staging.

## Similar
- [github-release-management](https://affpapa.org/en/nevibecode/skills/github-release-management.md) — skill · 1200 installs
- [release-management](https://affpapa.org/en/nevibecode/skills/release-management.md) — skill · 220 installs
- [Open Source Release Checklist Builder (YAML)](https://affpapa.org/en/nevibecode/prompts/open-source-release-checklist-builder-yaml.md) — prompt · ★ 178201 repo stars
- [jackin-release-notes](https://affpapa.org/en/nevibecode/skills/jackin-release-notes.md) — skill · 469 installs
- [dev:release](https://affpapa.org/en/nevibecode/skills/devrelease.md) — skill · ★ 58 repo stars
- [github-release](https://affpapa.org/en/nevibecode/skills/github-release.md) — skill · 741 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
