# Kiro + Briefatto Board: set up DESIGN.md for Kiro

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

Kiro's steering documentation lists AGENTS.md support, and Briefatto Board writes a block there that sends Kiro's agent to your frozen DESIGN.md. Place the skill in `.kiro/skills`, where Kiro keeps skills, and the board procedure sits next to it.

## How Briefatto Board works with Kiro

- Kiro's [steering documentation](https://kiro.dev/docs/steering/) lists AGENTS.md support in its comparison of surfaces.
- Kiro's [skills documentation](https://kiro.dev/docs/skills/) describes skills stored in `.kiro/skills`.

## Set it up for Kiro

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. Copy the skill folder into `.kiro/skills`: `cp -r .claude/skills/briefatto-board .kiro/skills/`.
4. 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 Kiro 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 Kiro read AGENTS.md?

Yes. Kiro's steering documentation lists AGENTS.md support.

### Where do Kiro skills live?

In `.kiro/skills`.

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

- [Windsurf and Devin + Briefatto Board: DESIGN.md for the agent](https://briefatto.com/guides/windsurf-devin-briefatto-board/)
- [Gemini CLI and Antigravity + Briefatto Board: DESIGN.md setup](https://briefatto.com/guides/gemini-cli-antigravity-briefatto-board/)
- [OpenCode + Briefatto Board: DESIGN.md for your agent](https://briefatto.com/guides/opencode-briefatto-board/)
- [Cursor + Briefatto Board: on-brand UI from one DESIGN.md](https://briefatto.com/guides/cursor-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://kiro.dev/docs/steering/ (checked 2026-11-21)
- https://kiro.dev/docs/skills/ (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with Kiro.
