How to create a DESIGN.md from a website
Turn an existing product surface into a reusable AI-readable design brief.
Audit first
Capture screenshots, typography, spacing, color usage, key layouts, and component patterns from the live product.
Structure the file
Translate those observations into explicit rules, tokens, examples, and anti-patterns.
Validate with an agent
Ask Cursor or Claude Code to rebuild a page from the file alone and refine where the output drifts.
Have a public DESIGN.md?
Create an account and submit the source URL so it can be reviewed and indexed in the directory.
Submit DESIGN.md →