# What does npx briefatto-board install write into my project?

Updated 2026-11-21 · https://briefatto.com/guides/what-briefatto-board-install-writes/

`npx briefatto-board install` saves Briefatto Board as a dev dependency from a package archive kept under `.claude/briefatto-board/`, copies SKILL.md and board.mjs into `.claude/skills/briefatto-board/`, and writes one marked block into AGENTS.md and CLAUDE.md. Running it again replaces that block instead of adding a second.

## Every write

| Path | What goes there |
| --- | --- |
| `package.json` (devDependencies) | Briefatto Board, installed from the archive below |
| `.claude/briefatto-board/` | The package archive, so the dependency still resolves after the npx cache is cleaned |
| `.claude/skills/briefatto-board/` | `SKILL.md`, the procedure the agent follows, and `board.mjs`, the launcher |
| `AGENTS.md` and `CLAUDE.md` | One block between `<!-- briefatto-board:start -->` and `<!-- briefatto-board:end -->` |

## The block, before and after freeze

Before a design is frozen, the block says the project uses Briefatto Board for design work, points to `.claude/skills/briefatto-board/SKILL.md` and says there is no frozen design yet. After `board freeze`, it tells the agent to read `DESIGN.md` before any visual work, to route brand changes through `board freeze` and to run `board check` on every piece.

## What it needs

Node.js 24 or later. npm runs with `--ignore-scripts`, so no package install scripts run. The first render prints the Playwright command to install Chromium if it is missing.

## Questions and answers

### Does the installer run any install scripts?

No. It runs npm with `--ignore-scripts`.

### Will it change the rest of my CLAUDE.md?

No. It adds or replaces its one marked block and leaves everything else as it is.

### What does Briefatto Board depend on?

Its npm runtime dependencies are Culori, Mozilla PDF.js, Playwright, pngjs, yaml and Zod, each under its own open-source licence.

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

- [How can I check that a design skill is safe to install?](https://briefatto.com/guides/is-this-design-skill-safe/)
- [Does Briefatto Board work with my coding agent?](https://briefatto.com/guides/does-it-work-with-my-coding-agent/)
- [AGENTS.md vs CLAUDE.md: which file should hold your design rules?](https://briefatto.com/guides/agents-md-vs-claude-md/)
- [Does Briefatto Board work on Windows and PowerShell?](https://briefatto.com/guides/briefatto-board-on-windows/)

## Sources

- https://github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/board.mjs
- 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/README.md
- https://github.com/Briefatto/briefatto-board/blob/main/THIRD_PARTY.md
- https://github.com/Briefatto/briefatto-board/blob/main/NOTICE
- https://github.com/Briefatto/briefatto-board/blob/main/LICENSE
