Briefatto LabBriefatto Lab

Works with your agent

DESIGN.md with Vite and React in OpenAI Codex

Start Vite's dev server and run npx briefatto-board adopt . --page http://localhost:5173/, or build and run npx briefatto-board adopt . --root dist, then let Codex write DESIGN.md and freeze it. Codex reads AGENTS.md, where Briefatto Board's block tells it to read DESIGN.md before any visual work.

Updated Markdown version

Briefatto BoardFree and open source, Apache-2.0

Blind-tested against Impeccable, Taste Skill and Hallmark

Automated tests, green CI

Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf and any agent that reads AGENTS.md

How it fits

  • OpenAI's Codex documentation has a guide, Custom instructions with AGENTS.md. Briefatto Board writes its block to AGENTS.md.
  • Vite's guide serves the app on http://localhost:5173 during development, and its build options give dist as the default output folder.
  • board adopt captures a running site from URLs, or a build folder with an index page through --root.

Set it up

shell
npx briefatto-board install
# with the Vite dev server running:
npx briefatto-board adopt . --page http://localhost:5173/
# or, after a production build:
npx briefatto-board adopt . --root dist

Ask Codex to follow the Briefatto Board skill and write DESIGN.md from the captures, then run npx briefatto-board freeze .. You can also install the skill through skills.sh with npx skills add Briefatto/briefatto-board.

What Codex gets

  • Your React app's real look, recorded as exact styles from a fresh render.
  • A check on every piece. board check fails clipped text, small text, unloaded fonts and low contrast.
  • Versions. board diff v1 v2 shows what changed, and board status lists stale pieces.

Questions and answers

Dev server or build folder?

Either. Pass --page URLs for a running dev server, or --root dist for a production build. With a running site, keep it running until freeze.

Does it need my component library?

No. Board captures the rendered pages and computed styles, and the agent reads your CSS variables and theme files when it writes the guide.

Is Briefatto Board free?

Yes. It is open source under the Apache-2.0 licence and installs with npx briefatto-board install.

One guide. Every agent.

Briefatto Board is free and open source under Apache-2.0. One command adds the skill and the pointer your agent reads.

npx briefatto-board install

Sources

  1. developers.openai.com/codex/guides/agents-md checked 2026-11-21
  2. agents.md checked 2026-11-21
  3. skills.sh checked 2026-11-21
  4. github.com/Briefatto/briefatto-board/blob/main/README.md checked 2026-11-21
  5. vite.dev/guide/ checked 2026-11-21
  6. vite.dev/config/build-options checked 2026-11-21
  7. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  8. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  9. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  10. github.com/Briefatto/briefatto-board/blob/main/LICENSE

Briefatto Board is independent and is not affiliated with Codex.