Briefatto LabBriefatto Lab

Questions

How do you get Claude Code, Cursor, Copilot or Gemini CLI to read 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.

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

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

AgentWhat 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 CodeThe 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.

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. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  2. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/README.md
  4. code.claude.com/docs/en/memory checked 2026-11-21
  5. code.visualstudio.com/docs/copilot/customization/custom-instructions checked 2026-11-21
  6. docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions checked 2026-11-21
  7. geminicli.com/docs/cli/gemini-md/ checked 2026-11-21
  8. cursor.com/docs/context/rules checked 2026-11-21
  9. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts