---
title: "An agent-first design-system foundation"
url: /cases/agent-first-foundation
description: "Built for a banking software vendor. The agent never writes HTML; it fills a typed page spec, and scripts build and judge the page."
---

## §0 · problem

# An agent-first design-system foundation

**Level 4, partly 5 · 2026 · for a banking software vendor**

An agent asked to build a banking screen writes plausible HTML, invents values and drifts from the system. Reviewing that output costs more than writing it.

## §1 · built

### What was built

The agent never writes HTML. It writes a typed page spec. A script composes the page from vetted parts and returns a verdict. The agent selects and fills; scripts build and judge.

- Tokens in DTCG 2025.10, built with Terrazzo. About 1,618 token definitions in four tiers [claim case5-tokens: Own project, November 2026; source: author's project, internal; confirmed] 2 brands × 2 modes = 4 CSS permutations from one resolver [claim case5-permutations: Own project, November 2026; source: author's project, internal; confirmed]
- 41 components [claim case5-components: Own project; source: author's project, internal; confirmed] Fidelity pass over 34 components, 368 variants, 4,445 checks, 30 accepted deviations [claim case5-fidelity: Own project; source: author's project, internal; confirmed]
- 38 numbered decisions; the build fails when 'Enforced by' is empty [claim case5-decisions: Own project, mid-November 2026; source: author's project, internal; confirmed]
- An order of authority across the rule files.
- Skills that apply rules and never make them.
- A do-not list that names likely hallucinations with their replacements.
- A proposal path, so a missing part becomes a proposal and is not invented.
- A rule against invented content: no made-up money values or names. Invented content caused 5 of 21 defect fixes on an earlier project [claim case5-invented-content: Own project; source: author's project, internal; confirmed]

Built in two weeks [claim case5-duration: Own project, 2 to 16 November 2026; source: author's project, internal; confirmed]

## §2 · taught

### What it taught

Restructure the task so the error cannot happen. A typed spec removes whole classes of defect that review would only catch some of the time.

The design file is evidence. A reference page matched its design in 41 of 41 boxes; following the component masters, 29 of 41 [claim case5-reference-page: Own reference page. Cause: the design library existed in three copies that disagreed; source: author's project, internal; confirmed]

## §3 · open

### What is still open

These are the credibility. I show them.

- 11 of 25 planned rules not built [claim case5-open-rules: Own project, mid-November 2026. Verify on Thursday 19 November; source: author's project, internal; confirmed]
- Skills not yet wired to the agent [claim case5-open-skills: Own project, mid-November 2026; source: author's project, internal; confirmed]
- 15 proposals approved without review [claim case5-open-proposals: Own project, mid-November 2026; source: author's project, internal; confirmed]
