Document Release

Auditoría de documentación post-lanzamiento de nueve pasos: detecta README, CHANGELOG y TODOs obsoletos

Por DollarDill · DollarDill/beads-superpowers

Funciona con configuración ★ 8.8/10

Document Release — Auditoría de documentación post-lanzamiento de nueve pasos: detecta README, CHANGELOG y TODOs obsoletos

Qué hace

Audita cada archivo .md en un repositorio contra el diff de una rama de característica terminada, para que las tablas del README, las notas de ARCHITECTURE, CLAUDE.md, CHANGELOG y TODOS coincidan con lo que realmente se envió. Aplica correcciones fácticas por sí misma, califica las entradas de CHANGELOG contra una rúbrica de qué cambió/por qué importa/cómo usar, y se niega a aumentar la VERSION sin preguntar. Se activa con 'update docs', 'documentation audit', 'sync documentation' o una rama a punto de ser fusionada o PR'd.

Informe de la prueba

Ejecutó ambas pasadas en una rama real que envió un flag --json y una variable de entorno TEXTKIT_TIMEOUT a un repositorio con documentación deliberadamente obsoleta. La prueba de venta de CHANGELOG de la habilidad reescribió una entrada con voz de commit que nunca mencionó el flag enviado en líneas 'You can now' orientadas al usuario y eliminó una etiqueta interna bd-0412 de la prosa orientada al lector; la pasada sin ayuda dejó esa entrada intacta y también omitió el nuevo archivo fuente en el árbol de proyectos CLAUDE.md. Se detiene y pregunta antes de aumentar la VERSION, una decisión que la línea base nunca mostró. El problema es la integración de Beads tejida a través de cuatro de sus pasos: `bd create` devolvió 'no beads database found' en un repositorio nuevo, así que primero presupueste `brew install beads` más un `bd init` por repositorio. Su regla de diagrama también significa que un diagrama de arquitectura ASCII que nombra una clase renombrada se marca, no se corrige.

Probado el: 2026-08-05 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/DollarDill/beads-superpowers.git
mkdir -p ~/.claude/skills
cd beads-superpowers && cp -r skills/document-release ~/.claude/skills/document-release

Comandos y prompts de ejemplo

  • /document-releaseAuditoría de documentación post-lanzamiento de nueve pasos: detecta README, CHANGELOG y TODOs obsoletos

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • This branch is done, update the docs before I open the PR
  • Run a documentation audit against this feature branch
  • Sync the README and CHANGELOG with what we actually shipped