Briefatto LabBriefatto Lab

Questions

How do I make an agent follow a design skill every time?

Give the skill a check that fails: Briefatto Board's board check renders each piece and sets exit status 1 when the floor is broken, so the agent, a git hook or CI stops on it. The skill stays short, and the brand lives in a frozen DESIGN.md that AGENTS.md and CLAUDE.md point to.

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

Instructions ask, programs decide

A skill is text the agent reads. What holds the line is a program the agent cannot talk its way past. Briefatto Board splits the job:

  • SKILL.md holds the procedure: which board commands to run, and in what order.
  • DESIGN.md holds the brand: the project's frozen design guide.
  • `board check` holds the floor: it renders each piece and fails it for clipped, off-canvas, overlapping or too-small text, fonts that never loaded, contrast below WCAG and Impeccable's anti-patterns. It checks the brand name where it appears, and a campaign piece's required copy.

Put the check where it cannot be skipped

The block in AGENTS.md and CLAUDE.md tells the agent to run board check on every piece before handing it over. For a hard stop outside the agent, run the same command in a git pre-commit hook: Git aborts the commit when the hook exits non-zero. See run a design check in a pre-commit hook.

Questions and answers

Can a skill force the model to obey?

The program does. Briefatto Board pairs the skill with board check, which writes a receipt of which checks ran and fails the piece with exit status 1.

Where does Briefatto Board put its skill?

Under .claude/skills/briefatto-board/, with a marked block in AGENTS.md and CLAUDE.md that points to it.

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. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  2. github.com/Briefatto/briefatto-board/blob/main/README.md
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  5. git-scm.com/docs/githooks checked 2026-11-21
  6. github.com/Briefatto/briefatto-board/blob/main/LICENSE