How Briefatto Board works with Codex
- OpenAI's Codex documentation has a guide titled Custom instructions with AGENTS.md, and agents.md lists Codex among the agents that read AGENTS.md. Briefatto Board writes its block there.
- The skill also installs through skills.sh with
npx skills add Briefatto/briefatto-board, which installs skills for the agents you select.
Set it up for Codex
- 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. - Create your guide. For an existing site, run
npx briefatto-board adopt ., let your agent write DESIGN.md from the captures and runnpx briefatto-board freeze .to stamp v1. For a new brand, follow how to create a DESIGN.md. - 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 checktests what was drawn, not what was promised. - A stale list after a rebrand.
board statuslists 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.