Docs/Playbooks

Playbooks · 20 min

Ship a design system without visual drift

Map tokens and components, build a Theme Lab, migrate one pilot, and verify every layer.

Start with the system you already have

Ask your coding agent
Use Brief to map our frontend design system. Find tokens, themes, shared components, hand-written CSS, representative screens, and visual or accessibility tests. Don't edit yet. If useful, fan out read-only audits for tokens, components, and verification, then recommend the smallest useful mission.

Build a Theme Lab

A Theme Lab is a dev-only surface that renders production tokens and components together. It makes changes visible before they spread through the product.

Ask your coding agent
Run a Brief design mission to build a dev-only Theme Lab. Import production tokens and components rather than demo copies. Show foundations, common components, important states, responsive layouts, accessibility behavior, and supported themes. Add focused tests and keep the route out of production.

Connect Figma intent to repo reality

Ask your coding agent
Inspect <Figma frame URL> with the connected Figma tools. Use Brief to map it to our existing tokens, components, rules, and tests. Compare it with the Theme Lab and explain the design-to-code gap before editing.
Ask your coding agent
Now run a bounded Brief design mission for <surface>. Reuse approved tokens and components, update the Theme Lab when shared foundations change, and stop if the work needs a new system-level design decision.

Verify the system at every layer

Ask your coding agent
Add a multi-layer design-system verification loop to this mission. Check token definitions and forbidden raw values; component variants and states; Theme Lab coverage; rendered fonts, line height, padding, gaps, alignment, radii, borders, and shadows; responsive layouts; visual regression; accessibility; and representative product flows. Report what ran, what passed, and what remains unproven.
  • Tokens: semantic aliases, theme completeness, and scans for raw values.
  • Components: variants, interaction states, and shared primitive reuse.
  • Rendered UI: computed geometry, responsive layouts, visual comparison, and accessibility.
  • Product: representative flows using the production components.

Save the pattern once it works

Ask your coding agent
Save the Theme Lab, token files, shared primitives, pilot screen, and tests as a Brief reference implementation. Record where it applies and what should not be copied blindly.
Was this guide useful?Help us make Brief easier to learn.
Ready for another workflow?Choose your next mission →