RSC Update Changelog
Use this skill for react-on-rails-rsc changelog and release-heading work. The
package release is changelog-driven: CHANGELOG.md and package.json must name
the same target version before the GitHub Actions release workflow runs.
Modes
- No argument: add user-visible entries under
## [Unreleased].
classification-sweep BASE_REF..TARGET_REF: print a read-only table for every
merged PR in the selected range before deciding which entries to add.release: add entries, stamp the next stable version header, and bump
package.json to the same version.rc or beta: same as release, but stamp a prerelease version such as
19.0.5-rc.0 or 19.0.5-beta.0.- Explicit version: stamp exactly the provided semver version.
RSC Release Rules
- Tags have no
v prefix. Stable tags match ^[0-9]+\.[0-9]+\.[0-9]+$;
prerelease tags use hyphen suffixes such as 19.0.5-rc.7.
scripts/release.sh reads the top changelog heading and verifies
package.json matches it through yarn release:check.- The canonical release path is: update
CHANGELOG.md and package.json in a
PR, merge it, run yarn release:check from clean synced main, then dispatch
the Release package workflow using the printed command.
- Add changelog entries only for user-visible package behavior: public API,
exports, plugin/loader behavior, configuration, release behavior, security,
performance, fixes, and breaking changes. Skip pure formatting, internal
refactors, test-only changes, and docs-only fixes unless they correct behavior
documentation.
Classification Sweep
Set BASE_REF and TARGET_REF, then list squash-merged PRs in first-parent
order. Fall back to GitHub commit-to-PR lookup for commits without (#NNN) in
the title, and emit UNKNOWN for commits that still cannot be mapped.
Before writing, show the proposed classification table and ask the user to
confirm any ambiguous bump, missing PR mapping, or explicit version.
1---2name: rsc-update-changelog3description: Update react-on-rails-rsc CHANGELOG.md and optional package version headers for npm release or prerelease workflows.4---56# RSC Update Changelog78Use this skill for `react-on-rails-rsc` changelog and release-heading work. The9package release is changelog-driven: `CHANGELOG.md` and `package.json` must name10the same target version before the GitHub Actions release workflow runs.1112## Modes1314- No argument: add user-visible entries under `## [Unreleased]`.15- `classification-sweep BASE_REF..TARGET_REF`: print a read-only table for every16 merged PR in the selected range before deciding which entries to add.17- `release`: add entries, stamp the next stable version header, and bump18 `package.json` to the same version.19- `rc` or `beta`: same as `release`, but stamp a prerelease version such as20 `19.0.5-rc.0` or `19.0.5-beta.0`.21- Explicit version: stamp exactly the provided semver version.2223## RSC Release Rules2425- Tags have no `v` prefix. Stable tags match `^[0-9]+\.[0-9]+\.[0-9]+$`;26 prerelease tags use hyphen suffixes such as `19.0.5-rc.7`.27- `scripts/release.sh` reads the top changelog heading and verifies28 `package.json` matches it through `yarn release:check`.29- The canonical release path is: update `CHANGELOG.md` and `package.json` in a30 PR, merge it, run `yarn release:check` from clean synced `main`, then dispatch31 the `Release package` workflow using the printed command.32- Add changelog entries only for user-visible package behavior: public API,33 exports, plugin/loader behavior, configuration, release behavior, security,34 performance, fixes, and breaking changes. Skip pure formatting, internal35 refactors, test-only changes, and docs-only fixes unless they correct behavior36 documentation.3738## Classification Sweep3940Set `BASE_REF` and `TARGET_REF`, then list squash-merged PRs in first-parent41order. Fall back to GitHub commit-to-PR lookup for commits without `(#NNN)` in42the title, and emit `UNKNOWN` for commits that still cannot be mapped.4344Before writing, show the proposed classification table and ask the user to45confirm any ambiguous bump, missing PR mapping, or explicit version.
shakacode