Changelog Discipline

Changelogs que se rastrean hasta commits reales — los cambios disruptivos nunca se entierran ni se pierden

Por SkillProof · Skillproofdev/changelog-discipline

Probado · Funciona ★ 8.0/10

Changelog Discipline — Changelogs que se rastrean hasta commits reales — los cambios disruptivos nunca se entierran ni se pierden

Qué hace

Impone disciplina de honestidad en la generación de changelogs: cada entrada debe rastrearse hasta un commit o PR real, los cambios disruptivos se buscan activamente y se colocan primero, y no se inventa ni se rellena nada. Genera un formato estricto Keep-a-Changelog en lugar de la prosa poco estructurada que los agentes producen por defecto sin instrucciones. Evaluado contra una línea base sin skill en cuatro repos OSS reales, publicando tanto las victorias como las derrotas al completo.

Informe de la prueba

Skill propia — evaluada bajo el mismo protocolo, con divulgación completa. Comparada cara a cara con una línea base sin skill en 4 rangos de lanzamiento OSS reales (Django, Tailwind CSS, FastAPI, curl): la fabricación quedó empatada 0-0 en ambos brazos (ninguno inventó entradas, versiones, fechas ni citas), pero la skill ganó con claridad en cumplimiento del formato Keep-a-Changelog (30/36 frente a 13/36) y en colocar primero los cambios disruptivos (4/4 rangos frente a 0/4), además de mejoras grandes en cobertura de commits rastreables (por ejemplo, Django 58% frente a 6%, Tailwind 87% frente a 0%). La línea base ganó la preferencia de legibilidad a ciegas en los dos repos más grandes y ruidosos (curl, Django), y superó ligeramente a la skill en cobertura rastreable de FastAPI al citar commits internos que la skill excluyó correctamente — un resultado genuinamente mixto, publicado al completo incluyendo las derrotas. 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/changelog-discipline ~/.claude/skills/changelog-discipline

Comandos y prompts de ejemplo

  • /changelog-disciplineChangelogs que se rastrean hasta commits reales — los cambios disruptivos nunca se entierran ni se pierden

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

  • Write release notes for v2.3.0 based on the commits since v2.2.0
  • Update CHANGELOG.md with everything that changed since the last release
  • What changed between the v1.4 and v2.0 tags? I need to draft a release announcement from the commit history