release-management
Run the recurring release cycle that turns merged work into a shipped, communicated release: a stated release model, a version derived from the changes, a release candidate and freeze, a written go/no-go gate, staged rollout with an exercised rollback, a hotfix path, and the changelog and release no…
Install / Use
npx skills add rampstackco/claude-skills --skill release-managementInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of release-management
release-management scores 86/100 on our quality scale, 2403rd of 4,705 Development & Engineering skills we index.
Its SKILL.md is 18 KB long, well organised into 18 sections and no code examples: a thorough specification that gives an agent plenty to work with.
It has 902 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so release-management is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
release-management compared with similar skills
All 4 of these similar skills score higher than release-management; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| release-management (this skill)by rampstackco | 86 | 902 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 73.0k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.5k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install release-management?
- Run
npx skills add rampstackco/claude-skills --skill release-management. The install tabs above show the steps for each supported agent. - Which AI agents does release-management work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is release-management safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is release-management still maintained?
- The repository was last updated about 2 months ago, so release-management is actively maintained.
Skill content
View source on GitHubname: release-management description: "Run the recurring release cycle that turns merged work into a shipped, communicated release: a stated release model, a version derived from the changes, a release candidate and freeze, a written go/no-go gate, staged rollout with an exercised rollback, a hotfix path, and the changelog and release notes. Use this skill whenever the user wants to cut a release, plan or run a release train, decide what version a release should be, freeze code, hold a go/no-go, write a rollout or rollback plan, ship a hotfix, or write release notes, a changelog entry, or a deprecation notice. Triggers on release, cut a release, release notes, changelog, version bump, semver, calver, what version should this be, release train, code freeze, release candidate, RC, go/no-go, rollout plan, staged rollout, canary, rollback plan, hotfix, deprecation notice, release manager, release captain. Also triggers when the user has a set of merged changes and asks how to ship them or what to tell users, even if they never say release." category: operations catalog_summary: "The recurring release cycle: release model, versioning, freeze, go/no-go, staged rollout and rollback, hotfixes, changelog and notes" display_order: 1
Release Management
Run the cycle that turns merged work into a shipped, communicated release, every time, the same way. This is the recurring cycle, not the one-time go-live. Stack-agnostic and tool-agnostic: works with any CI system, any deploy method, and any tracker.
When to use
- Setting up how a team releases: the model, the cadence, the version scheme
- Cutting a release from a set of merged work items
- Deciding what version number a release gets
- Running a freeze and a release candidate
- Holding a go/no-go and recording the decision
- Planning staged exposure and the rollback path for a release
- Shipping a hotfix without breaking the main line
- Writing the changelog entry, the release notes, or a deprecation notice
When NOT to use
- The first launch or cutover of a site or product, DNS changes, or the step-by-step deploy-day procedure (use
launch-runbook) - Positioning, sales enablement, and customer comms around one feature (use
feature-launch-playbook) - Flag types, targeting, ramp schedules, and flag cleanup (use
feature-flagging). This skill uses flags as a rollout tool. It does not teach them. - A release that is on fire right now (use
incident-response, thenafter-action-report) - Writing the test plan for one ticket (use
test-case-authoring) - Sprint ceremonies and delivery metrics (use
sprint-operations) - Updating the packages you depend on (use
dependency-management)
Required inputs
- The release model in use, or a statement that none is written down
- What is in the candidate: the list of merged work items since the last release
- Open defects against the candidate, with severity
- Test evidence for the candidate: runner summaries, test plan results, manual sign-offs
- The rollback method and when it was last exercised
- The audiences for the notes: end users, admins, API consumers, internal teams
If no model is written down, say so and pick one first. If the merged list is not available from the tracker or the version control history, stop. A release record typed from memory is wrong by the second item.
The framework: 7 parts
Part 1: Release model
Pick one model and write it down. A team with no stated model is running the worst one by accident: scope-driven dates with a fixed-cadence promise and no freeze.
| Model | How it works | Fits when | Costs | Failure mode | |---|---|---|---|---| | Release train | Fixed cadence. Whatever is ready at the cut ships. Late work waits for the next train. | Many contributors, users who value predictability, app store or customer review cycles | Work that misses the cut waits a full cycle; needs flags for unfinished work | The train waits for one feature, and the cadence becomes a suggestion | | Continuous delivery | Every merge is releasable. Releasing is a decision, not an event. | Strong automated tests, fast rollback, a service you control end to end | Heavy investment in test automation and deploy safety | "Releasable" quietly means "deployed untested"; nobody can say what shipped when | | Milestone release | Scope sets the date. Ships when the named scope is done. | Hardware, regulated software, major versions with migration work | Dates slip with scope; long gaps between releases grow risk | Scope grows, the date moves, and the release becomes a big bang |
Write the model, the cadence, the cut time, and the release owner role in one paragraph the whole team can find. See references/release-checklist.md for how each model maps onto the per-release steps.
Part 2: Versioning
Semantic Versioning (the SemVer spec) for anything others depend on: libraries, APIs, SDKs, CLIs, file formats. MAJOR.MINOR.PATCH.
- Major: an incompatible change to the public interface. A removed field, a renamed endpoint, a changed default that breaks callers.
- Minor: new, backward-compatible functionality, including a new deprecation.
- Patch: backward-compatible fixes only.
- Pre-release identifiers mark candidates:
3.4.0-rc.1. They sort before3.4.0. - Build metadata records the build:
3.4.0+build.512. It does not affect ordering.
Calendar Versioning for products where the date is the signal: apps, sites, internal platforms on a train. 2026.11.1 says when, not how compatible.
The version is derived, never chosen. The highest-impact change in the release sets the bump. One breaking change makes it a major, no matter how small the release feels. Tag each merged work item with its impact (breaking, feature, fix, internal) at merge time so the bump is a lookup, not a debate. Worked bumps are in references/versioning-guide.md.
Part 3: Release candidate and freeze
A release candidate is one specific, immutable build, named by its version and build identifier. You test the artifact that will ship, not the branch it came from. Any change produces a new candidate (rc.2), and evidence tied to the old one is rechecked.
A freeze is the window between the cut and the go/no-go. Write down three things:
- What may still merge. Fixes for defects in the candidate at or above the go/no-go threshold. Version and release note edits. Nothing else.
- Who decides exceptions. The release owner, by name. Each exception is logged with a reason.
- How long it lasts. The shortest window that lets the gate run. For a two-week train, one to two working days is typical.
A freeze that is routinely broken is not a freeze. If every release logs exceptions, the freeze is too long, the cut is too late, or the gate is finding problems that belonged in review.
Part 4: Go or no-go
A written gate with named criteria, evidence for each, and one decision owner. The decision is not whoever is loudest in the room.
| Criterion | Evidence |
|---|---|
| Tests pass on the candidate | Runner summary for the candidate build; test plans for new work from test-case-authoring |
| Open defects within threshold | Count by severity (S1 to S4 from ticket-authoring) against the stated threshold, for example zero S1, zero S2 without a workaround |
| Rollback verified | Date and result of the last exercised rollback for this deploy path |
| Monitoring in place | Dashboards and alerts for the changed areas exist and fire (see monitoring-and-alerting) |
| Release notes drafted | Draft linked, checked against the merged list |
| Owners on call | Named on-call for the rollout window |
Each criterion is marked passed, failed, or not evidenced. Not evidenced counts as failed. A no-go is a normal outcome: record the reason, the fix, and the next date. Use references/go-no-go-template.md.
Part 5: Rollout and rollback
Expose the release in stages. Each stage has a watch list, a minimum dwell time, a stop condition, and an owner.
| Stage | Exposure | Typical dwell | |---|---|---| | Internal | Staff, test accounts, or an internal environment on production data | Until the smoke checks pass and one working session has run on it | | Canary | A small share of traffic, servers, regions, or users | Long enough to cover a peak period for the changed paths | | Everyone | Full exposure | Watch continues through the post-release check |
Watch the signals tied to your service level objectives and the paths this release changed. Write the stop condition as a number before the stage starts: "checkout error rate above 0.5 percent for 10 minutes." When a stop condition fires, halt, roll back per the plan, and record it. If users are affected, it is an incident: hand off to incident-response.
Per-feature exposure inside a release belongs to flags. Ramp schedules and flag lifecycle are in feature-flagging. Choosing the rollout pattern for one feature launch is in feature-launch-playbook.
Rollback is a path you have walked. Name the method (redeploy the previous artifact, revert, turn a flag off), the time it takes, and the last date it was exercised. A rollback never exercised is a guess.
Some changes cannot be rolled back. List them in the rollout plan with their own plan.
- Data migrations. Use expand then contract: add the new structure alongside the old, ship code that works with both, migrate, switch, and remove the old structure in a later release. Each step is reversible on its own.
- External contracts. A published API field or webhook that clients start using cannot be withdrawn without breaking them. Plan forward fixes, not rollbacks.
- Sent communications. Emails, push notifications, and invoices are out the door. Gate them behind the final stage.
See references/rollout-plan-template.md.
Part 6: Hotfix path
A hotfix is a release outside the cadence. It qualifies when a production defect is S1, or S2 with no workaround, or when a security or legal fix cannot wait. A feature someone forgot does not qualify. It waits for the next release.
| May be shortened | May never be skipped | |---|---| | The train schedule and the full freeze | A second person's review of the change | | The full regression pass (run the targeted set for the touched area) | The fix verification test from the bug ticket, passing on the hotfix build | | Full release notes (a single Fixed or Security entry) | A version bump (patch under SemVer) and a changelog entry | | Stage dwell times (shortened, not removed) | A known rollback method |
Branch from the released version, not from the main line. Get the fix back onto the main line the same day and confirm the next release contains it. A hotfix that never returns to the main line ships the bug again next release.
Every hotfix produces a follow-up item: why the defect escaped, and the test that would have caught it. For an S1, that is an after-action-report. See references/hotfix-checklist.md.
Part 7: Release record and communication
The changelog is the durable record. Follow Keep a Changelog conventions: newest version first, each with a date, an Unreleased section at the top, and entries grouped under Added, Changed, Deprecated, Removed, Fixed, and Security. Written for people, not machines.
The record is derived from merged work items. Each item carries a one-line release note (or "internal, no note") at merge time. At the cut, the Unreleased entries move under the new version. Nobody retypes the list from memory.
Release notes are written for the reader affected. Lead with what changes for them and what they need to do. Group by impact, not by team. Separate notes for different audiences when their actions differ. A list of commit messages is not rele
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ai-job-search
73.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.5kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
