Briefatto LabBriefatto Lab

Questions

How do you use DESIGN.md when vibe coding?

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.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

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.
  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.

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. github.com/Briefatto/briefatto-board/blob/main/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE