# OpenAI Codex + Briefatto Board: one DESIGN.md for your agent

Updated 2026-11-21 · https://briefatto.com/guides/codex-briefatto-board/

Run `npx briefatto-board install` and freeze a DESIGN.md: Codex reads AGENTS.md for custom instructions, and Briefatto Board writes a block there that tells it to read your design guide before visual work. `board check` then tests every piece Codex makes on its rendered output.

## How Briefatto Board works with Codex

- OpenAI's Codex documentation has a guide titled [Custom instructions with AGENTS.md](https://developers.openai.com/codex/guides/agents-md), and [agents.md](https://agents.md) lists Codex among the agents that read AGENTS.md. Briefatto Board writes its block there.
- The skill also installs through [skills.sh](https://skills.sh) with `npx skills add Briefatto/briefatto-board`, which installs skills for the agents you select.

## Set it up for Codex

1. In your project folder, run `npx briefatto-board install` (Node.js 24 or later). It adds the skill under `.claude/skills/` and writes the Briefatto Board block into AGENTS.md and CLAUDE.md.
2. Create your guide. For an existing site, run `npx briefatto-board adopt .`, let your agent write DESIGN.md from the captures and run `npx briefatto-board freeze .` to stamp v1. For a new brand, follow [how to create a DESIGN.md](https://briefatto.com/guides/how-to-create-a-design-md/).
3. Ask for any visual piece, then run `npx briefatto-board check .` on it. It fails clipped text, text off the canvas, text over other text, small text, fonts that never loaded and low contrast.

## What Codex gets from Briefatto Board

- **One brand, versioned.** DESIGN.md is frozen as v1, v2 and on, and every session is pointed to the current one.
- **A check on the rendered piece.** `board check` tests what was drawn, not what was promised.
- **A stale list after a rebrand.** `board status` lists which pieces are current, stale or unrecorded.

## Questions and answers

### How do I make Codex follow my design system?

Freeze your design as a DESIGN.md with Briefatto Board. The block it writes into AGENTS.md, which Codex reads, tells the agent to read DESIGN.md before visual work.

### Can I install the skill without the installer?

Yes. `npx skills add Briefatto/briefatto-board` installs it through skills.sh.

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

- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-briefatto-board/)
- [OpenCode + Briefatto Board: DESIGN.md for your agent](https://briefatto.com/guides/opencode-briefatto-board/)
- [GitHub Copilot + Briefatto Board: make the agent read DESIGN.md](https://briefatto.com/guides/github-copilot-briefatto-board/)
- [Replit + Briefatto Board: bring a versioned DESIGN.md to Agent](https://briefatto.com/guides/replit-briefatto-board/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
- https://developers.openai.com/codex/guides/agents-md (checked 2026-11-21)
- https://agents.md (checked 2026-11-21)
- https://skills.sh (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with OpenAI Codex.
