Skip to content

AI-ready design systems, scored out of 8 and ranked

Reviewed

Quality and checks

A test set of prompts that shows how ready your design system is for agents

A test set is a fixed list of prompts, each with what must be true of the result, that you run through your agent every time the design system, its guidance or the model changes. Each prompt asks for real work, such as a settings screen, an empty state or a form with errors. Each answer is scored the same way: does it use your design tokens and components, follow the written rules and pass the checks? The total tells you whether a change made the agent better or worse, which one impressive screen never can.

Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board.

Why one good screen proves nothing

An agent can answer the same prompt differently each time. One run can produce a clean settings page and the next a gray that is not in your palette. Judging a design system, a rules file or a new model on one screen is judging the dice. A test set fixes the questions, so the only things that change between runs are the ones you changed. Anthropic’s own guide to evaluations makes the same case: success criteria that are specific and measurable, and test cases drawn from the tasks you actually run, edge cases included.

What goes in a test set for an AI-ready design system

Write prompts the way your team would ask, in 5 kinds:

  • Everyday screens. The pages and parts your team builds most often.
  • Choices the rules decide. A delete action, a form error, a primary and a secondary action side by side: places where your guidance says which variant to use.
  • Gaps. Something the system does not have. The right answer is built from existing parts, or a question back to you, not a new component.
  • Edge cases. Long names, empty lists, errors, dark theme, a narrow phone screen.
  • Temptations. Prompts that invite a raw value, such as “make the button bright orange”. A good agent says no, or finds the design token that comes closest.

How to score each answer

Give every prompt the same short list and the same points, 2 for a pass, 1 for part, 0 for a fail, as the ranking does for systems:

  • Design tokens only. A checker finds no color, size or font written by hand. The Simbolik Design System’s checker lists each one, and Stylelint’s color-no-hex rule flags hex colors in any CSS.
  • System components only. Nothing rebuilt that the system already has.
  • Rules followed. The specific lines of your guidance that the prompt tests.
  • Accessible. An automated check such as axe-core passes. Its makers say it finds about 57% of WCAG issues on average, so a person looks at the rest.
  • Looks like you. A person answers yes or no. A saved screenshot to compare against, as Playwright keeps, makes that answer quicker and steadier.

One test case, written down

Markdown
## T07: Delete a project

Prompt: "Add a way to delete a project from the project settings page."

Must be true:
- Button in its danger variant, confirmed in an alert dialog.
- The dialog names the project and says the deletion cannot be undone.
- The checker reports 0 values written by hand.
- Focus moves into the dialog, and back to the button when it closes (a person checks).

Score: 2 if every line holds, 1 if only the checker's line holds, 0 otherwise.

Run it after every change

Run the whole set when the design tokens change, when the guidance changes, when a component is added, and when the agent or its model gets a new version. Keep the same settings each time and record the totals by date. A drop after a change points at the change. A custom AI-ready system can ship with its own test set; Work with Simbolik (opens in a new tab) if yours should. To put the set to work on a real project, go on to a bounded pilot with an AI agent, and for the checks themselves to acceptance checks. The best AI-ready design systems, ranked is where the systems themselves are compared.

Questions & answers

Enough to cover the screens your team makes most and every rule you care about. Start small and add a prompt each time the agent gets something wrong in real work, so the set grows from your own failures rather than from guesses.

For some lines, yes. Anthropic’s guide to building evaluations covers grading by a model as well as exact checks. Use a script for anything a script can decide, a model for written criteria, and a person for whether the result looks like your product.

No. The score measures a design system from the outside, by what it publishes. A test set measures your agent using your system, which is the result you actually ship.

Sources for this entry

  1. Define success criteria and build evaluations, Anthropic (opens in a new tab)

    Specific, measurable success criteria, test cases that mirror real tasks and edge cases, and grading from exact checks to model-based grading.

    platform.claude.com, checked

  2. Check your site, Simbolik Design System (opens in a new tab)

    A checker that lists every value written by hand where a design token belongs and every component rebuilt by hand, with a report scripts can read.

    design.simbolik.ai, checked

  3. Stylelint, color-no-hex (opens in a new tab)

    A lint rule that flags hex colors written in CSS.

    stylelint.io, checked

  4. axe-core on GitHub (opens in a new tab)

    An accessibility checker that its makers say finds about 57% of WCAG issues automatically and marks the rest for manual review.

    github.com, checked

  5. Playwright, visual comparisons (opens in a new tab)

    Screenshots compared with a saved reference on every run.

    playwright.dev, checked

Continue this reading path

How the related websites connect

Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts.

Every related website

Cite this entry

Best AI-Ready Design Systems. “A test set of prompts that shows how ready your design system is for agents.” Reviewed . https://bestaireadydesignsystems.com/design-system-test-prompts-for-ai-agents/