Document Release
Audit di documentazione post-rilascio in nove passaggi: rileva README, CHANGELOG e TODOs obsoleti
Richiede configurazione
Cosa fa
Audita ogni file .md in un repository confrontandolo con il diff di un ramo di funzionalità completato, in modo che le tabelle README, le note ARCHITECTURE, CLAUDE.md, CHANGELOG e TODOS corrispondano a quanto effettivamente rilasciato. Applica autonomamente le correzioni fattuali, valuta le voci CHANGELOG rispetto a una rubrica "cosa è cambiato/perché è importante/come usarlo" e si rifiuta di incrementare la VERSION senza chiedere. Si attiva su 'update docs', 'documentation audit', 'sync documentation' o su un ramo in procinto di essere unito o sottoposto a PR.
Rapporto di test
Eseguiti entrambi i passaggi su un ramo reale che ha rilasciato un flag --json e una variabile d'ambiente TEXTKIT_TIMEOUT in un repository con documentazione deliberatamente obsoleta. Il "sell-test" del CHANGELOG della skill ha riscritto una voce in stile commit che non menzionava mai il flag rilasciato in righe 'You can now' rivolte all'utente e ha rimosso un tag interno bd-0412 dalla prosa rivolta al lettore; il passaggio senza aiuto ha lasciato quella voce intatta e ha anche mancato il nuovo file sorgente nell'albero del progetto CLAUDE.md. Si ferma e chiede prima di incrementare la VERSION, una decisione che la baseline non ha mai evidenziato. Il problema è l'integrazione di Beads intrecciata in quattro dei suoi passaggi: `bd create` ha restituito 'no beads database found' in un repository fresco, quindi prevedere prima `brew install beads` più un `bd init` per ogni repository. La sua regola sui diagrammi significa anche che un diagramma di architettura ASCII che nomina una classe rinominata viene segnalato, non corretto.
Testato il: 2026-08-05 · Claude Code 2.x (agent harness)
Installazione
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
Comandi e prompt di esempio
/document-releaseAudit di documentazione post-rilascio in nove passaggi: rileva README, CHANGELOG e TODOs obsoleti
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
This branch is done, update the docs before I open the PRRun a documentation audit against this feature branchSync the README and CHANGELOG with what we actually shipped