Is your design system ready for agents?

The AI Readiness Score rates how reliably coding agents can find, understand and use your design system, from 0 to 100. Every point comes from your files, not a questionnaire.

Check your AI readiness Or start with a free DESIGN.md

Project

ACME DS

Sources

GitHub + Figma

Coverage

5 / 5

AI Readiness Score

59/100

Partially ready

01Agent context45
02Token integrity72
03Component discoverability58
04Design-to-code alignment51
05Validation readiness80

Five things decide how well agents build.

Each one is weighted by how much it changes what an agent ships.

01Agent contextAgents get clear instructions that don’t contradict each other.20%
02Token integrityColors, type and spacing have meaningful names and match across Figma and code.20%
03Component discoverabilityAgents can find the right component and know its props and variants.25%
04Design-to-code alignmentWhat’s in Figma maps to what’s in code.25%
05Validation readinessStories and tests let agents check their own work.10%

What your number means.

0-24
Not agent-ready
25-49
Early foundations
50-69
Partially ready
70-84
Agent-ready
85-100
Highly reliable

One source is enough to start.

Checks that need a source you haven’t connected are skipped, not failed. Coverage sits next to every score, so you always know what was measured.

Dimension	GitHub	Figma	Both
Agent context
Token integrity
Component discoverability
Design-to-code alignment
Validation readiness

Measured
Measured with a DESIGN.md
Not measured

Each finding tells you exactly what to change.

01What’s wrongIn plain language, with the evidence that caused it.
02Where it isThe file, line or Figma node.
03How sure Onefold isConfirmed, probable or unresolved.
04What to doOne change, and the points it wins back.

Finding

Button

Priority

High

Match

Probable

Button variants are not aligned

Variant	Figma	Code
default
secondary
destructive
ghost
outline
link

Add outline and link to Figma, or remove them from code.