release-manager

name: release-managerdescription: >  Automates release management with changelog generation, semantic versioning,  and release readiness checks. Use when preparing releases, generating  changelogs, bumping versions, or validating release candidates.license: MIT + Commons Clausemetadata:   version: 1.1.0  author: borghei  category: engineering  domain: devops  tier: POWERFUL  updated: 2026-06-17  tags:     - release-management    - semver    - changelog    - release-readiness    - versioning

Release Manager

The agent automates release management by parsing conventional commits into structured changelogs, determining semantic version bumps, and assessing release readiness with checklists, rollback runbooks, and stakeholder communication plans.

Core Capabilities

• Changelog generation — parse conventional commits since the last tag into Keep-a-Changelog Markdown/JSON, grouped by type with breaking-change highlights and issue links.
• Semantic version bumping — determine MAJOR/MINOR/PATCH from commit types, support pre-release tracks (alpha → beta → rc), emit bump commands for npm, Python, Rust, Git, Docker.
• Release readiness — score a release plan across features, quality gates, approvals, and timelines; surface blocking issues.
• Rollback & comms — generate rollback runbooks with triggers and time estimates, plus stakeholder communication plans with timed message templates.
• Workflows — changelog+bump, readiness assessment, and expedited hotfix releases, each with validation checkpoints.

When to Use

• Preparing a release — generate the changelog and determine the next version.
• Validating a release candidate — assess readiness and surface blockers.
• Shipping a hotfix — expedited fix, pre-release versioning, tested rollback.
• Auditing commit hygiene — confirm conventional commits drive clean changelogs.

Clarify First

Before preparing the release, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

• Last release tag / commit range: defines the changelog window and the basis for the version-bump decision.
• Release type: standard / hotfix / pre-release (alpha→beta→rc) (selects the workflow and versioning track).
• Target ecosystem: npm / Python / Rust / Git / Docker (determines which bump commands are emitted).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

Tools

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

• references/workflows-and-tool-reference.md — quick start, the 3 core workflows with checkpoints, version-bump rules, rollback triggers, anti-patterns, troubleshooting table, success criteria, and the full CLI flag reference for all three scripts. Read when running a release or looking up a flag.
• references/conventional-commits-guide.md — conventional-commit format, types, and footer conventions. Read when fixing commit hygiene so changelog/version tooling works.
• references/hotfix-procedures.md — severity classification (P0–P3), hotfix procedures, and best practices across workflows. Read when shipping an emergency fix.
• references/release-workflow-comparison.md — Git Flow vs GitHub Flow vs Trunk-based, with structure, branch types, and trade-offs. Read when choosing or aligning a branching model.

Scope & Limitations

This skill covers:

• Parsing conventional commits and generating structured changelogs in Markdown and JSON formats
• Determining semantic version bumps (major/minor/patch) with pre-release support (alpha, beta, rc)
• Assessing release readiness across features, quality gates, approvals, and timelines
• Generating rollback runbooks, communication plans, and release checklists from structured input

This skill does NOT cover:

• Actual CI/CD pipeline execution or deployment automation (see engineering/ci-cd-pipeline-generator)
• Live monitoring, alerting, or incident response during deployments (see engineering/monitoring-alerting-setup)
• Code review processes or pull request management (see engineering/code-review-automation)
• Infrastructure provisioning, container orchestration, or environment management (see engineering/infrastructure-as-code)

Integration Points