Architecture Decision Records (ADRs) belong in design systems alongside tokens¶
Insight: Design tokens document the "what" of design decisions, but ADRs document the "why" — the rationale behind design choices. By adopting Architecture Decision Records, teams can ensure clarity and consistency, preserving essential reasoning for future reference and collaboration. This is especially important as AI tools need not just values but the reasoning context behind those values.