
Techniques
Tommy Geoco

Your design system has two readers now
In this post
001. The version your agent reads
002. Live today on Dive Radio
Happy Thursday.
Every design system I keep now comes in two versions. There's a visual one I look at and a markdown one my agents read. If I need to change a token, I just type it.
I posted that on Monday with two predictions from conversations I've been having. The first is that designers will end up with their own personal design system and pull its refined components into every AI project. The second is that design teams will hire design engineers to help their cross-functional partners hit the quality bar with their agents.
I asked those of you on bigger teams what you're actually doing and seeing, and you answered. Ridd and I go through your answers live on Dive Radio today, and I'm showing you my own system too.
– Tommy (@designertom)
ON THE YOUTUBE CHANNEL

Design Tools Are Going Headless: Tom Krcha
Of the recent long-form interviews on my channel, Tom Krcha's comes closest to what this issue is about. Jamey Gannon on AI creative direction and George Hastings on building tools people pay for are up there too, and so are the Dive Radio replays.
The version your agent reads
Anthony Peres wrote that design systems "used to be for humans who sometimes ignored them," and now "they have to be for machines that read them every time."
I agree. When your agent's output looks generic, check your library before you blame the model.
You showed us how you're doing it:
Rico Oktananda built an email design system in layers. The foundation layer was his tokens for colors, typography, spacing and radius, primitives first and then the semantic ones his agent uses. Next came components, then written rules like keeping the brand color on buttons only. The agent built the templates, then more themes from the same foundations.
Kaelig Deloumeau-Prigent, a design engineer at Mercury, studied what about 20 open-source design systems are doing to work well with AI. His report has an MCP you can ask questions, and one Meta system in it runs a nightly eval to catch changes that make agent output worse.
The nightly eval is the same kind of test Cristian suggests below.
Lance Barrera co-leads Heart, GoFundMe's design system. Their playground repo has Heart installed and anyone can contribute, so people work with their agents on the actual components. He says his team now helps "teams and agents faithfully build with the design system."
That's close to my second prediction. On a big team, a person has to own whether everyone else's agents build with the real thing.
Cristian Morales Achiardi at Southleft says mechanical consistency is getting easier, and the open question is how much room to give the agent. He suggests testing a design rule by generating the same UI ten times without it and ten times with it, then comparing. The goal, he says, is "to make different decisions feel like they came from the same design language."
If your design system only has a version you look at, your agent is guessing.
So pick one rule your agent keeps breaking, like a color or a button it rebuilds every time. Write it into the file your agent reads, then run Cristian's test on it.
Lance also points out that when you join a company, you learn its system, because you can't bring yours along. That cuts against my first prediction, and I don't know yet where a personal system stops and a company's system starts.
Live today on Dive Radio

Ridd and I start at 1 PM Pacific.
We're back on last week's continued canvas fight, on what a canvas should be built on. I'm showing my own design system, we have a live portfolio review and the week's design system news, and we get into design systems for agents with your submissions, Brad Frost, and Krea's design system team, Daniel Petho and Aleksei Larionov.
Watch Dive Radio live at 1 PM PT →
STATE OF DESIGN JOBS SURVEY

Take the State of Design Jobs survey
Models change every week. Jobs change slower than that, and we would rather measure them than guess. If you do design work, tell us what it looks like right now.
With your help, we’ll be publishing the open report this November.
