changelog-format
SolidThe shape of a CHANGELOG.md entry and heading in this repo. Load before writing an [Unreleased] line or cutting a release block.
AI & Automation 2,680 stars
366 forks Updated today NOASSERTION
Install
Quality Score: 81/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# CHANGELOG format
Authority: the top of `CHANGELOG.md` (the newest block is the template),
`scripts/dod_changelog.py` (DoD 3, the gate), CLAUDE.md "Output Rules"
(the CHANGELOG voice is the one deliberate carve-out: entries ARGUE).
- Heading: `## [X.Y.Z] - YYYY-MM-DD - <thesis sentence>`; the thesis is
the one lesson of the release. `## [Unreleased]` sits above it and is
never empty at release time.
- An entry says what was wrong, why (the mechanism), and what the fix
makes impossible, not what files changed. Credit the reporter by
login and cite `#N`.
- A number in an entry is pasted from an evidence file of the same run or
read from `harness/thresholds.json`; a typed number is a finding for
the reviewer.
- A tool added or removed is named in the entry (`scripts/surface_diff.py`
checks the CHANGELOG diff for the name).
- A retired test's entry names the lesson and the replacement assertion
(mirrors `harness/retired.json`, DoD 11).
- The `no-changelog` label exempts a PR and is printed in the check
summary; docs-only, CI-only and test-only changes trigger nothing.
Details
- Author
- jgravelle
- Repository
- jgravelle/jcodemunch-mcp
- Created
- 7 months ago
- Last Updated
- today
- Language
- Python
- License
- NOASSERTION
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
changelog-entry
Draft a CHANGELOG.md [Unreleased] entry from the current diff, in the repo's own house voice. Use when the user says "changelog", "add a changelog entry", "write the changelog", "/changelog-entry", or after landing a user-visible change in a repo that keeps a CHANGELOG.md.
0 Updated 2 weeks ago
stamat AI & Automation Listed
changelog
Keep a Changelog methodology — loaded by the ship phase to update CHANGELOG.md with user-facing changes, filtering out internal-only commits
11 Updated today
bostonaholic