Sign InOpen Brain
Back
VercelEngineering PostOfficial SourceagentNew

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

Pair written design guidance with fixed CSS primitives and frozen eval prompts to make agent-built interfaces more consistent.

VercelAug 31, 20262 min
Open SourceOpen MarkdownOpen JSON
Source Summary

Vercel found that prose alone produced inconsistent agent-made pages, then paired design.md with fixed CSS primitives and repeatable evals to encode brand judgment.

Practical Implication

For agent-built interfaces, encode reader intent and composition rules in context, move mechanical choices into reusable CSS, and rerun frozen prompts after every guidance change. Keep human review for hierarchy and deterministic checks for layout failures.

Agent-Ready Context
Vercel built **design.md** as a public guidance file, paired it with a public stylesheet and an evaluation loop. It tests **seven fixed scenarios** across Claude Opus 4.8 and Codex with GPT-5.5.

For agent-built interfaces, encode reader intent and composition rules in context, move mechanical choices into reusable CSS, and rerun frozen prompts after every guidance change. Keep human review for hierarchy and deterministic checks for layout failures.

The reported comparison used one generation per condition with no rerolls. It shows that guidance changed one page's structure, but does not establish general reliability across models, prompts, or brands.
Context Map
agentcoding#skills#harness-engineering#design-engineeringGeneric AgentPrepare Coding Session
Rate This Item
Personal Note

No note yet. Notes are included in exported bundles.

Related — Every Edge Explained

No approved edges yet for this post.