# release-manager

release-manager runs a multi-package release: version bumps, tests, deploy and rollback, then keeps what worked in memory for the next one.

- 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/agentic-flow/.claude/agents/github/release-manager.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/ruvnet-release-manager

## What it does

The agent carries a release from version bumps to the deploy itself. It raises version numbers across packages, runs the test suite, ships, and rolls back when something breaks afterwards. Release notes come out of the same pass. Before shipping it polls several agents and folds their verdicts into one answer with a confidence figure.

Memory sits in the hooks. The `pre` block queries AgentDB for earlier releases that scored well, using `npx agentdb-cli pattern search`, and pulls their stats. The `post` block writes the run back as a pattern with a reward, and on a successful run above 0.9 it retrains a coordination pattern through `npx claude-flow neural train`. Tools cover shell, file edits, `Task`, `WebFetch`, GitHub MCP calls for branches, pull requests and issues, plus claude-flow swarm tools and agentic-flow pattern storage.

Connect the `github` and `claude-flow` MCP servers before you rely on it: without them most of the tool list never resolves and only Bash and Edit remain. The hooks also shell out through `npx`, so Node has to be on the machine.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/release-manager.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-manager.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-manager.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/agentic-flow/.claude/agents/github/release-manager.md

## When to use it
- bump versions across several packages in one pass
- run the tests and produce release notes
- roll back a deploy that broke after shipping
- turn QA and security verdicts into one go/no-go call
- reuse a past release's pattern instead of repeating its mistakes

## Example prompts
- Cut release 2.0: bump versions in every package, run the tests and open a PR against `main`.
- Collect the QA and security verdicts for this release and tell me whether we ship.
- Deploy the release and roll back to the previous tag if the healthcheck fails.

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

## Other versions with the same name
- [release-manager · qdhenry](https://affpapa.org/en/nevibecode/agents/release-manager.md) — ★ 1357 repo stars

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
