An agentic React design system. 3-tier tokens, machine-readable specs, built so AI agents (Claude, Cursor, MCP servers) can read the contract before writing code.
Mintlify docs → · Live Storybook → · GitHub → · agentic-spec CLI →
Most design systems ship a component library and a Storybook. Documentation drifts the moment the first PR lands. When an AI agent is asked to use the system, it has nothing concrete to anchor to — so it invents tokens, skips ARIA, picks the wrong variant.
Clementine adds a third artifact: a per-component spec with a closed contract. The contract is machine-readable. AI agents load it before writing code.
PRIMITIVES color.blue.6 = #2563eb radius.md = 8px
│
│ references
▼
SEMANTIC action.primary = {color.blue.6}
focus.ring = #ff8040
│
│ references
▼
COMPONENT button.bg.default = {action.primary}
button.border.focus = {focus.ring}
Each tier references only the tier above it. Components never reference primitives directly.
| Layer | Status |
|---|---|
| Workspace + tooling | pnpm + turborepo, Node 18+ · CI (validate/build/typecheck/size/a11y) · CodeQL · Dependabot |
| Tokens | 87 primitives · 32 semantic (Light + Dark) · 600+ component tokens, cascade-aliased |
| Components | 121 across 9 trays (UI staples · AI surfaces · enterprise · dates/charts/toast/carousel) — every one ships tokens + spec + story + guidance |
| Specs | 121/121 passing agentic-spec validate · 112 AI-Ready · avg health 78/100 |
| Patterns | 22 — form-field, action-bar, confirm-dialog, wizard + 16 agentic/governance patterns |
| Figma | 121/121 synced — 747 variables (628 component-tier, cascade-aliased, 1:1 with code) + rendered components across 7 category pages |
| Live surfaces | Storybook (Vercel) · Observatory dashboard (Vercel) · Mintlify docs · this Notion tree |