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

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

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.

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

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

- [Does Claude Code read DESIGN.md automatically?](https://briefatto.com/guides/does-claude-code-read-design-md/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [Cursor ignores your rules: how to keep it on brand](https://briefatto.com/guides/cursor-ignores-rules/)
- [How to make Claude Code follow your brand with DESIGN.md](https://briefatto.com/guides/how-to-use-design-md-in-claude-code/)

## Sources

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