Skip to main content

document-release

document-release

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

En une phrase

Post-shipMet à jour automatiquement toute la documentation update.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

  • UseTu whenviens askedde tofaire "update/ship theet docs",tu "syncveux documentation",synchroniser orla "post-shipdoc docs"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 (si exposé dans ton CLI)
  • Phrases déclencheurs (texte) : voir"update la description complète ci-dessous
Auto-invocation : ✅ Proactively suggestdocs after aship", PR is merged or code is shipped. (gstack)

Description complète

Post-ship documentation update. Reads all project docs, cross-references the diff, updates README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md to match"document what shipped,changed", polishes"post-ship CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION. Use when asked todocs", "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.), oril "post-shipvérifie docs".que Proactivelyles suggestexemples aftersont toujours valables, que les commandes listées existent encore, que la structure du projet décrite correspond bien à ce qu'il y a PRsur isdisque. merged or code is shipped. (gstack)

Pour aller plus loin

Preamble (run first)

Plan Mode Safe Operations

In plan mode, allowed because they inform the plan: $BCONTRIBUTING.md, $D,il codexfait exec/codexmême review, writes to ~/.gstack/, writes to the plan file, and open for generated artifacts.

Skill Invocation During Plan Mode

If the user invokes a skill in plan mode, the skill takes precedence over generic plan mode behavior. Treat the skill file as executable instructions, not reference. Follow it step by step starting from Step 0; the first AskUserQuestion is the workflow entering plan mode, not a violation of it. AskUserQuestion (any variant — mcp__*__AskUserQuestion or native; seeun "AskUserQuestiontest Formatde →premier Toolcontributeur" resolution"): satisfieschaque plancommande mode'sd'installation end-of-turnest requirement.passée Ifen norevue variantcomme issi callable,tu thedébarquais skillsur isle BLOCKED — stop and report BLOCKED — AskUserQuestion unavailable per the AskUserQuestion Format rule. At a STOP point, stop immediately. Do not continue the workflow or call ExitPlanMode there. Commands marked "PLAN MODE EXCEPTION — ALWAYS RUN" execute. Call ExitPlanMode only after the skill workflow completes, or if the user tells you to cancel the skill or leave plan mode.projet.

Les corrections factuelles évidentes (extraitpaths, —comptes, voirversion 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 SKILL.mdCHANGELOG complet(sans pourjamais réécrire les entrées, juste polir la suite)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
Back to top