Document Release

Devítikrokový audit dokumentace po vydání: zachycuje zastaralé README, CHANGELOG a TODOs

od DollarDill · DollarDill/beads-superpowers

Funguje s nastavením ★ 8.8/10

Document Release — Devítikrokový audit dokumentace po vydání: zachycuje zastaralé README, CHANGELOG a TODOs

Co umí

Audituje každý soubor .md v repozitáři proti diffu dokončené feature větve, takže tabulky README, poznámky ARCHITECTURE, CLAUDE.md, CHANGELOG a TODOS odpovídají tomu, co bylo skutečně dodáno. Sám aplikuje faktické korekce, hodnotí záznamy CHANGELOG podle rubriky co se změnilo/proč je to důležité/jak to použít a odmítá zvýšit VERSION bez dotazu. Spouští se na 'update docs', 'documentation audit', 'sync documentation' nebo na větvi, která se chystá být sloučena nebo PR'd.

Testovací report

Provedl jsem oba průchody na skutečné větvi, která dodala flag --json a proměnnou prostředí TEXTKIT_TIMEOUT do repozitáře s úmyslně zastaralou dokumentací. Test prodeje CHANGELOG dovednosti přepsal záznam ve stylu commitu, který nikdy nezmínil dodaný flag, na uživatelsky orientované řádky 'You can now' a odstranil interní tag bd-0412 z textu pro čtenáře; průchod bez pomoci ponechal tento záznam nedotčený a také minul nový zdrojový soubor ve stromu projektu CLAUDE.md. Zastaví se a zeptá se před zvýšením VERSION, což je rozhodnutí, které základní linie vůbec nenavrhla. Háček je v integraci Beads, propletené čtyřmi z jeho kroků: `bd create` vrátilo 'no beads database found' v novém repozitáři, takže nejprve počítejte s `brew install beads` plus `bd init` pro každý repozitář. Jeho pravidlo diagramu také znamená, že ASCII architektonický diagram pojmenovávající přejmenovanou třídu je označen, nikoli opraven.

Testováno: 2026-08-05 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /document-releaseDevítikrokový audit dokumentace po vydání: zachycuje zastaralé README, CHANGELOG a TODOs

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • 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