Document Release

Ni-trinns dokumentrevisjon etter utsendelse: fanger opp utdatert README, CHANGELOG og TODOs

av DollarDill · DollarDill/beads-superpowers

Krever oppsett ★ 8.8/10

Document Release — Ni-trinns dokumentrevisjon etter utsendelse: fanger opp utdatert README, CHANGELOG og TODOs

Hva den gjør

Reviderer hver .md-fil i et repo mot diffen av en ferdig funksjonsgren, slik at README-tabeller, ARCHITECTURE-notater, CLAUDE.md, CHANGELOG og TODOS samsvarer med det som faktisk ble sendt. Anvender faktiske korreksjoner selv, scorer CHANGELOG-oppføringer mot en hva-endret/hvorfor-bry-seg/hvordan-bruke-rubrikk, og nekter å øke VERSION uten å spørre. Utløses av 'update docs', 'documentation audit', 'sync documentation' eller en gren som er i ferd med å bli slått sammen eller PR'd.

Testrapport

Kjørte begge passene på en ekte gren som sendte et --json-flagg og en TEXTKIT_TIMEOUT env-variabel inn i et repo med bevisst utdaterte dokumenter. Ferdighetens CHANGELOG-salgstest omskrev en commit-voice-oppføring som aldri nevnte det sendte flagget til brukerrettede 'You can now'-linjer og fjernet en intern bd-0412-tag fra leserrettet prosa; den uassisterte passet lot den oppføringen være urørt og savnet også den nye kildekoden i CLAUDE.md-prosjekttreet. Den stopper og spør før den øker VERSION, en beslutning baselinen aldri avdekket i det hele tatt. Haken er Beads-integrasjonen vevd gjennom fire av trinnene: `bd create` returnerte 'no beads database found' i et nytt repo, så budsjetter `brew install beads` pluss en per-repo `bd init` først. Diagramregelen betyr også at et ASCII-arkitekturdiagram som navngir en omdøpt klasse blir flagget, ikke fikset.

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

Installer

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-trinns dokumentrevisjon etter utsendelse: fanger opp utdatert README, CHANGELOG og TODOs

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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