# Is DESIGN.md about architecture or visual design?

Updated 2026-11-21 · https://briefatto.com/guides/is-design-md-architecture-or-visual-design/

The name DESIGN.md is used for both, and in Briefatto Board it is the visual design guide. It describes layout, spacing, navigation, components, logo, type and voice by role, with exact styles recorded from a render.

## What Briefatto Board's DESIGN.md holds

Authored prose that describes the existing or chosen look by role, plus a generated block of source wording and exact styles recorded from a render.

Keep architecture notes in a file with another name, so your agent never reads them as the visual guide.

## Questions and answers

### Where should architecture notes go?

In AGENTS.md, the file coding agents read for general instructions. DESIGN.md stays visual.

### What does the visual DESIGN.md cover?

Layout, spacing, navigation, components, logo, type and voice, described by role.

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

- [Is DESIGN.md an official standard or an Anthropic format?](https://briefatto.com/guides/is-design-md-an-official-standard/)
- [DESIGN.md vs AGENTS.md: what goes in each file](https://briefatto.com/guides/design-md-vs-agents-md/)
- [What is DESIGN.md, and how do coding agents use it?](https://briefatto.com/guides/what-is-design-md/)
- [CLAUDE.md vs DESIGN.md: what to put in each for Claude Code](https://briefatto.com/guides/claude-md-vs-design-md/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://agents.md (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
