Décisions architecturalesArchitecture Decision Records

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. A design system accumulates invisible decisions: why this token is named this way, why this variant was rejected, why this governance rule exists. This registry makes those decisions traceable and auditable.

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

Index des ADRsADR index

75 décisions actives. Un ADR ne se supprime jamais — on le marque remplacé ou déprécié. 75 active decisions. An ADR is never deleted — it is marked superseded or deprecated.

ADRTitreTitleStatutStatusDateDate
ADR-001 Three-Level Token Architecture ActifActive 2026-05-28
ADR-002 Choosing Lit for Web Components ActifActive 2026-05-28
ADR-003 Choosing Style Dictionary for token compilation ActifActive 2026-05-28
ADR-004 Human governance: the human always has the final word ActifActive 2026-05-28
ADR-005 Replacing the `danger` variant with `critical` ActifActive 2026-05-28
ADR-006 Choosing Chromatic for visual regression testing ActifActive 2026-05-28
ADR-007 Choosing axe-core for accessibility testing ActifActive 2026-05-28
ADR-008 Choosing Radix UI Colors for the primitive palette ActifActive 2026-05-28
ADR-009 Choosing Storybook for component documentation ActifActive 2026-05-28
ADR-010 Choosing Playwright for E2E and accessibility testing ActifActive 2026-05-28
ADR-011 Choosing Tokens Studio for Figma ↔ JSON synchronization ActifActive 2026-05-28
ADR-012 Drift detection via an audit script (audit-tokens.js) ActifActive 2026-05-28
ADR-013 DESIGN.md as a portable contract versioned with the code ActifActive 2026-05-28
ADR-014 Choosing Conventional Commits for commit messages ActifActive 2026-05-28
ADR-015 Automatic ADR reminder hook on critical modifications ActifActive 2026-05-28
ADR-016 Automatic kit construction log ActifActive 2026-05-28
ADR-017 Fixing the contrast of `text.disabled` and adding `background.hover` ActifActive 2026-05-29
ADR-018 Migrating semantic references to Radix notation ActifActive 2026-05-29
ADR-019 Dynamic token resolution in the build ActifActive 2026-05-29
ADR-020 4px grid as the systemic dimensional scale ActifActive 2026-05-29
ADR-021 Atkinson Hyperlegible as the primary typeface ActifActive 2026-05-29
ADR-022 Lucide Icons as the icon library ActifActive 2026-05-29
ADR-023 Typographic scale: rem Minor Third + line-height rules ActifActive 2026-05-29
ADR-024 Brand palette: Teal primary, Rose accent, Bordeaux secondary ActifActive 2026-05-29
ADR-025 Spacing density: floor/ceil on a 4px grid via math tokens ActifActive 2026-05-29
ADR-026 Figma synchronization strategy for custom brand palettes ActifActive 2026-05-29
ADR-027 Pre-commit impact pipeline with human approval ActifActive 2026-05-30
ADR-028 Atkinson Hyperlegible Mono as the monospace typeface ActifActive 2026-05-30
ADR-029 Modular pre-commit quality gate ActifActive 2026-05-30
ADR-030 Style Dictionary: multi-platform build with custom formats ActifActive 2026-05-30
ADR-031 agtc-button: Lit Web Component implementation ActifActive 2026-05-30
ADR-032 Storybook stories convention for Agentica components ActifActive 2026-05-30
ADR-033 `agtc-input` implementation ActifActive 2026-05-31
ADR-034 `agtc-badge` implementation ActifActive 2026-05-31
ADR-035 `agtc-card` implementation ActifActive 2026-05-31
ADR-036 Review of reference UX patterns before publishing a component ActifActive 2026-05-31
ADR-037 Implementing `agtc-checkbox` ActifActive 2026-06-01
ADR-038 Implementing `agtc-radio` and `agtc-radio-group` ActifActive 2026-06-01
ADR-039 Implementing `agtc-toggle` ActifActive 2026-06-01
ADR-040 Implementing `agtc-table` ActifActive 2026-06-03
ADR-041 Implementation of `agtc-code-block` ActifActive 2026-06-03
ADR-042 Implementation of `agtc-banner` ActifActive 2026-06-03
ADR-043 Implementation of `agtc-link` ActifActive 2026-06-04
ADR-044 Implementation of `agtc-segmented` ActifActive 2026-06-04
ADR-045 Completion of the `feedback` semantic color family ActifActive 2026-06-05
ADR-046 Inverse surfaces, shadows, and decorative tokens ActifActive 2026-06-05
ADR-047 System rule: no `:visited` state on navigation ActifActive 2026-06-05
ADR-048 Accessible interactive teal: `action.primary` teal.9 → teal.11 ActifActive 2026-06-05
ADR-049 Tokenizing the card's resting shadow: `semantic.shadow.card` ActifActive 2026-06-05
ADR-050 Compliant action teal on the real surface: teal.11 `#008573` → `#007a68` ActifActive 2026-06-06
ADR-051 Illustration style "Tactile Tech" + semantic palette `color.illustration` ActifActive 2026-06-06
ADR-052 Conformance to the W3C DTCG standard (Design Tokens Community Group) ActifActive 2026-06-06
ADR-053 Mobile navigation: sidebar as a sliding drawer and contextual button in the content ActifActive 2026-06-10
ADR-054 Responsive tables: systematic `overflow-x` wrapper ActifActive 2026-06-10
ADR-055 Systematic visible focus and i18n of interactive elements ActifActive 2026-06-10
ADR-056 Implementing `agtc-tabs` ActifActive 2026-06-12
ADR-057 Two usage contexts: Product (SaaS) and Marketing (Narrative) ActifActive 2026-06-12
ADR-058 Site redesign: dark theme and CSS extension tokens ActifActive 2026-06-12
ADR-059 Closing the 3-level hierarchy: intermediate semantic tokens ActifActive 2026-06-15
ADR-060 Implementing `agtc-top-nav` ActifActive 2026-06-15
ADR-061 `agtc-top-nav` v1.1: bilingualism, mobile shadow DOM, site integration ActifActive 2026-06-15
ADR-062 Single `agtc.js` bundle + Web Components dogfooding Phase 1 ActifActive 2026-06-15
ADR-063 `agtc-feature-card` component: editorial card V2 ActifActive 2026-06-25
ADR-064 V2 light mode: implementation and dark/light decoupling fix ActifActive 2026-06-25
ADR-065 Dual-mode dark mode: `semantic.dark.json` + Style Dictionary + Storybook/Chromatic ActifActive 2026-06-29
ADR-066 Playwright testing strategy: two distinct scopes ActifActive 2026-07-02
ADR-067 New token category: `letterSpacing` ActifActive 2026-07-08
ADR-068 Extending the `letterSpacing` scale: resolving the site's `--agtc-tracking-*` debt ActifActive 2026-07-08
ADR-069 Migrating project tracking to GitHub Projects ActifActive 2026-07-09
ADR-070 English as the repository's default language (community translation) ActifActive 2026-07-10
ADR-071 English as the sole language for all future content ActifActive 2026-07-14
ADR-072 Package architecture for npm publication: `@agentica/tokens` + `@agentica/components` ActifActive 2026-07-15
ADR-073 npm scope correction: `@agentica` → `@agentica-ds` (amends ADR-072) ActifActive 2026-07-16
ADR-074 Automated npm publishing via `changesets/action` in CI ActifActive 2026-07-17
ADR-075 Retroactive English filenames for translated documents (amends ADR-070) ActifActive 2026-07-18

Règles du registreRegistry rules

Contribuer à ce projet Contribute 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