Design System Spec

How to write a DESIGN.md that AI agents can read to generate UI consistent with your project's design system. Agents need more explicit specs than humans — no implicit knowledge, no "you know the style."

When to Use

• Starting a new project and want agents to generate on-brand UI from day one
• Existing project where agents produce inconsistent or generic-looking UI
• Onboarding a new agent to an established design system
• Design system evolves and spec needs updating

Don't use for:

• UI/UX design decisions (use interface-design)
• CSS implementation patterns (use css-best-practices)
• Component implementation (use react-best-practices or relevant framework skill)