README Discipline
Des README ancrés dans le code : chaque affirmation tracée à un fichier:ligne, chaque commande vérifiée à l'exécution.
Testé · Fonctionne
Ce que fait
Force la génération et l'audit de README à tracer chaque affirmation jusqu'à sa source avant de l'écrire : les fonctionnalités doivent être retrouvées dans le code, les commandes doivent être copiées depuis de vrais manifestes puis exécutées, et une section Limitations sourcée est obligatoire. Comparé à des agents baseline sur 3 dépôts open source réels, avec une victoire nette sur la complétude et la préférence en aveugle, même si la réduction de fabrication reste modeste et que l'évaluation reposait sur un seul évaluateur.
Rapport de test
Notre propre skill — testé selon le même protocole, en toute transparence. Le bench a mesuré 3 dépôts open source figés, agent baseline contre agent avec skill : le skill atteint 18/18 en complétude des sections contre 14/18, a été préféré 3/3 avec un score de confiance de 4,67 contre 3,67, et présente moins d'affirmations fabriquées (1 contre 2, un écart étroit puisque les deux baselines empruntaient du contenu exact à la documentation existante). Réserves révélées dans le verdict : un seul évaluateur expert (et non le panel d'au moins 3 développeurs que le protocole exige), N=3, et le skill a lui-même consigné sa propre fabrication (une confusion HTTP 400/500) plutôt que de la dissimuler. 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/readme-discipline ~/.claude/skills/readme-discipline
Commandes et exemples de prompts
/readme-disciplineDes README ancrés dans le code : chaque affirmation tracée à un fichier:ligne, chaque commande vérifiée à l'exécution.
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 a README for this repoCan you review our README.md and flag anything that's inaccurate or outdated?I'm scaffolding a new npm package — generate the initial README along with package.json