| 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 |
| ADR-076 |
Branch protection on main/develop with 0 required approvals (solo maintainer) |
ActifActive |
2026-07-20 |
| ADR-077 |
Enable enforce_admins on main/develop (amends ADR-076) |
ActifActive |
2026-07-20 |
| ADR-078 |
Restrict Tokens Studio write access to the agentica/proposals branch |
ActifActive |
2026-07-20 (opened) — 2026-07-21 (closed as Active) |
| ADR-079 |
Weekly scheduled cloud agent for the Figma §22 full-library audit |
ActifActive |
2026-07-21 |
| ADR-080 |
Figma Community File content triage rule: brand identity stays private |
ActifActive |
2026-07-21 |
| ADR-081 |
Figma Community File license: CC BY 4.0 |
ActifActive |
2026-07-21 |
| ADR-082 |
Brand/logo separated into a dedicated Figma library file (amends ADR-080) |
ActifActive |
2026-07-21 |
| ADR-083 |
agtc-image implementation |
ActifActive |
2026-07-21 |
| ADR-084 |
Home page illustrations migrated to agtc-image directly, no agtc-illustration wrapper |
ActifActive |
2026-07-21 |
| ADR-085 |
audit-tokens.js debt triage: exclusions, audit-ignore escape hatch, 7 promoted tokens |
ActifActive |
2026-07-22 |
| ADR-086 |
Relationships registry and contract validation scripts (concepts borrowed from DSDS) |
ActifActive |
2026-07-22 |
| ADR-087 |
agtc-top-nav confirmed as "mix" architecture, dead mobile-menu code removed |
ActifActive |
2026-07-22 |
| ADR-088 |
Agentica logo colors formalized (retroactive) |
ActifActive |
2026-07-22 |
| ADR-089 |
audit-tokens.js debt reaches zero critical; real Radix dark primitives added |
ActifActive |
2026-07-22 |
| ADR-090 |
Consolidated Figma audit script, mandatory before ending any session that mutates the file |
ActifActive |
2026-07-23 |
| ADR-091 |
Per-variant stroke-width and default-color tokens for agtc-icon |
ActifActive |
2026-07-30 (values revised 2026-07-31 — see Revision note) |
| ADR-092 |
Safari :visited hex-fallback incident, consolidated record (amends ADR-047, ADR-059, ADR-060) |
ActifActive |
2026-08-28 |
| ADR-093 |
Accessible resting control boundary: new semantic token border.control |
ActifActive |
2026-09-09 |
| ADR-094 |
Min/max-width for single-line controls, and a reserved ceiling for a future textarea |
ActifActive |
2026-09-09 |
| ADR-095 |
Apache License 2.0 for the code; CC BY 4.0 remains the Figma Community File license |
ActifActive |
2026-09-11 |
| ADR-096 |
Semantic layout container-width tokens |
ActifActive |
2026-09-11 |
| ADR-097 |
Invocable skills live at .claude/skills/<name>/SKILL.md |
ActifActive |
2026-09-17 |
| ADR-098 |
primitive-direct hardened from warning to error in audit-tokens.js |
ActifActive |
2026-09-21 |
| ADR-099 |
Workstream version tracks the published package state, not an independent counter |
ActifActive |
2026-09-23 |
| ADR-100 |
The compliance badge renders a recorded audit verdict, never a configuration flag |
ActifActive |
2026-09-25 |
| ADR-101 |
The Playwright PR gate becomes a required check on main, scoped by path inside the job |
ActifActive |
2026-09-25 |
| ADR-102 |
Token annotation schema: $description plus two vendor namespaces in $extensions |
ActifActive |
2026-09-27 |
| ADR-103 |
Dark-mode elevation: a dark variant for every shadow, and a raised surface |
ActifActive |
2026-09-28 |
| ADR-104 |
Storybook without Chromatic: Playwright story snapshots and Storybook hosted with the site |
ActifActive |
2026-10-02 |
