Unreleased Changelog Fragments
August 18, 2026 ยท View on GitHub
Normal pull requests record each notable user-, agent-, operator-, or
public-API-visible change in a new file instead of editing CHANGELOG.md. Use:
changes/<pr-number-or-unique-slug>.<category>.md
Valid categories are added, changed, deprecated, removed, fixed, and
security. Use a lowercase, hyphenated unique name and this exact structure:
---
"githits": patch
"@githits/mcp": none
---
- **Short title** - Describe the user-visible behavior and important rollout or
compatibility impact.
Each public artifact must have an explicit none, patch, minor, or major
impact. Add future independently versioned public artifacts to every fragment.
Keep the body to one concise Markdown bullet. Never edit another change's
fragment.
A pull request that fully reverts an unreleased change removes that change's fragment instead of adding a release note for behavior that will not ship.
A release PR verifies the fragments against the complete tag-to-HEAD ranges and
computes the highest bump per artifact. A fragment with non-none impact on
multiple artifacts must be released for all of them together; never consume it
partially. Group entries by category into each affected artifact's versioned
CHANGELOG.md section and delete only the consumed fragments. Leave fragments
unrelated to that release untouched. A fragment with none for every artifact
documents repository or release-operation impact; it does not trigger a release
and is consumed into the next githits release.
Opening the release PR completes release preparation. A request to audit, prepare, create, cut, or release a version does not authorize merging or enabling auto-merge. Merge requires separate, explicit human approval given after the release PR exists and identifying that PR; earlier release requests do not count as merge approval.