release-swarm — Claude Code subagent for software releases
release-swarm coordinates release work from change analysis and changelog preparation to builds, tests, and deployment across configured targets.
no license ★ 850 updated 2026-10-26
.claude/agents/release-swarm.mdWhat release-swarm 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.
What it helps with
- 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 for the agent
- 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.
How to install release-swarm
Manually: put the files in place
.claude/agents/release-swarm.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/release-swarm.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/release-swarm.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about release-swarm
How do I install release-swarm in Claude Code?
Add the subagent file at .claude/agents/release-swarm.md.
What does release-swarm do?
It coordinates release work, including change analysis, version suggestions, changelog preparation, builds, tests, and deployment.
Can I require approval before production deployment?
Yes. In .github/release-swarm.yml, configure production to require approval; rollback can also be enabled.