Commit 843f18b
Teach /update-changelog to drop RC-only regression fixes (#1125)
## Summary
When collapsing prereleases (e.g., `v10.1.0-rc.0` → `v10.1.0-rc.1`), a
fix for a bug introduced by a PR that only ever shipped in the
prerelease train is invisible to consumers of the last stable release.
Listing it under the new RC/release header just adds noise.
This PR updates `.claude/commands/update-changelog.md` so the command:
- **Excludes RC-only regression fixes** in the "Do NOT add entries for"
list (with a forward-reference to the detailed rule)
- **Adds a dedicated step** in the RC/beta collapse procedure that walks
through detecting and dropping these entries, with the rc.0 → rc.1
example
- **Requires surfacing dropped entries in the final summary** so the
maintainer can override case-by-case (e.g., keep one for RC testers)
## Motivation
Caught while stamping `v10.1.0-rc.1` in #1124. PR #1120 fixes a
regression introduced by PR #1110 (gem-file allowlist), which itself
only shipped in `v10.1.0-rc.0`. Users on `v10.0.0` jumping straight to
`v10.1.0-rc.1` never see the bug, so PR #1120's fix is internal RC churn
rather than a user-facing change. The previous version of the command
would have kept it in the changelog.
## Test plan
- [ ] Maintainer review of the prose
- [ ] Try the next `/update-changelog rc` invocation and confirm the
model now asks about (or silently drops) RC-only regression fixes
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> **Low Risk**
> Low risk: documentation/procedure updates only, affecting how
changelog entries are curated during RC/beta version stamping.
>
> **Overview**
> Updates the `/update-changelog` instructions to **avoid standalone
changelog entries for RC-only regression fixes** (fixes that only undo a
regression introduced earlier in the same prerelease train).
>
> Adds a dedicated prerelease-collapsing step that directs the
maintainer to **merge such fixes into the original prerelease PR entry
(or drop them if redundant)**, and to **explicitly list any
merged/dropped items in the final summary** for review/override.
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
08b4488. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent ba495cd commit 843f18b
1 file changed
Lines changed: 11 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
83 | 83 | | |
84 | 84 | | |
85 | 85 | | |
| 86 | + | |
86 | 87 | | |
87 | 88 | | |
88 | 89 | | |
| |||
298 | 299 | | |
299 | 300 | | |
300 | 301 | | |
| 302 | + | |
| 303 | + | |
| 304 | + | |
| 305 | + | |
| 306 | + | |
| 307 | + | |
| 308 | + | |
| 309 | + | |
| 310 | + | |
| 311 | + | |
301 | 312 | | |
302 | 313 | | |
303 | 314 | | |
| |||
0 commit comments