Document Release

Ni-trins post-udgivelses dokumentationsaudit: fanger forældede README, CHANGELOG og TODOs

Af DollarDill · DollarDill/beads-superpowers

Virker med opsætning ★ 8.8/10

Document Release — Ni-trins post-udgivelses dokumentationsaudit: fanger forældede README, CHANGELOG og TODOs

Hvad det gør

Auditerer hver .md-fil i et repo mod diff'en af en færdig feature-gren, så README-tabeller, ARCHITECTURE-noter, CLAUDE.md, CHANGELOG og TODOS matcher det, der faktisk blev udgivet. Anvender selv faktuelle rettelser, scorer CHANGELOG-poster mod en hvad-ændret/hvorfor-vigtigt/hvordan-bruges-rubrik, og nægter at bump'e VERSION uden at spørge. Udløses af 'update docs', 'documentation audit', 'sync documentation' eller en gren, der er ved at blive merget eller PR'et.

Testrapport

Kørte begge pass på en rigtig gren, der udgav et --json-flag og en TEXTKIT_TIMEOUT env-variabel i et repo med bevidst forældet dokumentation. Færdighedens CHANGELOG sell-test omskrev en commit-voice-post, der aldrig nævnte det udgivne flag, til brugerrettede 'You can now'-linjer og fjernede et internt bd-0412-tag fra læserrettet prosa; det uassisterede pass lod den post uberørt og overså også den nye kildekodefil i CLAUDE.md-projekttræet. Den stopper og spørger, før den bump'er VERSION, en beslutning som baselinen aldrig overhovedet kom frem med. Fangsten er Beads-integrationen, der er vævet gennem fire af dens trin: `bd create` returnerede 'no beads database found' i et nyt repo, så budgetter `brew install beads` plus en per-repo `bd init` først. Dens diagramregel betyder også, at et ASCII-arkitekturdiagram, der navngiver en omdøbt klasse, bliver markeret, ikke rettet.

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

Installation

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

Kommandoer og eksempelprompter

  • /document-releaseNi-trins post-udgivelses dokumentationsaudit: fanger forældede README, CHANGELOG og TODOs

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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