A design team is restructuring its design system documentation—splitting it into layered Markdown files so AI agents can reason over it instead of just generating "almost right" interfaces. AI-generated frontend code from Figma looked impressive but consistently missed subtle rules like hover states, spacing tokens, and button hierarchy. The proposed approach separates Authoring (Figma), Specification (interconnected Markdown files agents can navigate), and Delivery (versioned packages, with agents proposing pull requests for engineer review rather than pushing changes directly).