# Can Claude Code design UI?

Updated 2026-11-21 · https://briefatto.com/guides/can-claude-code-design-ui/

Yes. With Briefatto Board's skill and nothing but a brief, Claude Code drew three directions, froze the chosen one as DESIGN.md and made a seven-piece kit in about 400 seconds and under a dollar per run, and on a separate brief three blind judges said its kit could go to the client as supplied.

## What it made

We ran Claude Code headless three times, each in a fresh folder holding only `brief.md` and the Briefatto Board skill. The runs took 399, 477 and 406 seconds. Each one drew three directions, picked one, ran `board freeze` to write DESIGN.md, then made the kit:

- a 1440x900 website hero
- a 1080x1080 post and a 1080x1920 story
- a 1200x628 link card, a 300x250 banner and a 1200x630 OG image
- a 1240x1754 A4 poster

In the 399-second run, Claude Code took 46 turns, all seven pieces passed `board check`, and no step blocked it.

## A kit a client would accept

Afterlight Matinees is an invented film programme from one of our unaided runs. Claude Code had the installed board and the client's brief, nothing else. It delivered a booking-page hero for desktop and mobile, an Instagram announcement, an A3 pub-window poster as print PDFs, SVG wordmarks and a frozen DESIGN.md.

Three blind judges, separate Claude sessions, saw only the brief and the pieces at native size. All three said send it as supplied. [See the whole kit](https://briefatto.com/guides/afterlight-matinees-brand-kit-made-with-briefatto-board/).

## What Claude Code needs from you

A brand to design from and a check on what it renders. Give it those and the model does the aesthetic work itself: Briefatto Board ships no taste rubric.

1. Run `npx briefatto-board install` in the project.
2. Put the brief in `brief.md` and ask Claude Code to follow the Briefatto Board skill.
3. Look at the reference sheet it shows you and say what to work from.
4. Pick one of the three directions, ask for changes, then approve it.
5. Let it freeze DESIGN.md and make the pieces. `board kit .` checks the layouts and the exported files.

Already have a site? `npx briefatto-board adopt .` captures it, Claude Code writes DESIGN.md from the captures, and `npx briefatto-board freeze .` stamps it as v1.

## Questions and answers

### Does Claude Code find the design skill on its own?

Yes. In six unaided runs, given only a brief and the words "Make our brand and launch kit", every Claude Code and Codex session found Briefatto Board through the pointer the installer writes into AGENTS.md and CLAUDE.md, and opened its skill among its first actions.

### What does board check fail?

Text that is clipped, off the canvas, over other text or too small where it is seen, fonts that never loaded, contrast below WCAG, and the anti-patterns found by the Impeccable detector.

### Can Claude Code fix the UI it already built?

Yes. `npx briefatto-board adopt . --check` runs the floor on your current pages, Claude Code proposes fixes and waits for your yes, and the repaired look is frozen as DESIGN.md. [Improve Claude Code's frontend design](https://briefatto.com/guides/improve-claude-code-frontend-design/).

### Is this only for Claude Code?

No. Briefatto Board works with any coding agent that reads AGENTS.md and runs shell commands: Claude Code through CLAUDE.md, and Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, OpenCode, Devin and the others that read AGENTS.md.

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

- [Why does every site Claude Code builds look the same?](https://briefatto.com/guides/why-claude-code-sites-look-the-same/)
- [How do you make a brand kit with Claude Code?](https://briefatto.com/guides/claude-code-brand-kit/)
- [How long a design kit takes with Briefatto Board, and what it costs](https://briefatto.com/guides/how-much-does-a-design-kit-cost-with-claude-code/)
- [Can Claude Code design a logo?](https://briefatto.com/guides/can-claude-code-design-a-logo/)
- [Does a DESIGN.md keep your brand? We measured the drift](https://briefatto.com/guides/does-design-md-keep-your-brand-drift-test/)

## Sources

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