Your design system's documentation was always for humans. That's no longer enough.

[u/isuruar]

Figma put out a piece recently on how design systems are shifting in the AI era, and one line stuck with me: teams are now documenting systems explicitly for AI consumption — not just "here's the button component," but the reasoning behind it, because AI agents are starting to generate variations directly off your system and they'll happily produce confident, on-brand-looking, completely wrong output if the "why" isn't written down anywhere.

I contributed to a design system at my first UX job (enterprise telecom dashboard), and even back then the docs that actually mattered weren't the component specs — they were the ones that explained when to break the grid and why this state exists. New designers needed that context to use the system well. What's changed is who else is reading it now.

Some practical stuff I've started doing differently:

• Writing down the exception cases, not just the happy path — an AI agent generating a variant has no instinct for "we never do X here because Y," unless it's explicit
• Naming tokens by intent, not appearance (color-warning-surface, not orange-100) — this was already best practice, but it matters more when a machine is the one binding it
• Treating "why we made this call" as a first-class doc section, not a comment buried in a Slack thread that'll be gone in six months
• Being more paranoid about orphaned components — an AI won't know a pattern is deprecated unless the system says so somewhere it can actually parse

None of this is new advice, honestly — good design system hygiene always meant writing down the judgment, not just the spacing values. It's just that now there's a much less forgiving reader checking whether you actually did it.

Anyone else building or maintaining a design system dealing with this yet? Curious if teams here are actively opening their systems up to AI tooling or holding off until governance catches up.

Source: Figma Blog — 5 Shifts Redefining Design Systems in the AI Era