Document Release

Nio-stegs dokumentgranskning efter leverans: fångar inaktuella README, CHANGELOG och TODOs

av DollarDill · DollarDill/beads-superpowers

Fungerar med konfiguration ★ 8.8/10

Document Release — Nio-stegs dokumentgranskning efter leverans: fångar inaktuella README, CHANGELOG och TODOs

Vad den gör

Granskar varje .md-fil i ett repo mot diffen av en färdig funktionsgren, så att README-tabeller, ARCHITECTURE-anteckningar, CLAUDE.md, CHANGELOG och TODOS matchar vad som faktiskt levererades. Tillämpar faktiska korrigeringar själv, poängsätter CHANGELOG-poster mot en vad-ändrades/varför-bry-sig/hur-man-använder-rubrik, och vägrar att höja VERSION utan att fråga. Utlöses av 'update docs', 'documentation audit', 'sync documentation' eller en gren som är på väg att slås samman eller PR:as.

Testrapport

Körde båda passen på en verklig gren som levererade en --json-flagga och en TEXTKIT_TIMEOUT-miljövariabel till ett repo med avsiktligt inaktuella dokument. Färdighetens CHANGELOG-säljtest skrev om en commit-röst-post som aldrig nämnde den levererade flaggan till användarvänliga 'You can now'-rader och tog bort en intern bd-0412-tagg från läsarvänlig prosa; det obehjälpta passet lämnade den posten orörd och missade också den nya källfilen i CLAUDE.md-projektträdet. Den stannar och frågar innan VERSION höjs, ett beslut som baslinjen aldrig alls visade. Haken är Beads-integrationen som vävts genom fyra av dess steg: `bd create` returnerade 'no beads database found' i ett nytt repo, så budgetera `brew install beads` plus en per-repo `bd init` först. Dess diagramregel innebär också att ett ASCII-arkitekturdiagram som namnger en omdöpt klass flaggas, inte fixas.

Testad: 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

Kommandon och exempelprompter

  • /document-releaseNio-stegs dokumentgranskning efter leverans: fångar inaktuella README, CHANGELOG och TODOs

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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