Design System Audit

A UI rarely looks accidental because any one screen is bad. It looks accidental because the values drift: nineteen greys that should be four, a radius per component, a shadow authored inline every time someone needed a card. Each decision was locally reasonable; the sum is incoherent.

This is measurable. Do not argue about it — count it.

The full audit is one call in the SaglitzDesign MCP (npx saglitzdesign-mcp): audit_design_system(code) returns a consistency score, the value counts per dimension, the near-duplicate colors with the survivor named, off-grid spacing, and token adoption. Then create_design_system, generate_color_system, generate_type_scale, generate_elevation_system and generate_layout_system produce the target scales, and design_lint catches regressions.

Method

1. Concatenate the real styles. Every stylesheet, theme file, and component with inline styles. Audit the whole surface at once — drift only shows up across files.
2. Count distinct values per dimension, then compare against a budget: