# OpenCode + Briefatto Board: DESIGN.md for your agent

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

OpenCode reads AGENTS.md for project guidance and finds skills in `.claude/skills`, and `npx briefatto-board install` puts its pointer and its skill in exactly those places. Freeze your DESIGN.md and OpenCode is told to read it before any visual work.

## How Briefatto Board works with OpenCode

- OpenCode's [rules documentation](https://opencode.ai/docs/rules/) uses an AGENTS.md file for persistent project guidance, and reads CLAUDE.md in any directory without an AGENTS.md. The installer writes its block into both.
- OpenCode's [skills documentation](https://opencode.ai/docs/skills/) searches `.opencode/skills` and, for compatibility, `.claude/skills` and `.agents/skills`. The Briefatto Board skill installs into `.claude/skills`.

## Set it up for OpenCode

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

### Does OpenCode read CLAUDE.md?

Yes, in any directory without an AGENTS.md. The installer writes the block to both files.

### Will OpenCode find the Briefatto Board skill?

Yes. OpenCode searches `.claude/skills`, and `board install` places the skill there.

### 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/)
- [OpenAI Codex + Briefatto Board: one DESIGN.md for your agent](https://briefatto.com/guides/codex-briefatto-board/)
- [Kiro + Briefatto Board: set up DESIGN.md for Kiro](https://briefatto.com/guides/kiro-briefatto-board/)
- [How to make Claude Code follow your brand with DESIGN.md](https://briefatto.com/guides/how-to-use-design-md-in-claude-code/)

## 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://opencode.ai/docs/rules/ (checked 2026-11-21)
- https://opencode.ai/docs/skills/ (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with OpenCode.
