Briefatto LabBriefatto Lab

Works with your agent

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

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.

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

How Briefatto Board works with Replit

  • Replit's design documentation 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 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.
  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.

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/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE
  5. docs.replit.com/design/design-md.md checked 2026-11-21
  6. docs.replit.com/build/use-agent-skills.md checked 2026-11-21

Briefatto Board is independent and is not affiliated with Replit.