# Your AI coding agent ignores your design system: what to do

Updated 2026-11-21 · https://briefatto.com/guides/ai-coding-tools-ignore-your-design-system/

Give the agent one guide recorded from your real pages, point it there from AGENTS.md and CLAUDE.md, and check what it makes. Briefatto Board does each of these with a frozen DESIGN.md, its installer and `board check`.

## The fix

- `board adopt .` captures your pages and their computed styles, so the guide starts from what your site renders.
- `board freeze .` records exact styles and validates the written guide against them.
- `npx briefatto-board install` writes the pointer into AGENTS.md and CLAUDE.md.
- `board check` tests every rendered piece for legibility, fonts, contrast and anti-patterns.

## Questions and answers

### Can it capture a running app?

Yes. Pass `--page <url>` to `board adopt` for each representative route.

### Does it replace my component library?

No. DESIGN.md sits next to your design system as the guide your agent reads.

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

- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)
- [Design docs drift from the real design: how freeze stops it](https://briefatto.com/guides/design-docs-drift-from-the-real-design/)
- [How to make an AI agent follow your design rules](https://briefatto.com/guides/make-an-agent-follow-your-design-rules/)
- [DESIGN.md vs a design system: what is the difference?](https://briefatto.com/guides/design-md-vs-design-system/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
