Briefatto LabBriefatto Lab

Questions

Is there a free DESIGN.md template?

The recorded DESIGN.md in Briefatto Board's current-site example, a small site called Sedge Ferry, is a free, working template: YAML front matter, then Overview, Colours, Typography, Parts and Layout. Copy the outline, let your agent fill it from your own pages with board adopt, and stamp it with board freeze.

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

The outline

This is the shape of the recorded guide in the repository's current-site example, with the values taken out:

markdown
---
name: <Brand>
colors:
  paper: "<hex>"
  ink: "<hex>"
  signal: "<hex>"
typography:
  heading:
    fontFamily: <family>
    fontSize: <size>
  body:
    fontFamily: <family>
    fontSize: <size>
---

# <Brand>

## Overview
## Colours
## Typography
## Parts
## Layout

The freeze stamp goes between the front matter and the first heading. Board writes it; you never type it.

What goes under each heading

  • Overview. What the brand is for and how it talks, with example copy taken from the real pages.
  • Colours. Each colour by its job: the page ground, the reading text, the one accent and where it goes.
  • Typography. Which parts use each face, plus the font load lines from sources that resolve.
  • Parts. Each recurring part named by its job, then how it is built.
  • Layout. How the arrangement recomposes for a phone, a wide screen or a square post.

Write it as a handoff from one designer to another, sufficient on its own. Leave out measured ratios and coverage percentages: freeze records the exact computed styles for you.

Turn the template into your guide

  1. Run npx briefatto-board install.
  2. Have a site? Run npx briefatto-board adopt . and let your agent write each section from the captures.
  3. No site yet? Put the brief in brief.md and go from references to three directions to a pick.
  4. Run npx briefatto-board freeze .. It compares the colours, font families and font sizes you wrote, front matter included, with values from a fresh render and names every conflict.

Questions and answers

Can I copy a popular brand's DESIGN.md and use it as mine?

Use it to learn the shape. The brand library holds DESIGN.md files for popular brands, and a live brand site makes a good reference: board refs . --capture <url> first.png puts it on your reference sheet. Your own guide describes your own pages, and freeze names any written value your render contradicts.

Does the template follow Google's design.md format?

Its front matter carries the tokens freeze reads: a YAML colors: block and fontFamily and fontSize fields. Freeze reads a YAML colors: block and fontFamily and fontSize fields, and treats a reference in braces, such as {colors.primary}, as a token name.

Where are complete examples?

The repository has three: plumb, a brief for an invented open-source tool; bakery, a brief with CC0 photographs; and current-site, a small site to adopt, which ships its recorded DESIGN.md.

Is the template free to use?

Yes. Briefatto Board and its examples are Apache-2.0 on GitHub at Briefatto/briefatto-board.

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/examples/current-site/recorded/DESIGN.md
  2. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  3. github.com/Briefatto/briefatto-board/blob/main/src/board/design-validation.ts
  4. github.com/Briefatto/briefatto-board/blob/main/README.md
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE