Changelog Discipline
Changelogs die herleidbaar zijn tot echte commits — breaking changes raken nooit verstopt of kwijt.
Getest · Werkt
Wat het doet
Dwingt eerlijkheid af bij het genereren van changelogs: elke regel moet herleidbaar zijn tot een echte commit of PR, breaking changes worden actief opgespoord en bovenaan gezet, en er wordt niets verzonnen of aangedikt. Levert strikte Keep-a-Changelog-opmaak op, in plaats van het los-vaste proza waar agents zonder sturing standaard in vervallen. Getest tegen een baseline zonder skill op vier echte open-sourcerepo's, met zowel de winst als het verlies volledig gepubliceerd.
Testrapport
Onze eigen skill — getest onder hetzelfde protocol, transparant vermeld. Rechtstreeks getest tegen een baseline zonder skill over 4 echte OSS release-ranges (Django, Tailwind CSS, FastAPI, curl): verzinsels stonden 0-0 gelijk voor beide varianten (geen van beide verzon regels, versies, datums of bronvermeldingen), maar de skill won overtuigend op Keep-a-Changelog-opmaak (30/36 tegenover 13/36) en op het vooraan plaatsen van breaking changes (4/4 ranges tegenover 0/4), plus grote winst in herleidbare commit-dekking (bijvoorbeeld Django 58% tegenover 6%, Tailwind 87% tegenover 0%). De baseline won de blinde leesbaarheidsvoorkeur bij de twee grootste/rommeligste repo's (curl, Django) en deed het bij FastAPI net iets beter op herleidbare dekking door interne commits te citeren die de skill terecht had uitgesloten — een oprecht gemengd resultaat, volledig gepubliceerd inclusief het verlies. De protocoltest vond echte problemen in onze eigen repo's (dode benchmarklinks, strikte YAML-frontmatter) — dezelfde dag nog opgelost en opnieuw geverifieerd.
Getest op: 2026-07-11 · Claude Code 2.x (agent harness)
Installatie
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Commando's en voorbeeldprompts
/changelog-disciplineChangelogs die herleidbaar zijn tot echte commits — breaking changes raken nooit verstopt of kwijt.
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Write release notes for v2.3.0 based on the commits since v2.2.0Update CHANGELOG.md with everything that changed since the last releaseWhat changed between the v1.4 and v2.0 tags? I need to draft a release announcement from the commit history