Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/release-swarm.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for DevOps and infrastructure →

From the same set76

The whole set →
specification SPARC specification subagent for requirements analysis. Gathers acceptance criteria, outlines project scope, and learns from previous patterns via claude-flow. CX Codex ★ 850repo stars pr-manager pr-manager coordinates pull request reviews, tests, and merge work through GitHub tools and a swarm of agents. It can also reuse patterns saved from earlier PR tasks. CX Codex ★ 850repo stars reviewer A reviewer persona for Claude that reads a change like a senior engineer: behaviour, security holes, slow paths, standards, docs. You get a summary with critical issues. CX Codex ★ 850repo stars refinement SPARC refinement phase agent for iterative code polish. Drives test-driven development: creates failing tests, satisfies them, and cleans up structure. CX Codex ★ 850repo stars sona-learning-optimizer sona-learning-optimizer — a subagent that logs every task as a trajectory and nudges quality up by reusing similar past patterns and LoRA fine-tuning. CX Codex ★ 850repo stars tester tester is a Claude Code subagent that creates tests and checks code, recording past failures in claude-flow. CX Codex ★ 850repo stars code-goal-planner The code-goal-planner subagent turns software goals into milestones with dependencies and success criteria. Use it to plan a feature, bug fix, or refactor. CX Codex ★ 850repo stars swarm-issue swarm-issue turns a GitHub issue into work for a swarm: splits it into subtasks, assigns agents and reports progress back inside the issue. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open