Document Release

Neunstufiges Post-Ship-Dokumenten-Audit: fängt veraltete README, CHANGELOG und TODOs ab

von DollarDill · DollarDill/beads-superpowers

Funktioniert mit Setup ★ 8.8/10

Document Release — Neunstufiges Post-Ship-Dokumenten-Audit: fängt veraltete README, CHANGELOG und TODOs ab

Was es kann

Überprüft jede .md-Datei in einem Repo anhand des Diffs eines abgeschlossenen Feature-Branches, sodass README-Tabellen, ARCHITECTURE-Notizen, CLAUDE.md, CHANGELOG und TODOS mit dem tatsächlich Ausgelieferten übereinstimmen. Wendet selbst faktische Korrekturen an, bewertet CHANGELOG-Einträge nach einer Rubrik für 'was hat sich geändert/warum ist es wichtig/wie wird es verwendet' und weigert sich, die VERSION ohne Nachfrage zu erhöhen. Wird ausgelöst bei 'update docs', 'documentation audit', 'sync documentation' oder einem Branch, der kurz vor dem Merge oder PR steht.

Testbericht

Beide Durchläufe wurden an einem echten Branch ausgeführt, der ein --json-Flag und eine TEXTKIT_TIMEOUT-Umgebungsvariable in ein Repo mit absichtlich veralteten Dokumenten lieferte. Der CHANGELOG-Verkaufstest des Skills schrieb einen Commit-Voice-Eintrag, der das ausgelieferte Flag nie erwähnte, in benutzerorientierte 'You can now'-Zeilen um und entfernte ein internes bd-0412-Tag aus dem leserorientierten Text; der ununterstützte Durchlauf ließ diesen Eintrag unberührt und übersah auch die neue Quelldatei im CLAUDE.md-Projektbaum. Er stoppt und fragt, bevor die VERSION erhöht wird, eine Entscheidung, die die Baseline überhaupt nie ansprach. Der Haken ist die Beads-Integration, die durch vier seiner Schritte gewebt ist: `bd create` gab 'no beads database found' in einem frischen Repo zurück, also budgetieren Sie `brew install beads` plus ein pro-Repo `bd init` zuerst. Seine Diagrammregel bedeutet auch, dass ein ASCII-Architekturdiagramm, das eine umbenannte Klasse benennt, markiert, aber nicht behoben wird.

Getestet am: 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

Befehle & Beispiel-Prompts

  • /document-releaseNeunstufiges Post-Ship-Dokumenten-Audit: fängt veraltete README, CHANGELOG und TODOs ab

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • 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