Briefatto LabBriefatto Lab

Questions

How do you enforce design checks in a pre-commit hook?

Run npx briefatto-board check . in the hook: it renders your pieces and sets exit status 1 when any fails, and Git aborts the commit when a pre-commit hook exits non-zero. The same command works as a CI step.

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

The hook

On a frozen board, save this as .git/hooks/pre-commit and make it executable:

shell
#!/bin/sh
npx briefatto-board check . "outputs/*.html"

The quotes pass the glob to Board, which expands it itself, so the same line works in PowerShell on Windows.

What stops the commit

  • Text that is clipped, off the canvas, over other text or too small where it is seen.
  • A font that never loaded, and contrast below WCAG.
  • Anti-patterns found by the Impeccable detector.
  • A delivery PNG or PDF listed in deliverables.json that does not match its editable HTML. A PNG must match every decoded RGBA pixel.

In CI

Run the same command as a step after installing dependencies. board check writes a receipt that records which checks ran, so the log says what was tested as well as what failed.

Questions and answers

Does it check exported PNG and PDF files too?

Yes. Board decodes every file listed in deliverables.json, compares it with its HTML source and records in the receipt the SHA-256 of the checked bytes.

Does the hook need a browser?

Yes, Chromium. If it is missing, the first render prints the Playwright command that installs 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. git-scm.com/docs/githooks checked 2026-11-21
  4. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  5. github.com/Briefatto/briefatto-board/blob/main/LICENSE