# Lovable + Briefatto Board: a versioned DESIGN.md it reads

Updated 2026-11-21 · https://briefatto.com/guides/lovable-briefatto-board/

Lovable reads any AGENTS.md or CLAUDE.md at the top level of your project with every message you send, and Briefatto Board writes its pointer to your frozen DESIGN.md into both files. Keep DESIGN.md beside them, and every Lovable message carries the pointer to your brand.

## How Briefatto Board works with Lovable

- Lovable's [instructions documentation](https://docs.lovable.dev/features/knowledge) says it reads any AGENTS.md or CLAUDE.md file at the top level of your project with every message you send, and reads an instruction file in a subfolder as well.
- Lovable's [skills documentation](https://docs.lovable.dev/features/skills) says a skill is a directory containing a SKILL.md file and can be imported from a public GitHub repository URL. The Briefatto Board skill is public at [github.com/Briefatto/briefatto-board](https://github.com/Briefatto/briefatto-board).

## Set it up for Lovable

1. In your local checkout of the project, run `npx briefatto-board install` (Node.js 24 or later). It writes the Briefatto Board block into AGENTS.md and CLAUDE.md.
2. Create your guide. For an existing site, run `npx briefatto-board adopt .`, let your agent write DESIGN.md from the captures and run `npx briefatto-board freeze .` to stamp v1. For a new brand, follow [how to create a DESIGN.md](https://briefatto.com/guides/how-to-create-a-design-md/).
3. Keep AGENTS.md, CLAUDE.md and `DESIGN.md` at the top level of the project Lovable works on.
4. Import the Briefatto Board skill from its public GitHub repository URL, as Lovable's skills documentation describes.
5. Ask for any visual piece, then run `npx briefatto-board check .` on it. It fails clipped text, text off the canvas, text over other text, small text, fonts that never loaded and low contrast.

## What Lovable gets from Briefatto Board

- **One brand, versioned.** DESIGN.md is frozen as v1, v2 and on, and every session is pointed to the current one.
- **A check on the rendered piece.** `board check` tests what was drawn, not what was promised.
- **A stale list after a rebrand.** `board status` lists which pieces are current, stale or unrecorded.

## Questions and answers

### How do I keep Lovable on brand?

Freeze your brand as DESIGN.md with Briefatto Board and keep it at the top level of the project. The block in AGENTS.md and CLAUDE.md, which Lovable reads with every message, points the agent to it.

### Can I import the Briefatto Board skill into Lovable?

Yes. Lovable imports skills from a public GitHub repository URL, and the Briefatto Board skill is public at Briefatto/briefatto-board.

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

- [Replit + Briefatto Board: bring a versioned DESIGN.md to Agent](https://briefatto.com/guides/replit-briefatto-board/)
- [v0 + Briefatto Board: one design source for v0 and your agent](https://briefatto.com/guides/v0-briefatto-board/)
- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-briefatto-board/)
- [How to make AI agents follow your brand guidelines across sessions](https://briefatto.com/guides/make-ai-agent-follow-brand-guidelines-across-sessions/)

## Sources

- 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/LICENSE
- https://docs.lovable.dev/features/knowledge (checked 2026-11-21)
- https://docs.lovable.dev/features/skills (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with Lovable.
