Briefatto LabBriefatto Lab

Questions

Design docs drift from the real design: how freeze stops it

A design doc drifts when nobody compares it with the pages it describes. board freeze records exact styles from a fresh render and validates the written guide against them, naming any conflicting style values.

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

What freeze checks

board freeze records source wording and exact styles from a fresh render in a generated DESIGN.md block, validates the authored guidance against those values and names conflicting style values.

Each freeze stamps a new numbered version and archives it. board diff v1 v2 shows what changed between versions.

When the site changes

Run board adopt . and board freeze . again: the guide is recorded from the new render and stamped as the next version.

Questions and answers

Should the design live in code instead of a document?

Both. Briefatto Board records exact styles from your rendered pages into the document, so the document is checked against what your code renders.

How do I see what changed between versions?

board log shows the history and board diff v1 v2 shows the change.

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/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE