document-release

document-release

Catalogue généré le 2026-05-11

En une phrase

Met à jour automatiquement toute la documentation de ton projet (README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, CHANGELOG) après une livraison, pour que rien ne devienne obsolète sans qu'on s'en rende compte.

Quand l'utiliser

• Tu viens de faire /ship et tu veux synchroniser la doc avec ce qui vient de partir.
• Une PR est sur le point d'être mergée et tu veux que la doc reflète les changements avant le merge.
• Tu sens que ton README ou ton ARCHITECTURE.md a pris du retard sur le code.
• Tu veux polir la voix du CHANGELOG (le rendre orienté utilisateur plutôt que technique).
• Tu veux marquer comme terminés les éléments de ton TODOS.md qui sont effectivement faits.

Comment l'invoquer

• Slash command : /document-release
• Phrases déclencheurs (texte) : "update docs after ship", "document what changed", "post-ship docs", "update the docs", "sync documentation"
• Auto-invocation : ✅ Oui — Claude propose ce skill après un /ship réussi ou après le merge d'une PR.

Description détaillée

Le skill document-release tourne après que ton code soit commité (et idéalement après que la PR soit créée) mais avant qu'elle ne soit mergée. Sa mission : faire le tour de tous les fichiers de documentation du projet, les comparer au diff de la branche, et appliquer les corrections évidentes automatiquement. Les changements risqués ou subjectifs te sont posés en question.

Il fonctionne en plusieurs passes. D'abord, il analyse les commits de ta branche et classifie les changements (nouvelle feature, comportement modifié, suppression, infra). Ensuite, il fait l'audit fichier par fichier : pour chaque .md (README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, etc.), il vérifie que les exemples sont toujours valables, que les commandes listées existent encore, que la structure du projet décrite correspond bien à ce qu'il y a sur disque. Pour CONTRIBUTING.md, il fait même un "test de premier contributeur" : chaque commande d'installation est passée en revue comme si tu débarquais sur le projet.

Les corrections factuelles évidentes (paths, comptes, version numbers, items à ajouter dans un tableau) sont appliquées sans demander. Les changements narratifs (philosophie, sécurité, suppression de sections) ou les gros rewrites te sont soumis. Il polit aussi le CHANGELOG (sans jamais réécrire les entrées, juste polir la voix), marque les TODOS terminés, et te propose de bumper VERSION si nécessaire. Le but : qu'à chaque release, ta doc reste vivante et alignée sur ton code.

Source

• Plugin : gstack
• Nom interne : document-release
• Fichier : /home/thymon/.claude/skills/gstack/document-release/SKILL.md