# design-system.ai > A practitioner's site by Pavol Hudran about design systems that AI agents can read and obey. Every page has a Markdown twin at the same address plus .md. Every figure is a claim with a base, a source, a date and a confidence level, served in https://design-system.ai/claims.json. ## Start here - [design-system.ai](https://design-system.ai/index.md): Design systems that AI agents can read and obey. The method from five design systems over fifteen years, with the rules, the checks and the gaps in public. - [The ladder](https://design-system.ai/ladder.md): A five-level maturity ladder for design systems in the agent era, with a five-question self-assessment that runs in your browser and stores nothing. - [Decisions](https://design-system.ai/decisions.md): The numbered decisions this site follows, with the check that enforces each one. Rules that nothing checks yet are marked as gaps. - [AI-augmented Design System: from tokens to autonomous agents](https://design-system.ai/talk/techmeetup-2026.md): Slides, sources and four steps to start from Pavol Hudran's talk at TechMeetup Conference, Ostrava, 20 November 2026. ## Patterns - [Enforced by](https://design-system.ai/patterns/enforced-by.md): A decision counts when something checks it. An unchecked rule is a known gap, not coverage. - [Authority order](https://design-system.ai/patterns/authority-order.md): When two files disagree, a declared rank decides. - [Skills apply rules](https://design-system.ai/patterns/skills-apply-rules.md): A skill that disagrees with the rule book is a defect in the skill. - [Deterministic first](https://design-system.ai/patterns/deterministic-first.md): Code checks first. Model judgment comes second and is advisory. - [Evidence, not authority](https://design-system.ai/patterns/evidence-not-authority.md): A design file or a prototype is evidence. The system is the authority. - [Typed spec, not free HTML](https://design-system.ai/patterns/typed-spec.md): Restructure the task so the error cannot happen. - [Do-not list](https://design-system.ai/patterns/do-not-list.md): Name the hallucination and give its replacement. - [Proposal path](https://design-system.ai/patterns/proposal-path.md): A missing part becomes a proposal. It is never invented. - [Report, do not block](https://design-system.ai/patterns/report-do-not-block.md): A validator reports and routes. It does not gate the agent on uncertain findings. - [Honest gaps](https://design-system.ai/patterns/honest-gaps.md): Write "not enforced", "n/a" or "to be filled". Never fill a gap with a plausible value. ## Case studies - [One ordering system in three countries](https://design-system.ai/cases/one-system-three-countries.md): M-Objednávka, a B2B ordering system for Makro Cash & Carry in Czechia and for METRO in Slovakia and Ukraine. One front-end code base, three build targets. - [Two brands from one code base](https://design-system.ai/cases/two-brands-one-code-base.md): After a merger, ČP Invest and Generali Investments needed two investment sites at once. Both came from one graphic framework, with brand as a parameter. - [Tokens as a product](https://design-system.ai/cases/tokens-as-a-product.md): At Notino, tokens moved between the design tool and code in both directions, automatically, and shipped as versioned packages for many internal teams. - [A design validator for a banking app](https://design-system.ai/cases/validator-for-a-banking-app.md): A deterministic validator that finds whether a UI bug comes from the implementation, an inconsistent design file or the analysis. It reports and routes; it never blocks. - [An agent-first design-system foundation](https://design-system.ai/cases/agent-first-foundation.md): Built for a banking software vendor. The agent never writes HTML; it fills a typed page spec, and scripts build and judge the page. - [Governance for a team of two](https://design-system.ai/cases/governance-for-two.md): A B2B car-loan platform front end built by two people with no designer. Vendored shadcn/ui, one skin file, and numbered decisions that each name a lint or a test. ## Data - [Claims](https://design-system.ai/claims.json): every figure with base, source, date, confidence - [Decisions](https://design-system.ai/decisions.json): the register - [Tokens](https://design-system.ai/tokens/): DTCG 2025.10 token files and the resolver - [AGENTS.md](https://design-system.ai/AGENTS.md): the rules an agent follows when it writes for this site ## Optional - [The Living Design System](https://design-system.ai/living-design-system.md): A white paper by Pavol Hudran. Agents obey only what is written and enforced, and no framework says which design-system rule wins or what proves it. What the framework needs, and an invitation to build it. - [Glossary](https://design-system.ai/glossary.md): The words that design-system.ai uses, in plain language: agent, design token, MCP, skill, Enforced by and more. - [Vision](https://design-system.ai/vision.md): Where AI design systems are heading, and how one should work. Five shifts already under way, the target loop from decision to check, and my bets, marked as judgment. - [Today against demo](https://design-system.ai/today-against-demo.md): What works today without a vendor, and what is still a demo. Every row has a "last verified" date; rows older than 90 days are marked stale. - [Open source](https://design-system.ai/open-source.md): Voice and Tone, an open-source Claude plugin that turns a brand voice guide into rules an agent can follow and a reviewer can check. - [Accessibility](https://design-system.ai/accessibility.md): The target is WCAG 2.2 AA. This page lists what a check measures today and what nothing measures yet. - [Privacy](https://design-system.ai/privacy.md): This site sets no cookies and makes no third-party requests. The contact form saves to the site's admin only. - [The layer underneath](https://design-system.ai/layer-underneath.md): DTCG 2025.10, Terrazzo, Basecoat UI and shadcn/ui: free, open parts for levels 1 and 2 that work without a language model. - [Voice and tone](https://design-system.ai/voice-and-tone.md): Voice and Tone, my open-source plugin for Claude Code that turns a voice guide into rules an agent can follow, and the rules it made for this site. - [How this site was built](https://design-system.ai/how-this-site-was-built.md): The eleven-step pipeline (plus the slides) that built this site, what each step produced, the numbers recorded during the build, and what could not be built honestly. - [About](https://design-system.ai/about.md): Pavol Hudran builds design systems that AI agents can read and obey. Before that, co-owner of Deriva, Notino's design-system team and Vivido. - [The industry map, November 2026](https://design-system.ai/notes/2026-11-16-industry-map.md): Where design systems and AI agents stand in November 2026, with every figure sourced and every forecast marked as a judgment.