A rule the session can lose, a check it cannot
A line in CLAUDE.md is an instruction. board check is a program that runs on the rendered page, writes a receipt of which checks ran and fails the piece with exit status 1. It gives the same answer on the first turn and the hundredth.
Keep the instruction short
After board freeze, the Briefatto Board block in CLAUDE.md and AGENTS.md reads:
<!-- briefatto-board:start -->
Read `DESIGN.md` before any visual work.
Brand changes go through `board freeze`.
Run `board check` on every piece before handing it over.
<!-- briefatto-board:end -->The brand itself lives in DESIGN.md, so the file that loads in every session stays small.
Gates you can rerun at any turn
board check . <piece.html>fails clipped text, text off the canvas, overlapping text, small text, unloaded fonts and contrast below WCAG.- On a frozen board, the same check notes every colour and font that is not in the current guide.
board statuslists which pieces are current, stale or unrecorded, from the guide version each piece declares.
Questions and answers
Why does Claude Code stop following CLAUDE.md in long sessions?
A rule in context is a request. Briefatto Board adds a program that tests the rendered piece, so a skipped rule shows up in the result.
Can the agent run the check itself?
Yes. The block tells it to run board check on every piece before handing it over, and the exit status tells it whether the piece passed.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.