# How do you use DESIGN.md when vibe coding?

Updated 2026-11-21 · https://briefatto.com/guides/vibe-coding-design-md/

Freeze one DESIGN.md with Briefatto Board, and its block tells every vibe-coding session to read it before visual work, so the next prompt starts from the same brand as the first. `board check` then tests each rendered piece for clipped text, fonts that never loaded, low contrast and AI-design tells.

## Why vibe-coded UI drifts

Each session sees the prompt and the files its instructions name. With no design guide among them, every new page is a fresh guess at your brand, and the guesses wander.

Briefatto Board puts the guide on the list. The block it writes into AGENTS.md and CLAUDE.md tells the agent to read `DESIGN.md` before any visual work.

## Set it up once

1. Run `npx briefatto-board install` in your project.
2. Already have a site? Run `npx briefatto-board adopt .`, let your agent write DESIGN.md from the captures, then `npx briefatto-board freeze .` to stamp v1.
3. Starting fresh? Put the brief in `brief.md` and follow references, directions, pick, freeze. See [how to create a DESIGN.md](https://briefatto.com/guides/how-to-create-a-design-md/).
4. Keep prompting. Run `npx briefatto-board check .` on what comes out.

## What every prompt inherits

- **Your real styles.** Freeze records source wording and exact styles from a fresh render in a generated block of DESIGN.md.
- **The same pointer in every session.** The block in AGENTS.md and CLAUDE.md is the first thing the agent is told about design.
- **A floor under every piece.** `board check` fails clipped text, text off the canvas, overlapping text, small text, unloaded fonts and contrast below WCAG, and flags the anti-patterns found by the Impeccable detector.

## Questions and answers

### Do I have to write DESIGN.md myself?

No. Your agent writes it from captures of your site after `board adopt .`, or from the direction you pick for a new brand, and `board freeze` records the exact styles beside the prose.

### Which vibe-coding tools does it work with?

Briefatto Board works with any coding agent that reads AGENTS.md and runs shell commands, including Claude Code, Codex, Cursor, Copilot and Gemini CLI.

### Is Briefatto Board free?

Yes. It is open source under the Apache-2.0 licence and installs with `npx briefatto-board install`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)
- [Why do AI-built sites all look the same, and how do you fix it?](https://briefatto.com/guides/why-ai-built-sites-look-the-same/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
