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

Updated 2026-11-21 · https://briefatto.com/guides/claude-code-forgets-claude-md/

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.

## 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`.

## Try it

```
npx briefatto-board install
```

Briefatto Board is free and open source under Apache-2.0: https://github.com/Briefatto/briefatto-board

## Related guides

- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Design checks as scripts instead of prompts: how board check works](https://briefatto.com/guides/deterministic-design-checks-vs-prompts/)
- [How do I make an agent follow a design skill every time?](https://briefatto.com/guides/make-an-agent-follow-a-skill/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
- https://code.claude.com/docs/en/memory (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
