Briefatto LabBriefatto Lab

Questions

Claude Code forgets your CLAUDE.md design rules mid-session: what to do

Check the output instead of trusting the session's memory: board check renders each piece and sets exit status 1 when it fails, however long the session has run. Briefatto Board also keeps the rule in CLAUDE.md short, a few lines that point to a frozen DESIGN.md.

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

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:

md
<!-- 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 status lists 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.

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/src/board/cli.ts
  2. github.com/Briefatto/briefatto-board/blob/main/README.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. code.claude.com/docs/en/memory checked 2026-11-21
  7. github.com/Briefatto/briefatto-board/blob/main/LICENSE