release-manager

Guides the end-to-end DevThrottle release workflow from change assembly through tag and announcement.

96|11|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/thefrederiksen/devthrottle --skill release-manager-thefrederiksen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-manager
Source: https://github.com/thefrederiksen/devthrottle/tree/main/.claude/skills/release-manager
Command: npx skills add https://github.com/thefrederiksen/devthrottle --skill release-manager-thefrederiksen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a software release involves many error-prone steps: assembling accurate change lists, writing honest release notes, coordinating documentation, bumping versions, tagging, and announcing. This Skill provides a gated, step-by-step run-book that prevents common release mistakes like documenting unshipped features, tagging untested commits, or sending bulk email without a working unsubscribe. ## Core Features & Use Cases - Gated 11-step workflow: Each step (pre-flight, versioning, change assembly, accuracy verification, notes writing, docs coordination, sign-off, tagging, announcement, verification) has an explicit gate that must be cleared before proceeding. - Accuracy gate for release notes: Verifies every headline feature against actual running code rather than design documents, distinguishing shipped defaults from opt-in previews. - Deployment ordering enforcement: Detects Gateway hub method changes via git diff and requires the hosted Gateway to be deployed before the release tag is pushed. - Use Case: A maintainer types "/release-manager" and the agent fetches origin, proposes v1.2.0, assembles and verifies the change list, writes docs/public/release-notes/v1.2.0.md, coordinates the internal changelog session, and prepares the version-bump pull request so the human only has to publish the tag. ## Quick Start Ask the agent to cut a release by saying "prepare a release" or invoking /release-manager, and it will walk you through each gated step starting with pre-flight checks.

Frequently Asked Questions about release-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cut a release for DevThrottle?▼

Invoke the release-manager skill and follow its 11 gated steps: sync to origin/main, agree a semantic version, assemble the change list from git log, verify features against code, write release notes, get human sign-off, merge a version-bump pull request, run the local Release test gate, then let the human push the tag.

How do I write accurate release notes from git history?▼

Run git log between the last tag and origin/main, group commits into themes, then verify each headline against the actual code rather than design documents. Features merged but off by default must be described as opt-in previews, not shipped defaults.

Why must the hosted Gateway deploy before pushing a release tag?▼

The desktop Director auto-updates but the hosted Gateway only ships via a manual deploy workflow. If a release adds Gateway hub methods and the tag ships first, every updated machine calls methods the live Gateway does not know, causing fleet-wide failures until the Gateway is deployed.

Can the agent publish the GitHub release itself?▼

No. The human always publishes the release because pushing a tag is outward-facing and hard to reverse. The agent prepares everything, and the release workflow creates a draft release, attaches assets, and publishes only once the manifest is attached.

When can release announcement emails be sent to the mailing list?▼

Only after the opt-out feature is live and tested: an unsubscribed_at timestamp per member, a one-click unsubscribe endpoint, a preferences page, a transactional email provider, and a template with unsubscribe link and postal address. Otherwise the announcement is held as a fast-follow.

Why does the release gate run tests locally instead of using CI?▼

The release workflow runs zero tests and a pushed tag cannot be un-pushed, so the blocking gate is a local run on merged main at the exact tagged commit. It uses test-local.ps1 with -Parked and Release configuration plus the two installer test projects the script does not cover.