Clementine DS

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 →


The pitch

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.

The 3-tier token cascade

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.

What's shipped

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

Sub-pages

Related