# How is DESIGN.md different from a Tailwind config?

Updated 2026-11-21 · https://briefatto.com/guides/design-md-vs-tailwind-config/

A Tailwind config defines the tokens your utilities use; DESIGN.md tells an agent how the brand uses them, by role, with the exact styles your pages render. Briefatto Board's skill reads your Tailwind configuration when it writes DESIGN.md, and `board freeze` checks the guide against a fresh render.

## What each holds

|  | Tailwind config or `@theme` | DESIGN.md with Briefatto Board |
| --- | --- | --- |
| Holds | Theme variables that decide which utility classes exist | Layout, components, type and voice by role, plus exact styles recorded from a render |
| Read by | Tailwind, when it compiles your CSS | The agent, before any visual work |
| Answers | Which values are available | How the brand uses them, and what a new piece should look like |
| Versioned | With your code | Frozen as v1, v2 and on, with a stale list after a change |

## How they stay in step

Tailwind's documentation says theme variables defined with `@theme` become regular CSS variables when your CSS is compiled. After `board adopt`, the agent inspects those CSS variables and your Tailwind configuration, and `board freeze` records the computed styles your pages actually render. Freeze then names any style value in the prose that conflicts with them.

## Questions and answers

### Should DESIGN.md replace tailwind.config?

No. Keep your theme where Tailwind reads it. DESIGN.md is the brief the agent reads before it uses that theme.

### Does it work with Tailwind's @theme variables?

Yes. The agent reads the CSS variables they compile to, and freeze records the styles they produce on your pages.

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

- [Design tokens for AI coding agents: what goes in DESIGN.md?](https://briefatto.com/guides/design-tokens-for-ai-coding-agents/)
- [How do you write a good DESIGN.md that an agent can use?](https://briefatto.com/guides/how-to-write-a-good-design-md/)
- [Where can I see a real DESIGN.md example?](https://briefatto.com/guides/design-md-examples/)
- [DESIGN.md vs a design system: what is the difference?](https://briefatto.com/guides/design-md-vs-design-system/)

## Sources

- https://tailwindcss.com/docs/theme (checked 2026-11-21)
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/CHANGELOG.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
