What goes in it
Authored prose about layout, spacing, navigation, components, logo, type and voice, described by role, plus a generated block of source wording and exact styles recorded from a fresh render.
Freezing validates the prose against the recorded values, stamps the guide with a version and archives it.
How your agent uses it
- Run
npx briefatto-board install. It adds the skill and a marked block to AGENTS.md and CLAUDE.md. - Create the guide: for an existing site run
npx briefatto-board adopt ., let your agent write DESIGN.md from the captures, then runnpx briefatto-board freeze .to stamp v1. - Ask for visual work. The block tells your agent to read
DESIGN.mdfirst and to runboard checkon every piece.
Questions and answers
Is DESIGN.md the same as AGENTS.md?
No. AGENTS.md carries a short pointer; DESIGN.md holds the design guide and its versions. See DESIGN.md vs AGENTS.md.
Do I need a design system first?
No. board adopt captures an existing site's pages and computed styles, and for a new brand you start from a brief.
Is DESIGN.md about code architecture?
No. In Briefatto Board, DESIGN.md is the visual design guide: layout, components, type and voice.
Is Briefatto Board free?
Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.