Décisions architecturales

Un design system accumule des décisions invisibles : pourquoi ce token est nommé ainsi, pourquoi cette variante a été rejetée, pourquoi cette règle de gouvernance est là. Ce registre rend ces décisions traçables et auditables.

Le système de design est devenu un dataset, pas un deliverable. — The Design System Guide, 2026

Index des ADRs

22 décisions actives. Un ADR ne se supprime jamais — on le marque remplacé ou déprécié.

ADRTitreStatutDate
ADR-001 Architecture 3 niveaux de tokens Actif 2026-05-28
ADR-002 Choix de Lit pour les Web Components Actif 2026-05-28
ADR-003 Choix de Style Dictionary pour la compilation des tokens Actif 2026-05-28
ADR-004 Gouvernance humaine : le dernier mot est toujours humain Actif 2026-05-28
ADR-005 Remplacement de la variante `danger` par `critical` Actif 2026-05-28
ADR-006 Choix de Chromatic pour les tests de régression visuelle Actif 2026-05-28
ADR-007 Choix de axe-core pour les tests d'accessibilité Actif 2026-05-28
ADR-008 Choix de Radix UI Colors pour la palette primitive Actif 2026-05-28
ADR-009 Choix de Storybook pour la documentation des composants Actif 2026-05-28
ADR-010 Choix de Playwright pour les tests E2E et d'accessibilité Actif 2026-05-28
ADR-011 Choix de Tokens Studio pour la synchronisation Figma ↔ JSON Actif 2026-05-28
ADR-012 Détection de dérive par script d'audit (audit-tokens.js) Actif 2026-05-28
ADR-013 DESIGN.md comme contrat portable versionné avec le code Actif 2026-05-28
ADR-014 Choix de Conventional Commits pour les messages de commit Actif 2026-05-28
ADR-015 Hook automatique de rappel ADR sur modifications critiques Actif 2026-05-28
ADR-016 Journal de construction automatique du kit Actif 2026-05-28
ADR-017 Correction du contraste de `text.disabled` et ajout de `background.hover` Actif 2026-05-29
ADR-018 Migration des références sémantiques vers la notation Radix Actif 2026-05-29
ADR-019 Résolution dynamique des tokens dans le build Actif 2026-05-29
ADR-020 Grille 4px comme échelle dimensionnelle systémique Actif 2026-05-29
ADR-021 Atkinson Hyperlegible comme police principale Actif 2026-05-29
ADR-022 Lucide Icons comme bibliothèque d'icônes Actif 2026-05-29

Règles du registre

Contribuer à ce projetContribute to this project Ce système est ouvert aux contributions — tokens, composants, décisions architecturales, corrections d'accessibilité ou documentation. Toute amélioration est bienvenue. This system welcomes contributions — tokens, components, architectural decisions, accessibility fixes, or documentation. Every improvement counts.
Voir sur GitHub → View on GitHub →