README Discipline
Kodefunderede README'er: hver påstand spores til file:line, hver kommando er verificeret til at køre.
Testet · Virker
Hvad det gør
Tvinger README-generering og -audits til at spore hver påstand til kildekoden, før den må skrives — funktioner skal findes i koden, kommandoer skal kopieres fra rigtige manifester og afprøves, og et kildebelagt afsnit om begrænsninger er obligatorisk. Benchmarket mod baseline-agenter på 3 rigtige open source-repos med en klar sejr på fuldstændighed og blind præference, selvom marginen for reduktion af opdigtninger er smal, og evalueringen brugte kun én bedømmer.
Testrapport
Vores eget skill — testet efter samme protokol, og det oplyser vi åbent. Benchmarken målte 3 fastfrosne open source-repos, baseline mod skill-agent: skillet ramte 18/18 på afsnitsfuldstændighed mod 14/18, blev foretrukket 3/3 med tillid på 4,67 mod 3,67, og havde færre opdigtede påstande (1 mod 2 — en smal margin, da begge baselines lånte korrekt indhold fra eksisterende dokumentation). Forbeholdene er oplyst i konklusionen: én ekspertbedømmer (ikke det panel på mindst 3 udviklere, protokollen foreskriver), N=3, og skillet loggede selv sin egen opdigtning (en sammenblanding af HTTP 400/500) i stedet for at skjule den. Protokoltesten fangede reelle problemer i vores egne repos (døde benchmark-links, striks YAML-frontmatter) — rettet og genverificeret samme dag.
Testet: 2026-07-11 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Skillproofdev/readme-discipline ~/.claude/skills/readme-discipline
Kommandoer og eksempelprompter
/readme-disciplineKodefunderede README'er: hver påstand spores til file:line, hver kommando er verificeret til at køre.
Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):
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