ArchitectureArchitecture
Une seule source de vérité One single source of truth
Un même système de tokens en trois niveaux alimente les composants, la documentation, Figma, Storybook et les agents IA. Aucune divergence. Aucune interprétation libre. One three-level token system feeds components, documentation, Figma, Storybook and AI agents. No divergence. No free interpretation.
Niveau 1 — PrimitifsLevel 1 — Primitives
Les valeurs physiques brutes : couleurs, espacements, rayons, tailles de police. Jamais utilisés directement dans les composants. Toujours via un token sémantique.Raw physical values: colors, spacings, radius, font sizes. Never used directly in components. Always through a semantic token.
Niveau 2 — SémantiquesLevel 2 — Semantic
Les intentions UX : color.action.primary, space.control.padding. Ce que les agents doivent utiliser pour comprendre la fonction, pas la valeur brute.UX intentions: color.action.primary, space.control.padding. What agents must use to understand function, not raw value.
Niveau 3 — ComposantsLevel 3 — Components
Les contrats institutionnels : décisions comportementales spécifiques à chaque composant. Toute modification requiert une approbation humaine explicite.Institutional contracts: behavioral decisions specific to each component. Every change requires explicit human approval.
ADRs — Mémoire des décisionsADRs — Decision memory
Chaque décision d'architecture est documentée dans un ADR (Architecture Decision Record) : contexte, alternatives explorées, compromis acceptés. Rien ne disparaît.Every architecture decision is documented in an ADR (Architecture Decision Record): context, alternatives explored, trade-offs accepted. Nothing disappears.