# Replit + Briefatto Board: bring a versioned DESIGN.md to Agent

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

Replit's documentation says an existing DESIGN.md can seed a new design system that Agent uses. Briefatto Board gives you that DESIGN.md recorded from your real site, frozen as a numbered version and checked on every rendered piece.

## How Briefatto Board works with Replit

- Replit's [design documentation](https://docs.replit.com/design/design-md.md) says DESIGN.md is the document representation of a generated design system, readable by you and usable by Agent, and that an existing DESIGN.md can seed a new design system.
- Replit's [skills documentation](https://docs.replit.com/build/use-agent-skills.md) keeps installed skills in the project's `/.agents/skills` directory, where they persist across chat sessions, and installs them with the form `npx skills <skill> -a replit`.

## Set it up for Replit

1. In your project folder, run `npx briefatto-board install` (Node.js 24 or later). It adds the skill under `.claude/skills/` and 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. Bring the frozen `DESIGN.md` into your Replit project and use it to seed the design system, as Replit's design documentation describes.
4. 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 Replit 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

### Does Replit use DESIGN.md?

Yes. Replit's documentation says DESIGN.md is the document representation of a generated design system, usable by Agent, and that an existing DESIGN.md can seed a new one.

### Where do Replit skills live?

In the project's `/.agents/skills` directory, where they persist across chat sessions.

### Why freeze DESIGN.md with Briefatto Board first?

Freeze records exact styles from a fresh render of your site, validates the written guide against them and stamps a version, so the DESIGN.md you hand Replit matches what your site renders.

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

- [Lovable + Briefatto Board: a versioned DESIGN.md it reads](https://briefatto.com/guides/lovable-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/)
- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)

## 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.replit.com/design/design-md.md (checked 2026-11-21)
- https://docs.replit.com/build/use-agent-skills.md (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with Replit.
