Briefatto LabBriefatto Lab

Drift test · Claude Code and Codex

Does a DESIGN.md keep your brand? We measured the drift

Yes: any DESIGN.md does, and no file does not. In an empty repo where the brand could travel only by file, Claude Code and Codex matched the brand's fonts in 0 of 18 pieces without a design file and in 53 of 54 with one, and their colours stopped drifting between sessions.

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

The result

0 of 18
pieces matched the brand's fonts with no design file.
53 of 54
pieces matched them with a DESIGN.md, in any of three formats.
0.40 or less
session-to-session palette drift (ΔE2000) with any DESIGN.md, against 1.7 to 12.3 without one.

Without a file, the agent invents a brand every session. The palette moved by 1.7 to 12.3 CIEDE2000 between sessions, and as little as 31% of a piece's paint came from the brand's colours. With a DESIGN.md the drift fell to 0.40 or less, below the 1.0 where a difference starts to be visible, and brand colours covered 99% of every piece. Without one, 12.3 is a different colour.

SetupBrand fonts matchedBrand colour coverageSession-to-session drift (ΔE2000)
A. No design file0 of 1831% to 97%1.7 to 12.3
B. awesome-design-md style18 of 1899%0.02 to 0.23
C. Google design.md spec17 of 1899%0.12 to 0.40
D. Briefatto Board18 of 1899%0.05 to 0.31

Raw numbers per piece: drift-test-results.csv.

Every session, side by side

Each row is one setup; each column is a fresh session that never saw the others. Look at row A, then at the three rows below it.

Instagram post Row A: no design file. B: awesome-design-md style. C: Google design.md spec. D: Briefatto Board.

The file is the protocol

A coding agent starts every session from zero. Give it a brief and no design file, and it draws a good page and a different brand each time: a dark green card in the first session, a violet one in the second, an orange one in the third. Row A in every sheet is that slot machine.

An agent has no memory between sessions; the design file is its memory. That makes the file a protocol, not a style guide: once it is in the repo, Claude Code and Codex land on the same fonts and the same colours, session after session. The format mattered less than having the file.

Writing the file is the easy part. Keeping it true is the job. Briefatto Board builds it from your live site with every colour, font and radius measured from a real render, stamps it with a version and checks every piece the agent renders against it. When the brand changes, board status names every piece that is now stale.

Method

What was fixed
BrandIssue Composer, an MIT open-source tool, pinned at commit 151bb54; its live page is the ground truth for colours and fonts
SettingEvery session started in a new, empty git repository holding only the setup's design file: no site source, no screenshots, no web access to the site
SetupsA: no file. B: a DESIGN.md in the awesome-design-md style. C: a DESIGN.md to Google's design.md spec, lint-clean. D: the DESIGN.md and skill Briefatto Board produced from the site
AgentsCodex on gpt-6.2-sol and Claude Code on Claude Sonnet 5.5, three fresh sessions per setup each, three requests per session: 18 pieces per setup
RequestsA 1200x630 social card, a 1440x900 landing-page section and a 1080x1080 Instagram post for one invented release
ScoringBy program, on the final renders: share of painted pixels within ΔE2000 5 of the site's palette, computed font families against the site's, and mean pairwise palette distance between sessions. No judges
Date2026-11-21

Questions and answers

Does Claude Code keep my brand without a DESIGN.md?

Not across sessions. With no design file, Claude Code and Codex matched the brand's fonts in 0 of 18 pieces and their palette drifted 1.7 to 12.3 ΔE2000 from one session to the next.

Which DESIGN.md format should I use?

Any of the three. All held the fonts in 17 or 18 of 18 pieces and kept drift at 0.40 or less; having the file is what counts. Briefatto Board writes one from your site with measured values, versions it and checks every rendered piece against it.

How do I get a DESIGN.md for my site?

Run npx briefatto-board install, then ask your agent to adopt your site. Board captures the pages, the agent writes the guide, and board freeze measures and stamps it as version one.

Can I check the numbers?

Yes. The site is public and pinned, the per-piece numbers are in the CSV, and every session's pieces are in the sheets on this page.

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. en.wikipedia.org/wiki/Color_difference#CIEDE2000 checked 2026-11-21
  2. github.com/Briefatto/briefatto-board/blob/main/README.md
  3. github.com/Briefatto/briefatto-board/blob/main/LICENSE