Compétence : Gouvernance
Maintenez la cohérence du système à mesure qu'il se développe. Appliquez les règles de versioning, de contribution et de dépréciation.
Étapes
- Lisez
workflows/governance.md(tableau SemVer, workflow de contribution, politique de dépréciation, communication des changements). - Classez le changement : majeur (rupture — token ou propriété renommé/supprimé, anatomie/valeur par défaut modifiée), mineur (ajout — nouveau token/composant/variante/propriété optionnelle), correctif (réparation — contraste/bogue/doc/ajustement de valeur dans la tolérance).
- Pour un nouveau composant/token : confirmez qu'il répond à un besoin réel et récurrent (≥ 2 occurrences) avant de promouvoir produit → candidat → cœur. Concevez-le selon la barre de qualité complète (
.claude/rules/components.md→ Barre de qualité des composants). - Pour une dépréciation : marquez avec la raison + le remplacement + le numéro de version de suppression ; maintenez-le fonctionnel pendant ≥ 1 cycle mineur ; fournissez un plan de migration (style
design-systems/crosswalk.md) ; supprimez uniquement lors d'une version majeure. - Rattachez tout nouveau fichier dans
CLAUDE.md(carte de référence des fichiers + tableau/routeur pertinent) et ajoutez une entrée dans le changelog.
Vérification (définition de fait)
- Le changement a un niveau SemVer et une entrée dans le changelog.
- Les suppressions ont une fenêtre de dépréciation, un remplacement et un tableau de migration.
- La nouvelle spécification répond à la barre des 8 états + accessibilité + mappage des tokens et est accessible via le routeur.
python3 scripts/validate_tokens.pyréussit ; le contraste est revérifié si les couleurs ont changé.