# How do you get Claude Code, Cursor, Copilot or Gemini CLI to read DESIGN.md?

Updated 2026-11-21 · https://briefatto.com/guides/agent-not-reading-design-md/

Put the pointer in the instruction file your agent loads, then confirm the load with that agent's own command. `npx briefatto-board install` writes the pointer to DESIGN.md into both AGENTS.md and CLAUDE.md, which covers Claude Code and the agents that read AGENTS.md.

## Where each agent looks

- **Claude Code** reads CLAUDE.md, and by default reads AGENTS.md only when no CLAUDE.md, `.claude/CLAUDE.md` or `CLAUDE.local.md` sits in the working directory or above it. That rule is why the installer writes the same block into both files.
- **Cursor** reads AGENTS.md in the project root and in subdirectories.
- **GitHub Copilot** works from the nearest AGENTS.md in the directory tree. If your app sits in a subfolder with its own AGENTS.md, copy the marked block into that file too.
- **Gemini CLI** loads GEMINI.md by default. Add AGENTS.md to `context.fileName` in settings.json.

```json
{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}
```

## Confirm it loaded

| Agent | What to run or read |
| --- | --- |
| Claude Code | `/context all` lists the files under Memory files; `/memory` shows whether an AGENTS.md was read |
| Copilot in VS Code | The References section of the response names the instructions file |
| Gemini CLI | `/memory show` prints the full memory sent to the model; `/memory reload` re-scans the files |

Look for the block between `<!-- briefatto-board:start -->` and `<!-- briefatto-board:end -->`. After a freeze it tells the agent to read DESIGN.md before any visual work.

## Confirm it was followed

Loaded is not the same as obeyed. VS Code's documentation says the References section checks inclusion, not compliance, and Claude Code's says CLAUDE.md is context, not enforced configuration. So check the work:

- Each piece made under the guide carries a `board-version` meta tag. `board status` lists every piece as current, stale or unrecorded, and an unrecorded piece is your sign the skill was skipped.
- `board check --consistency` lists each colour off the frozen palette and each font outside the guide.

## Questions and answers

### Can I make Claude Code read the guide without fail?

Not by instruction alone: Claude Code's documentation calls CLAUDE.md context and puts anything that must run at a fixed point in a hook. Run `npx briefatto-board check .` in a Claude Code hook, a pre-commit hook or CI. A piece that breaks the floor stops there; colours and fonts outside the guide are listed in the receipt for you to read.

### Does running the installer again add a second block?

No. Running it again replaces its one marked block in AGENTS.md and CLAUDE.md.

## 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/)
- [Claude Code ignores AGENTS.md or CLAUDE.md: what to do](https://briefatto.com/guides/claude-code-ignores-agents-md/)
- [AGENTS.md vs CLAUDE.md: which file should hold your design rules?](https://briefatto.com/guides/agents-md-vs-claude-md/)
- [How do you keep design context across different AI coding tools?](https://briefatto.com/guides/one-design-guide-across-ai-coding-tools/)
- [Gemini CLI and Antigravity + Briefatto Board: DESIGN.md setup](https://briefatto.com/guides/gemini-cli-antigravity-briefatto-board/)

## Sources

- 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/README.md
- https://code.claude.com/docs/en/memory (checked 2026-11-21)
- https://code.visualstudio.com/docs/copilot/customization/custom-instructions (checked 2026-11-21)
- https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions (checked 2026-11-21)
- https://geminicli.com/docs/cli/gemini-md/ (checked 2026-11-21)
- https://cursor.com/docs/context/rules (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
