Briefatto LabBriefatto Lab

Works with your agent

DESIGN.md with Next.js and Tailwind in Cursor

Adopt your running Next.js app with npx briefatto-board adopt . --page http://localhost:3000/, let Cursor's agent write DESIGN.md from the captures and your Tailwind theme, and freeze it. Cursor reads AGENTS.md, where Briefatto Board's block tells it to read 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 it fits

  • Cursor's rules documentation lists AGENTS.md as agent instructions, a plain-markdown alternative to .cursor/rules. Briefatto Board writes its block there.
  • Cursor's skills documentation loads skills from .claude/skills/ for compatibility, where the Briefatto Board skill installs.
  • Next.js uses http://localhost:3000 during development by default, and board adopt captures the URLs you pass.
  • Tailwind theme variables compile to regular CSS variables, which the skill tells the agent to inspect.

Set it up in Cursor

  1. Run next dev and leave it running.
  2. In Cursor's terminal: npx briefatto-board install.
  3. Capture the brand: npx briefatto-board adopt . --page http://localhost:3000/ --page http://localhost:3000/blog.
  4. Ask Cursor's agent to follow the Briefatto Board skill and write DESIGN.md from the captures.
  5. Freeze it: npx briefatto-board freeze ..

For a static export, next build with output: "export" writes an out folder; adopt it with npx briefatto-board adopt . --root out.

Keep Cursor's UI on the theme

  • board check fails clipped text, small text, unloaded fonts and contrast below WCAG on every piece.
  • board check --consistency lists colours off the frozen palette, each with its nearest frozen colour, and fonts outside the guide.
  • After a brand change, freeze v2 and board status lists what is stale.

Questions and answers

Do I need a .cursor/rules file for my Tailwind theme?

No. The theme stays in Tailwind, the brand guide in DESIGN.md, and the pointer in AGENTS.md, which Cursor reads.

Does it work with the App Router?

Yes. Board captures the rendered pages at the URLs you pass, whichever router serves them.

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. cursor.com/docs/context/rules checked 2026-11-21
  2. cursor.com/docs/skills checked 2026-11-21
  3. nextjs.org/docs/app/api-reference/cli/next checked 2026-11-21
  4. nextjs.org/docs/app/guides/static-exports checked 2026-11-21
  5. tailwindcss.com/docs/theme checked 2026-11-21
  6. github.com/Briefatto/briefatto-board/blob/main/skill/briefatto-board/SKILL.md
  7. github.com/Briefatto/briefatto-board/blob/main/src/board/cli.ts
  8. github.com/Briefatto/briefatto-board/blob/main/README.md
  9. github.com/Briefatto/briefatto-board/blob/main/src/board/standing.ts
  10. github.com/Briefatto/briefatto-board/blob/main/src/board/check.ts
  11. github.com/Briefatto/briefatto-board/blob/main/LICENSE

Briefatto Board is independent and is not affiliated with Cursor.