Explainer
AI-powered design systems, and how AI actually uses design tokens
If an agent writes most of your interface, your design system stops being a document for humans and becomes an input to a machine. That changes what it has to contain.
A design system a model can read
The classic deliverable - a slide deck of logo clearances and mood photography - is invisible to a coding agent. It reads files.
Humans infer, models match
A designer looking at three screens infers a system. A model looking at three screens reproduces whichever pattern appears most often, including the mistakes.
Unspecified means average
Anything you leave undecided gets filled with the statistical middle of the training data: indigo, Inter, a 12px radius, a soft shadow. Not wrong - just not yours, and not anyone's.
Three layers
What an agent-readable system contains
Tokens alone are the common half-measure. The rules and their placement are what make the tokens hold.
- 01
Tokens - the values
Colour, type scale, spacing rhythm, radius, borders, focus states, as named custom properties in one file. This is the only layer most teams ship, and on its own it is not enough: it tells an agent what exists, not when to use which.
- 02
Rules - the intent
A short written spec: which surface pairs with which text, what carries emphasis, and an explicit list of what never to do. “No drop shadows, use 1px rules” prevents more drift than any number of tokens, because it forecloses the default the model would otherwise reach for.
- 03
Placement - where the agent looks
The same rules in the wrong location have no effect. A BRAND.md in the repository root, tool instruction files where the tool expects them, and the token file open while you work. Context the agent cannot see is context it does not have.
01 · Token
theme.cssWhat exists
- --paper-2: oklch(0.96 0.01 85);
- --rule: oklch(0.19 0.012 70 / 0.14);
- --radius-md: 6px;
Named values the agent can reference instead of inventing.
02 · Rule
BRAND.mdWhen to use it
- Panels sit on --paper-2.
- Separate with 1px --rule.
- Never: shadows, 12px radius.
Intent and prohibitions, so the default is foreclosed.
03 · Placement
repo rootWhere it is read
- /BRAND.md
- /src/styles/theme.css
- /.github/copilot-instructions.md
Context the agent cannot see is context it does not have.
Output
The agent writes a panel on --paper-2 with 1px rules and no shadow - because the value existed, the rule named when to use it, and both sat where the agent reads.
The same request, twice
What the agent sees decides what it writes
No token layer
"Add a settings panel that matches the app."
Matches what? The agent picks the nearest precedent it can find, and every panel after it inherits that guess.
With tokens and rules
"Add a settings panel. Tokens from theme.css only, rules in BRAND.md: paper-2 surface, 1px rules, radius-md, no shadows."
A right answer exists, is nameable, and is checkable in review - so the panel matches on the first pass instead of the third.
Common questions
- What is an AI-powered design system?
- Two different things share the name. One is a design system whose components were generated with AI help. The other - the useful one - is a design system built so that an AI agent can read and obey it: machine-readable tokens plus written rules, not a PDF of brand guidelines. Only the second kind changes what an agent produces.
- How do AI systems use design tokens?
- A coding agent has no eye. It pattern-matches against text it can see: the files in your repository, the files open in your editor, and the instructions in your prompt. Named tokens - --surface-paper, --radius-md, --font-display - give it a vocabulary with a right answer. Raw hex values give it a precedent to copy and vary. Tokens work on agents for the same reason they work on new hires: the name carries the intent.
- Do agents follow tokens reliably?
- More reliably than prose, less reliably than a compiler. An agent follows the strongest precedent it can see. If half the codebase uses tokens and half uses literals, it will produce both. Consistency comes from removing the competing precedent, not from asking more politely.
- Who builds AI-powered design systems for brands?
- Branding studios and design-system consultancies build them as bespoke projects, usually starting at agency prices and taking weeks. In-house design teams build them where one exists. Stylaform is the third option: you decide and lock the system yourself, and it exports the tokens and the written rules an agent can read.
- Does schema markup help AI systems find my brand?
- Schema markup describes your content to search engines and answer engines; it has nothing to do with how a coding agent styles a button. They are separate problems that happen to both involve machines reading structured data. This page is about the second one.
- Can design tokens control AI output?
- They constrain it rather than control it. A token removes the decision an agent would otherwise make by default: with --surface-paper defined and referenced everywhere, “add a panel” has an obvious answer, and the model takes it. What tokens cannot do is express intent - which of three defined surfaces belongs on a settings panel. That needs a written rule beside the token file.
- How should brand rules be represented for AI?
- As short, declarative, testable statements in plain Markdown, in the imperative. “Panels sit on --paper-2, separated by 1px --rule” works. “Our brand feels calm and considered” does not - there is nothing in it an agent can check its own output against. Include an explicit never list: prohibitions foreclose the model's defaults more reliably than positive guidance invites yours.
- How many brand rules does an agent actually follow?
- Fewer than you would like. Keep the file to roughly one page: surfaces, type scale, spacing, radius, borders, focus, and the prohibitions. Long documents get partially attended to, and the rules furthest from the top are the ones that get dropped. If a rule can be enforced in the token file or a lint rule instead of in prose, put it there.
- Do design tokens work across Cursor, Claude and Copilot?
- The tokens do, because they are just files in the repository. What differs is placement: each tool reads its own instruction file - .github/copilot-instructions.md, CLAUDE.md, .cursor/rules - and a BRAND.md alone reaches none of them reliably. Write the rules once and point each tool's instruction file at that file.
- What happens to the tokens when the brand changes?
- You change the token values and the rules that named them, and the interface follows on the next pass, because every component references the name rather than a copied hex value. This is the practical argument for tokens even in a one-person team: a rebrand becomes an edit to one file rather than a search across the codebase.
Where Stylaform fits
Explore a direction on a real interface, test it for contrast and accessibility, lock it, and export the two files an agent needs.
Tokens, not swatches
A named token set you can commit, so the agent has a vocabulary instead of a palette image.
A written BRAND.md
The intent and the prohibitions in the format tools already read from a repository root.
Stylaform produces the system; the coding tool you already use does the building. Claude, Copilot and Cursor are separate third-party products and are not affiliated with it.
Stop letting the prompt choose your brand.
Decide what your product should look like once. Give every human and AI developer the same rules from then on.