← ClaudeAtlas

technical-changeloglisted

Generate a diff-grounded, one-page technical changelog for a release — from the actual code changes between the last production tag and HEAD (the next, still-unreleased version). Asks for the next version number, since HEAD is not yet in package.json.
brianwestphal/hotsheet · ★ 6 · Code & Development · score 74
Install: claude install-skill brianwestphal/hotsheet
Produce a **one-page technical report** of what changed for a release, stored in `docs/technical-changelog/<base>-<next>.md`. The report must be grounded in the **real diff** — added/modified/removed code, route/flag/dep/channel deltas — **not** commit messages or the requirements docs. In this repo especially, `docs/**` describes the *end state* and the *whole* feature history (see `docs/ai/requirements-summary.md`), so it routinely credits the range with work that predates it, or describes posture that was already true. Every claim is a verified delta between the base tag and HEAD. ## The two facts that make this skill necessary 1. **HEAD is the next, unreleased version.** `package.json` still holds the *last* released version, so the release number can't be read from the repo — **you must ask the user** what the next planned version is. 2. **The base is always the most recent production release tag** (e.g. `v0.9.0`), and the range is `<base>..HEAD`. Pre-release tags (`-beta`, `-rc`) are never the base. Note this repo's `package.json` version can be far ahead of the newest `vX.Y.Z` tag — the script picks the newest **tag**, which is correct; it warns if that isn't what you expect. ## Steps 1. **Ask for the next release number first.** Use `AskUserQuestion` (or ask in prose): *"What's the next planned release version for this changelog?"* Do not guess and do not read it from `package.json` (that's the previous release). Accept e.g. `1.2.0` / `v1.2.0`