The fix
- Put the instruction where the agent looks.
npx briefatto-board installwrites the same block to AGENTS.md and CLAUDE.md, the files Claude Code's documentation names. - Keep the block short. It points to the skill file and, after a freeze, to DESIGN.md.
- Check the output, not the intent.
board checkrenders each piece and fails it for clipped text, text off the canvas, text over other text, text too small where it is seen, fonts that never loaded and contrast below WCAG.
A check that does not depend on memory
board check is a program, not a prompt. It writes a receipt that records which checks ran and sets exit status 1 when any piece fails, so a script or the agent stops on it.
Questions and answers
Does the check stop a bad piece from being handed over?
board check writes a receipt and sets exit status 1 when any piece fails, so a script or the agent stops on it.
Which file does Claude Code read, CLAUDE.md or AGENTS.md?
Its documentation describes persistent instructions through CLAUDE.md or AGENTS.md. Briefatto Board writes its block to both.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.