Home / Companies / Vercel / Blog / Post Details
Content Deep Dive

How our agents build on-brand pages with design.md

Blog post from Vercel

Post Details
Company
Date Published
Author
John Phamous
Word Count
2,850
Company Posts That Month
17
Language
English
Hacker News Points
-
Post removed?
No
Summary

Vercel created design.md, a public file that gives coding agents design guidance outside its repositories, helping one-off reports, proposals, and pages retain the company’s typography, color, hierarchy, copywriting, responsiveness, and information architecture. Rather than directly publishing its internal product-design skill, Vercel rebuilt the guidance through fixed evaluation scenarios, discovering that prose alone was insufficient without concrete rules, reusable visual primitives, and iterative testing. The resulting system combines design.md for judgment and page composition, a public stylesheet with documented CSS classes and tokens that limits agents’ ability to invent inconsistent layouts, and an evaluation loop using human review alongside deterministic checks for mechanical failures. Across more than 200 runs, pages generated with design.md showed 57% fewer known checked failures than pages without it in a small test, although all outputs still required review and the measurement could not assess overall design quality. Vercel keeps the system current through feedback from its internal Slack design agent, GitHub reviews, and Figma comments, turning recurring issues into improvements to prompts, stylesheets, checks, or evaluation scenarios, while recommending that others begin with a single recurring artifact, a saved baseline, observable design corrections, and human-reviewed comparisons.

Trends Found in this Post

No tracked trend matches for this post yet.

Use This Data

Use this post, company, and trend context to find content marketing opportunities, perform competitive analysis, or address product feature gaps via the Plushcap MCP server or the Plushcap API.