# Gemini CLI and Antigravity + Briefatto Board: DESIGN.md setup

Updated 2026-11-21 · https://briefatto.com/guides/gemini-cli-antigravity-briefatto-board/

Add AGENTS.md to Gemini CLI's `context.fileName` setting, and it loads the block Briefatto Board writes there, which sends the agent to your frozen DESIGN.md. For Google Antigravity, place the Briefatto Board skill in `.agents/skills`, where Antigravity loads skills by default.

## How Briefatto Board works with Gemini CLI and Antigravity

- Gemini CLI's [context documentation](https://geminicli.com/docs/cli/gemini-md/) sets other context file names through the `context.fileName` property in settings.json, and its example lists AGENTS.md, CONTEXT.md and GEMINI.md.
- Google Antigravity's [skills documentation](https://antigravity.google/docs/skills) says skills are directory bundles with a required SKILL.md file, and that Antigravity defaults to `.agents/skills`.

## Set it up

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. For Gemini CLI, add AGENTS.md to `context.fileName` in settings.json, as in the example in Gemini CLI's documentation.
4. For Antigravity, copy the skill folder into `.agents/skills`: `cp -r .claude/skills/briefatto-board .agents/skills/`.
5. 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 Gemini CLI 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

### How does Gemini CLI read AGENTS.md?

List AGENTS.md in `context.fileName` in settings.json. Gemini CLI's documentation shows it in its example.

### Where does Antigravity look for skills?

In `.agents/skills` by default.

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

- [OpenCode + Briefatto Board: DESIGN.md for your agent](https://briefatto.com/guides/opencode-briefatto-board/)
- [Kiro + Briefatto Board: set up DESIGN.md for Kiro](https://briefatto.com/guides/kiro-briefatto-board/)
- [OpenAI Codex + Briefatto Board: one DESIGN.md for your agent](https://briefatto.com/guides/codex-briefatto-board/)
- [GitHub Copilot + Briefatto Board: make the agent read DESIGN.md](https://briefatto.com/guides/github-copilot-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://geminicli.com/docs/cli/gemini-md/ (checked 2026-11-21)
- https://antigravity.google/docs/skills (checked 2026-11-21)

Briefatto Board is independent and is not affiliated with Gemini CLI and Antigravity.
