Series
AI-ready design system: a machine-readable source of truth
Tokens, specs, and docs that an AI coding tool can read every session, without replacing the system you already ship.
An AI-ready design system is a project's source of truth structured so AI coding tools and people read the same conventions every session. It keeps the visual system humans already use and adds machine-readable artifacts (token files, component specs, and docs) that survive the context window resetting. It is not a new component library to install. You do not have to rewrite the system you ship: audit what is already in the repo, then add the structured layer beside it. This series is the map: how to structure it, the five tiers, the audit, tokens, specs, what to do when the code disagrees, and how that pattern becomes a Claude Code skill.
Francois Brill
Designer + Builder
Oct 4, 2026
Last updated

Which article to read first
If a coding agent is drifting off-brand, you do not need a new component kit. You need the system you already ship to be readable by Cursor, Claude, and other LLMs.
Start with how we structure design systems for AI if you want the definition and the failure mode: stateless sessions that infer tokens from nearby code. Jump to the five-tier structure for the folder itself (foundations, tokens, atoms, molecules, organisms). Use the design system audit when the repo already has components. Design tokens for Tailwind v4 is the runtime wiring. Component specs are the contract an LLM can follow without re-reading the file. When the design system and the code disagree is the reconciliation. The Claude Code skill is how the pattern loads without stuffing CLAUDE.md.
DESIGN.md is the editorial vocabulary at the root of that folder, not a substitute for the folder. Claude Code design skills is the installable skill write-up. Generate design specs from code is the reverse-specs workflow when the frontend already ships. AI UI brand governance is the process after the file exists: stop reactive per-output fixes, install a root system, then choose scaffold, audit, or partner. designgov.md is the governance contract above DESIGN.md: behavior, accessibility tiers, and multi-brand rules agents must not violate. None of those pages is this series. Use them when you already know the job and need the adjacent artifact.
What this hub is not
This hub is not a component library to install, a Figma styleguide pitch, or a DESIGN.md tutorial. It is not a design-system-audit offer. You keep shipping the components you have. You add a parallel structured layer (tokens, spec stubs, docs) so a machine-readable design system for an LLM is sitting next to the visual system your team already uses.
Articles in this series 7

AI-ready design systems: structure tokens, specs, and docs so AI stays on-brand
What question it answers: how to structure a design system so AI coding tools read the same conventions every session.

How to structure a design system in five tiers (tokens → skills)
What question it answers: the five-tier map (foundations, tokens, atoms, molecules, organisms).

How to audit a design system before you rebuild (or feed it to AI)
What question it answers: how to audit the system you already ship before you scaffold anything.

Tailwind v4 semantic design tokens + WCAG contrast for Next.js (2026)
What question it answers: how to wire design tokens for Tailwind v4, including semantic colors and WCAG contrast.

Component specifications AI tools can implement without guessing
What question it answers: how to write component specs an LLM can use without re-reading the implementation.

When design system tokens and live code disagree: how to reconcile
What question it answers: what to do when the design system and the code disagree.

Create a Claude Code skill for your design system (tokens + Taste Profile)
What question it answers: how the pattern becomes a reusable Claude Code skill (audit, plan, confirm, scaffold).
Related guides
DESIGN.md and Taste Profile
The editorial contract at the root of the folder. Not a substitute for tokens, specs, or the five-tier map.
Claude Code design skills
How this series becomes a SKILL.md you install once and run across repos.
Generate design specs from code
Reverse-specs: read the frontend you already ship, write DESIGN.md, then decide DIY extract vs audit.
AI UI brand governance
Stop reactive per-output brand fixes. The Taste Profile plus AI-ready folder is the root system, plus scaffold vs audit vs partner.
designgov.md
The governance contract above DESIGN.md: behavior, accessibility tiers, and multi-brand rules agents must not violate.