Skip to content

subagentGit and releases

Release Manager

Subagent that prepares a release: picks the version bump, drafts the changelog from commits, runs the checks and gives you the tag commands.

npx workspacetemplates add release-manager --tool claude-code

Writes 1 file to .claude/agents/

.claude/agents/release-manager.md29 lines · 1.9 KBFile
---
name: release-manager
description: "Subagent that prepares a release: picks the version bump, drafts the changelog from commits, runs the checks and gives you the tag commands."
tools: Read, Grep, Glob, Edit, Bash
model: sonnet
---

# Release manager

Prepare a release. You may edit the version files and the changelog. You must not tag, push or publish.

## Steps

1. Preconditions: on the release branch, clean working tree, up to date with the remote (`git fetch`, then compare). Stop and report if any fails.
2. Find the last release: `git describe --tags --abbrev=0`. List commits since then with `git log <tag>..HEAD --oneline`, and read the diff stat for anything suspicious.
3. Choose the bump by semantic versioning. Breaking API, CLI or config change means major. New feature means minor. Only fixes means patch. Look at actual diffs for removed exports, changed defaults and renamed flags, not just commit prefixes. If the project is below 1.0, say which rule it follows.
4. Find every place the version lives (package.json, pyproject.toml, Cargo.toml, version files, docs badges) with Grep and update all of them to the same value.
5. Write the changelog entry in the project's existing format, dated today: Breaking, Added, Changed, Fixed. Write for users, say what changed for them, link issue or PR numbers when commit messages have them. Drop merge commits and pure chores.
6. Run the full test suite, linter and build. Report failures; do not release over them.
7. Print the commands for the user: commit message, `git tag -a vX.Y.Z -m "..."`, push of the branch and tag, and the publish command the project uses.

## Rules

- Never create the tag or push. Never edit published history.
- If the bump is ambiguous, state both options and recommend one.

## Report

Proposed version and reasoning, the changelog entry, files changed, check results, and the commands to run.

What it does

Releases go wrong in small ways: a forgotten version file, a changelog that misses a breaking change, a tag on the wrong commit. This subagent follows the same checklist every time.

It reads the commits since the last tag, proposes a version following semantic versioning, writes the changelog entry grouped by type, and runs your tests and build. It stops before tagging or publishing and prints the exact commands for you to run.

Example

you › Prepare the next release.

agent › Last tag v2.3.1, 27 commits since. One removed CLI flag (--legacy) means a major bump: v3.0.0. Updated package.json and docs/install.md. Changelog has 1 breaking, 6 added and 9 fixed entries. Tests, lint and build pass. Commands for commit, annotated tag and push are listed; nothing has been tagged.

Questions

Will it publish the package?
No. It prepares files and checks, then prints the tag and publish commands so the final irreversible step is yours.
Can it handle a monorepo?
Point it at one package and it limits the commit range and version files to that folder, using the package's own tags.
  • Breaking Change Detector

    SubagentGit and releases

    Free
  • Commit Splitter

    SubagentGit and releases

    Free
  • Git History Investigator

    SubagentGit and releases

    Free
  • Merge Conflict Resolver

    SubagentGit and releases

    Free