Changelog Discipline
Changelogs mit Rückverfolgbarkeit zu echten Commits — Breaking Changes werden nie versteckt oder unterschlagen.
Getestet · Funktioniert
Was es kann
Erzwingt Ehrlichkeitsdisziplin bei der Changelog-Erstellung: Jeder Eintrag muss sich auf einen echten Commit oder PR zurückführen lassen, Breaking Changes werden aktiv gesucht und an erster Stelle platziert, nichts wird erfunden oder künstlich aufgebläht. Das Ergebnis ist striktes Keep-a-Changelog-Format statt der lose strukturierten Prosa, zu der Agenten ohne Vorgabe von sich aus neigen. Getestet gegen eine Baseline ohne Skill an vier echten Open-Source-Repos, Gewinne und Niederlagen vollständig veröffentlicht.
Testbericht
Unser eigener Skill — getestet nach demselben Protokoll, offengelegt. Direkt gegen eine Baseline ohne Skill getestet, über 4 echte Release-Bereiche aus Open-Source-Projekten (Django, Tailwind CSS, FastAPI, curl): Bei erfundenen Inhalten stand es 0:0 für beide Seiten (keiner erfand Einträge, Versionen, Daten oder Quellenangaben), aber der Skill gewann klar bei der Einhaltung des Keep-a-Changelog-Formats (30/36 statt 13/36) und bei der Platzierung von Breaking Changes an erster Stelle (4/4 Bereiche statt 0/4), dazu deutliche Zugewinne bei der Rückverfolgbarkeit zu Commits (z. B. Django 58 % statt 6 %, Tailwind 87 % statt 0 %). Bei den beiden größten und unübersichtlichsten Repos (curl, Django) gewann die Baseline die blinde Lesbarkeitsbewertung, und bei FastAPI lag sie bei der Rückverfolgbarkeit knapp vorn, weil sie interne Commits zitierte, die der Skill zu Recht ausschloss — ein wirklich gemischtes Ergebnis, vollständig veröffentlicht, samt Niederlagen. Der Protokolltest hat echte Probleme in unseren eigenen Repos aufgedeckt (tote Benchmark-Links, strenges YAML-Frontmatter) — noch am selben Tag behoben und erneut verifiziert.
Getestet am: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Befehle & Beispiel-Prompts
/changelog-disciplineChangelogs mit Rückverfolgbarkeit zu echten Commits — Breaking Changes werden nie versteckt oder unterschlagen.
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
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