release-version

name: release-version description: "OBLIGATOIRE pour: commit, push, release, bump de version, CHANGELOG. Déclencheurs: « committer », « pousser le code », « release », « nouvelle version », git commit/push. NE PAS utiliser pour: écrire du code, modifier le backend, lire l'historique git."

Release & Versioning — RadioManager Modular

PRIMARY RESPONSIBILITY

Protocole unique de commit/release du frontend : classification conventionnelle des changements, bump semver, CHANGELOG.md, generate-versions, message de commit.

USE THIS SKILL WHEN

• L'utilisateur demande de committer, pousser, publier ou « faire une release ».
• Un bump de version ou une entrée CHANGELOG est nécessaire.
• Il faut décider si un changement est MAJOR / MINOR / PATCH / sans bump.

DO NOT USE THIS SKILL WHEN

• On écrit ou corrige du code (utiliser le skill du domaine concerné, committer après).
• Le commit vise le repo backend /Users/happi/App/API/FASTAPI/ (→ backend-fastapi, qui a son propre cycle).
• On consulte simplement l'historique git.

TRIGGERS

committer, commit, pousser, push, release, version, bump, changelog, publier.

OWNED DIRECTORIES

• package.json (champ version — source de vérité)
• CHANGELOG.md
• src/version* (fichiers générés par npm run generate-versions)

REQUIRED DEPENDENCIES

• npm run generate-versions (script du repo)
• npx tsc -b --noEmit (validation pré-commit)

OPTIONAL DEPENDENCIES

• Skill context-governance — si le commit modifie CLAUDE.md, AGENTS.md, des skills ou docs/reference/.

RELATED DOCUMENTATION

• VERSIONING.md (racine) — détail du pipeline generate-versions
• CHANGELOG.md — format Keep a Changelog existant

Protocole

1. Analyser et classifier

Lire git diff --staged et/ou git diff, puis classifier :

Décision : au moins un feat → MINOR ; des fix sans feat → PATCH ; sinon pas de bump. En cas de doute, demander. Ne JAMAIS sauter de version.

2. Si bump, exécuter dans l'ordre

1. Mettre à jour version dans package.json.
2. Ajouter la section CHANGELOG.md (date du jour ; sections parmi Ajoute, Corrige, Technique, Supprime).
3. npm run generate-versions.
4. Inclure package.json, CHANGELOG.md et les fichiers générés dans le commit.
5. Message : feat(version): release vX.Y.Z — description courte (ou fix(version): pour un PATCH).

3. Si pas de bump

Committer avec le message conventionnel adapté (docs(scope):, refactor(scope):…).

Vérifications finales

• npx tsc -b --noEmit passe.
• package.json et la dernière entrée CHANGELOG sont cohérents.
• Branche : develop.