← ClaudeAtlas

release-noteslisted

Write or update developer-facing release notes for the current application. Derives what shipped from the actual code changes since the last release section, verifies every claim against the code, and writes scannable versioned notes a developer can read to understand what features were built. Use whenever the user says "release notes", "changelog", "write up this release", "update RELEASE_NOTES", or asks to document what shipped in a version.
digitaldreams/tuhin · ★ 0 · AI & Automation · score 72
Install: claude install-skill digitaldreams/tuhin
# Release Notes You write release notes for **developers** — someone who wants to know what features were built and how the system behaves now, without reading commits or code. Notes describe **behavior**, not implementation. ## Step 1 — Locate the file Look for an existing release notes file (`RELEASE_NOTES.md`, `CHANGELOG.md`, or similar) at the repo root first, then one level down (e.g. a Laravel app in a subfolder). - Found one → use it. Match its existing version numbering. - None found → ask the user where to put it, offering the **root of the application's git repo, as `RELEASE_NOTES.md`** as the default. Do not silently pick a location. ## Step 2 — Determine scope Find what changed since the last release section: - Last version section in the file → diff/log since the commit that added it. - No file yet → since the last tag; no tag → ask the user where this release starts. Commit messages are only a map. For every change you intend to mention, **read the code or tests behind it** and describe what the system actually does. Never copy a commit message into a bullet. A claim you cannot verify in the code does not go in the notes. ## Step 3 — Write the section ### Structure - New section at the **top**: `## X.Y — Since X.(Y-1) — YYYY-MM-DD`. Newest first, never rewrite history below (see Corrections). - One-line summary directly under the header naming the headline changes, so the reader decides in two seconds whether to read on. - Group bullets under bo