Changelog Discipline
Des changelogs traçables jusqu'aux vrais commits — les breaking changes ne sont jamais enterrés ni oubliés
Testé · Fonctionne
Ce que fait
Impose une discipline d'honnêteté à la génération de changelogs : chaque entrée doit se rattacher à un vrai commit ou une vraie PR, les breaking changes sont activement recherchés et placés en tête, et rien n'est inventé ni gonflé artificiellement. Produit un format Keep-a-Changelog strict, à la place de la prose peu structurée que les agents produisent par défaut sans consigne. Comparé à une baseline sans skill sur quatre dépôts open source réels, victoires et défaites publiées intégralement.
Rapport de test
Notre propre skill — testé selon le même protocole, en toute transparence. Comparé en tête-à-tête à une baseline sans skill sur 4 plages de releases open source réelles (Django, Tailwind CSS, FastAPI, curl) : match nul 0-0 sur la fabrication pour les deux bras (aucune entrée, version, date ou citation inventée), mais le skill l'emporte nettement sur la conformité au format Keep-a-Changelog (30/36 contre 13/36) et le placement des breaking changes en tête (4/4 plages contre 0/4), avec de gros gains de couverture en commits traçables (par exemple Django 58 % contre 6 %, Tailwind 87 % contre 0 %). La baseline a gagné la préférence de lisibilité en aveugle sur les deux dépôts les plus volumineux et les plus bruyants (curl, Django), et a légèrement dépassé le skill sur la couverture traçable de FastAPI en citant des commits internes que le skill avait, à raison, exclus — un résultat réellement mitigé, publié intégralement, pertes comprises. Le test du protocole a détecté de vrais problèmes dans nos propres dépôts (liens de benchmark morts, frontmatter YAML strict) — corrigés et revérifiés le jour même.
Testé le: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/changelog-discipline ~/.claude/skills/changelog-discipline
Commandes et exemples de prompts
/changelog-disciplineDes changelogs traçables jusqu'aux vrais commits — les breaking changes ne sont jamais enterrés ni oubliés
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
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