01
A complete visual baseline
Document the design tokens agents need to create UI that belongs in the product, in light and dark, even when no matching component exists yet.
AI coding agents need more than a screenshot and a component name. Give them a compact, editable design brief with the exact rules that make a new interface feel like yours.
Create your DESIGN.md“Match our existing design” is useful direction for a designer who has seen the product. It is too vague for an agent working from a codebase, a ticket and a short prompt. It will fill every missing decision with its own conventions.
AI design guidelines work when they are specific enough to use and close enough to the code to be found. DESIGN.md holds the values and the judgment behind them in a format that humans can edit and coding agents can follow.
01
Document the design tokens agents need to create UI that belongs in the product, in light and dark, even when no matching component exists yet.
02
Record which component library and icon set agents must reuse, what must stay fixed, and what they should ask about instead of silently changing.
03
Set the tone for buttons, empty states and errors alongside the visual system, where an agent can use both together.
Start from your website, then settle the color, type, shape, depth and voice you want. Onefold turns the answers into values and short rules an agent can apply.
Save DESIGN.md with your repository instructions. It gives an agent design context before it writes a component, route or piece of product copy.
A good guideline does not pretend every choice has been made. Onefold marks the undecided parts so an agent can ask instead of guessing.