diff --git a/AGENTS.md b/AGENTS.md index aff0e2c..84ff01b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -17,6 +17,17 @@ demonstrated transport need. Run `npm run check` and the relevant HTTP benchmark before declaring a performance-sensitive change ready. +## Changelog + +Any change to the `version` field in `package.json`, whether a release, +prerelease, or patch bump, must include a matching `## ` section in +`CHANGELOG.md` in the same commit or pull request. Date the section and list +breaking changes (with migration notes), deprecations, additions, and fixes. +Move entries from `Unreleased` into the new version section rather than leaving +them there. If the repository has no `CHANGELOG.md` yet, create one (Keep a +Changelog style) at the next version bump. Do not publish or tag a version whose +changelog section is missing. + ## Optimization Gate A benchmark number is only half of an optimization's success criterion. The