Briefatto LabBriefatto Lab

Questions

Claude Code ignores AGENTS.md or CLAUDE.md: what to do

Put the rule where Claude Code looks, keep it short, and check what it makes. Briefatto Board writes its pointer to both CLAUDE.md and AGENTS.md, and board check tests every rendered piece, so a skipped instruction is caught on the output.

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 fix

  1. Put the instruction where the agent looks. npx briefatto-board install writes the same block to AGENTS.md and CLAUDE.md, the files Claude Code's documentation names.
  2. Keep the block short. It points to the skill file and, after a freeze, to DESIGN.md.
  3. Check the output, not the intent. board check renders 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.

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