# Where can I see a real DESIGN.md example?

Updated 2026-11-21 · https://briefatto.com/guides/design-md-examples/

Briefatto Board's repository has three worked examples: plumb, a brief for an invented open-source tool; bakery, a brief with CC0 photographs; and current-site, a small site to adopt. Plumb goes from brief to frozen guide to a brand change, with every piece checked.

## The examples

| Example | Starts from | Shows |
| --- | --- | --- |
| [plumb](https://github.com/Briefatto/briefatto-board/tree/main/examples/plumb) | A brief for an invented open-source tool | References, directions, freeze, a kit and a brand change |
| [bakery](https://github.com/Briefatto/briefatto-board/tree/main/examples/bakery) | A brief with CC0 photographs | A brand built around supplied images |
| [current-site](https://github.com/Briefatto/briefatto-board/tree/main/examples/current-site) | A small existing site | `board adopt`, then a guide written from the captures |

## What Plumb shows

Plumb went from its brief to a frozen design guide, and its README header, link card and square post all passed `board check`. When a redrawn label was 16px where 22px was the minimum where it is seen, `board check` failed it; raised to 26px, it passed.

After the signal colour changed in v2, the README header was redrawn and current, and `board status` marked the link card and post stale.

## Try one

1. Clone the repository and open an example folder.
2. Run `npx briefatto-board install` there and ask your agent to follow the skill.
3. For current-site, start with `npx briefatto-board adopt .`; for plumb or bakery, start from `brief.md`.

## Questions and answers

### Can I copy an example as my template?

Learn the flow from them, then make your own: `board adopt` writes DESIGN.md from your site, or the flow runs from your own brief, so the guide describes your brand.

### Which example fits an existing site?

current-site, a small site to adopt with `board adopt .` and `board freeze .`.

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

- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)
- [How to create a DESIGN.md from your site or a new brand](https://briefatto.com/guides/how-to-create-a-design-md/)
- [How do you write a good DESIGN.md that an agent can use?](https://briefatto.com/guides/how-to-write-a-good-design-md/)
- [How to find which assets are stale after a rebrand](https://briefatto.com/guides/find-stale-assets-after-a-rebrand/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
