The cascade
One system, built to hold together
A design system isn't a list of colors and button styles, it's an architecture. Every piece connects to the one above it: tokens feed components, components arrange into sections, sections assemble into full pages. Change something at the foundation, and everything built on top of it can follow, without needing to be rebuilt by hand. That's what makes a system maintainable long after launch, and what lets it scale alongside your team.
- {{ l.lead }}: {{ l.body }}
Why two token layers?
One says what it is. The other says what it’s for.
A primitive is a value: #150040, 16px, a font weight. It doesn't know where it's used or why. A semantic token takes that value and gives it a job: “surface-dark,” “text-on-light,” “spacing-lg.” That's context a primitive can never carry on its own.
This distinction matters even more once AI enters the picture. An AI reading raw values has to guess at intent: is this hex code the brand's primary color, an error state, or a one-off? A semantic token removes the guesswork: it tells an agent exactly what a value is for, not just what it is. That's a large part of what “agent-ready” actually means in practice, not a separate technology, just a naming layer that turns facts into instructions an AI agent can follow correctly.
Primitives — the raw values
The bottom of the cascade. A hex code, a pixel value, a font size: a fact, not a decision. Primitives don't carry meaning on their own; they're just what's available to build with.
Semantic tokens — the decisions
A semantic token points to a primitive and gives it a job: "surface-dark," "text-on-light." This is where meaning enters the system, and where a brand decision lives separately from the raw value behind it.
The agent contract
The knowledge layer that lets AI actually use your system
Most of what makes a design system usable never gets written down, it lives with your design team. Which pattern to reach for, when to bend a rule, what “on-brand” actually feels like is a judgment call. An AI can't access any of that unless it's captured somewhere it can read. This layer is the rules of the road: it tells an agent how to read your system and what to do with it, the same context that normally lives in your design team's heads, made available to machines.
What's inside it
What you’re actually getting
Every system we build looks a little different, the right setup depends on your brand, your team, and what you're already working with. This is a general idea of what tends to be in place, not a fixed checklist.
This is exactly why it isn't a click-of-a-button process. There's no one-size-fits-all template to drop in, what's actually needed shifts with the business, the team, and what already exists. The pieces below are a general shape, not a fixed order.
How it evolves
Not a one off quick fix, a new way to maintain your brand
A well-built system changes how your brand gets maintained going forward: update the foundation, and everything built on it updates too. Nobody has to hunt down every place it needs to change by hand.
That easy upkeep isn't just there for when something breaks. It grows with you as your brand naturally evolves.
What you can build
The real win: production without losing quality
This is the payoff everything else is building toward: your team using AI tooling to open up production, without losing what keeps the brand unique. Marketing can generate on-brand assets without waiting on design. Product can prototype without drifting off-pattern. Output scales without a bottleneck, and without a mess to clean up after.
That's what skills make possible: small, focused instructions that teach an AI how to use your specific system for a specific job (a landing-page builder, a deck builder, a marketing-asset generator), each one inheriting the same tokens, components, and brand rules instead of reinventing them.
This is also where the cost savings show up, concretely. An AI agent working from a connected system doesn't have to guess at your brand or have it explained in every request. It reads the structure once and gets it right. That means fewer tokens spent per request, higher first-pass accuracy, and less custom code getting generated and re-reviewed. Over dozens or hundreds of requests, that compounds: the foundation is what makes every use after it cheaper.