Briefatto LabBriefatto Lab

Works with your agent

Windsurf and Devin + Briefatto Board: DESIGN.md for the agent

Devin's desktop documentation, which replaced the Windsurf docs, says an AGENTS.md file at your project root gives guidance to the agent. Briefatto Board writes its block into AGENTS.md, so the agent is told to read your frozen DESIGN.md before any visual work.

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

How Briefatto Board works with Windsurf and Devin

  • Devin's AGENTS.md documentation says an AGENTS.md file at your project root, and in subdirectories, gives guidance to the agent.
  • Devin's skills documentation reads workspace skills from .devin/skills/, .agents/skills/ and the legacy .windsurf/skills/. The Briefatto Board block in AGENTS.md names its skill file by path, .claude/skills/briefatto-board/SKILL.md.

Set it up for Windsurf and Devin

  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.
  3. Keep .claude/skills/briefatto-board/SKILL.md in the repository; the AGENTS.md block points the agent to it.
  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 Windsurf and Devin get 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

Is Windsurf now Devin?

Windsurf's documentation now lives with Devin's: docs.windsurf.com redirects to docs.devin.ai, where the desktop agent is documented.

How does the agent find DESIGN.md?

Through AGENTS.md. Briefatto Board writes a block there that tells the agent to read DESIGN.md before visual work.

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/README.md
  2. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  3. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  4. github.com/Briefatto/briefatto-board/blob/main/LICENSE
  5. docs.devin.ai/desktop/cascade/agents-md checked 2026-11-21
  6. docs.devin.ai/desktop/cascade/skills checked 2026-11-21
  7. docs.windsurf.com/ checked 2026-11-21

Briefatto Board is independent and is not affiliated with Windsurf and Devin.