Briefatto LabBriefatto Lab

Questions

What does DESIGN.md solve when AI-generated UI keeps drifting?

DESIGN.md gives every session one current answer to what the brand looks like. Briefatto Board makes that answer exact and versioned: freeze records styles from a fresh render, each piece declares the version it was made under, and board status lists what is stale.

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

Where the drift comes from

Each session rebuilds the brand from whatever it can see. With no single current guide, small differences in colour, type and spacing add up from page to page.

How Board pins it

  • One current guide. board freeze stamps DESIGN.md as v1, v2 and on, and the block in AGENTS.md and CLAUDE.md tells every session to read it first.
  • Exact values. Freeze records source wording and exact styles from a fresh render, so the guide matches the rendered pages when it is frozen.
  • A version on every piece. Each final layout carries a board-version meta tag, and board status lists which pieces are current, stale or unrecorded.
  • A history. board log shows the versions and board diff v1 v2 shows what changed.

Catch drift on a single piece

On a frozen board, board check notes every painted colour and font that is not in the current guide, and names the earlier version a value came from.

Questions and answers

Is a DESIGN.md file enough on its own?

It is the centre. Briefatto Board makes it hold with the version stamp, the pointer every session reads and a check on the rendered output.

What happens when the brand changes?

Freeze the next version with a note, and board status lists the pieces still made under the old one. See change a colour in DESIGN.md.

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/CHANGELOG.md
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  4. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  5. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  6. github.com/Briefatto/briefatto-board/blob/main/LICENSE