README Discipline
README ancorati al codice: ogni affermazione tracciata fino a file:riga, ogni comando verificato all'esecuzione.
Promosso
Cosa fa
Obbliga la generazione e la revisione dei README a tracciare ogni affermazione fino al codice sorgente prima di poterla scrivere: le funzionalità devono trovare riscontro nel codice, i comandi vanno copiati da manifest reali e testati, e una sezione Limitations con fonti è obbligatoria. Confrontato con agenti baseline su 3 repo OSS reali, con una vittoria netta su completezza e preferenza cieca, anche se il margine sulla riduzione delle fabbricazioni è ridotto e la valutazione ha usato un solo valutatore.
Rapporto di test
Skill nostro — testato con lo stesso protocollo, dichiarato apertamente. Il bench ha misurato 3 repo OSS congelati, baseline contro agente con skill: lo skill ha raggiunto 18/18 nella completezza delle sezioni contro 14/18, è stato preferito 3/3 con un punteggio di fiducia di 4,67 contro 3,67, e ha avuto meno affermazioni fabbricate (1 contro 2, un margine ridotto perché anche la baseline ha attinto contenuti accurati dalla documentazione esistente). Limiti dichiarati nel verdetto: un solo valutatore esperto (non il pannello di almeno 3 sviluppatori richiesto dal protocollo), N=3, e lo skill ha registrato la propria fabbricazione (una confusione tra HTTP 400 e 500) invece di nasconderla. Il test di protocollo ha trovato problemi reali nei nostri stessi repo (link ai benchmark morti, frontmatter YAML troppo rigido) — corretti e riverificati lo stesso giorno.
Testato il: 2026-07-11 · Claude Code 2.x (agent harness)
Installazione
git clone https://github.com/Skillproofdev/readme-discipline ~/.claude/skills/readme-discipline
Comandi e prompt di esempio
/readme-disciplineREADME ancorati al codice: ogni affermazione tracciata fino a file:riga, ogni comando verificato all'esecuzione.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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