Cohérence des tokensToken consistency
Protéger l'intégrité du système de tokens sur les trois niveaux — primitif → sémantique → composant — en détectant toute violation avant le commit.Protect token system integrity across three levels — primitive → semantic → component — by detecting any violation before the commit.
Flux du pipelinePipeline flow
01 · Déclencheur01 · Trigger
Fichiers tokens ou composants modifiésToken or component files modified
tokens/*.json · components/*.js · site/build.js · guidelines/tokens/*.json · components/*.js · site/build.js · guidelines/
02 · Contrôles02 · Checks
6 vérifications automatisées6 automated checks
Valeurs hex · Tailles px · font-family en dur · Références fantômes · Tokens orphelins · Grille 4px · Échelle Minor Third · Gouvernance composantsHex values · px sizes · hardcoded font-family · Phantom refs · Orphaned tokens · 4px grid · Minor Third scale · Component governance
03 · Résultat03 · Outcome
Commit bloqué ou validéCommit blocked or cleared
exit 1 sur violation critique → commit bloqué. exit 0 → commit autorisé. Tokens orphelins signalés sans blocage.exit 1 on critical violation → commit blocked. exit 0 → commit cleared. Orphaned tokens flagged without blocking.
Valeur métierBusiness value
Zéro dérive silencieuse. Chaque valeur hex ou pixel codé en dur est détecté et bloqué avant d'atteindre le dépôt. L'intégrité du système de tokens est une garantie structurelle, pas une convention.Zero silent drift. Every hardcoded hex or pixel is detected and blocked before reaching the repository. Token system integrity is a structural guarantee, not a convention.
Matrice de déclenchementTrigger matrix
| Fichier modifiéChanged file | ActionAction |
|---|---|
tokens/primitives.json | Oui — vérification complèteYes — full check |
tokens/semantic.json | Oui — vérification complèteYes — full check |
tokens/component.json | Oui — approbation Principal Designer requiseYes — Principal Designer approval required |
site/build.js | Oui — vérification valeurs hardcodéesYes — check for hardcoded values |
components/*.js | Oui — vérification tokens de composantYes — check component tokens |
ContrôlesChecks
- Aucune valeur hex (#RRGGBB) dans components/ ou site/build.jsNo hex value (#RRGGBB) in components/ or site/build.js
- Aucun font-size en px codé en dur dans site/build.jsNo hardcoded font-size in px in site/build.js
- Aucun font-family en dur (hors var())No hardcoded font-family (outside var())
- Toutes les références {primitive.X.Y} résolues dans primitives.jsonAll {primitive.X.Y} references resolved in primitives.json
- Tous les var(--agtc-semantic-…) résolus dans semantic.jsonAll var(--agtc-semantic-…) resolved in semantic.json
- Tout token d'espacement = multiple de 4px (ADR-020)Every spacing token = multiple of 4px (ADR-020)
- Font-sizes sur l'échelle Minor Third uniquement (ADR-023)Font-sizes on Minor Third scale only (ADR-023)
- Toute modification de component.json → approbation Principal DesignerAny component.json change → Principal Designer approval required
CommandeCommand
node scripts/audit-tokens.js --ci
# exit 1 si violations critiques
# exit 0 si propre (warnings tolérés)