README Discipline
READMEs anclados en el código: cada afirmación rastreada hasta file:line, cada comando verificado en ejecución.
Probado · Funciona
Qué hace
Obliga a que la generación y auditoría de READMEs rastree cada afirmación hasta el código fuente antes de escribirla: las funciones deben encontrarse en el código, los comandos deben copiarse de manifiestos reales y ejecutarse, y una sección de Limitaciones con fuentes es obligatoria. Evaluada contra agentes base en 3 repos OSS reales, con una victoria clara en completitud y preferencia ciega, aunque el margen de reducción de fabricaciones es estrecho y la evaluación usó un único evaluador.
Informe de la prueba
Skill propia — evaluada bajo el mismo protocolo, con divulgación completa. El benchmark midió 3 repos OSS congelados, agente base frente a agente con skill: la skill alcanzó 18/18 en completitud de secciones frente a 14/18, fue la preferida 3/3 con una confianza de 4.67 frente a 3.67, y tuvo menos afirmaciones fabricadas (1 frente a 2, un margen estrecho porque ambas líneas base tomaron contenido preciso de la documentación existente). Salvedades divulgadas en el veredicto: un único evaluador experto (no el panel de ≥3 desarrolladores que exige el protocolo), N=3, y la propia skill registró su fabricación (una confusión entre HTTP 400/500) en lugar de ocultarla. La prueba del protocolo encontró problemas reales en nuestros propios repos (enlaces de benchmark caídos, frontmatter YAML estricto) — corregidos y reverificados el mismo día.
Probado el: 2026-07-11 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/Skillproofdev/readme-discipline ~/.claude/skills/readme-discipline
Comandos y prompts de ejemplo
/readme-disciplineREADMEs anclados en el código: cada afirmación rastreada hasta file:line, cada comando verificado en ejecución.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
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