Add a shared instruction kernel and byte-budgeted topic router so agents load only task-relevant repository guidance. Wire drift checks into local and CI workflows and point project skills at the routed topics.
2.5 KiB
Changelog and Release
Use when writing a version changelog, release notes, version bump, tag, announcement, or full release.
Authorization Boundary
A changelog-only request does not authorize commits, tags, pushes, publication, or version bumps. A full release request authorizes preparation and explicitly included local Git actions, but pushing or publishing still requires user confirmation. Never mix unrelated working-tree changes into staging.
Changelog
- Determine the range from the requested version or tags, then collect commits with
git log <previous>..<current> --no-merges. - Read the newest two or three
CHANGELOG.mdentries and follow the current style. - Categorize user-visible features, bug fixes, performance improvements, and breaking changes. Exclude test-only, CI-only, pure refactoring, and internal implementation noise.
- Verify every feature claim against source and never fabricate links.
- Add the entry at the top of
CHANGELOG.mdand insert the same release entry after the frontmatter/intro separator inwebsite/src/pages/changelog.md.
Version headings use [X.Y.Z] without a v prefix and include the date. Feature bullets use a bold name, an em dash, and a real usage example. Create only sections that contain content.
Full Release
Before starting:
- Confirm the requested version and branch.
- Use
git statusto separate task-owned changes from existing work. - Run the complete
make checkinside the devcontainer and never skip a failure.
Then:
- Generate and review the changelog.
- For maintainer-only release notes, follow the newest
specs/RELEASE_NOTES_*.mdand write user-facing prose tospecs/RELEASE_NOTES_<version>.md. - Verify the current version location from source before bumping it; do not assume a fixed field still exists.
- Commit or tag only when explicitly requested. Stage only task-owned files and follow recent repository release commits.
- Draft concise GitHub release notes and a social announcement.
- Present tests, diffs, local-only artifacts, and commit/tag state; obtain confirmation before pushing or publishing.
Release notes are local maintainer artifacts by default. Never force-add an ignored file unless explicitly requested. Never infer authorization for credentials, registry login, or external publication.
Verification and Report
Report actual test results, whether both changelog copies match, the verified version location, commit/tag state, and external actions not performed. If the working tree is dirty, list the unrelated changes that were preserved.