briefs & review

Writing briefs

A brief is a structured brand document — positioning, voice, audience, design intent, and decisions — grounded in the references you captured. It's what your agent reads through the MCP.

Create a brief

  1. 1
    Create a project — a single client engagement or campaign that collects references. You can rename it later.
  2. 2
    Push a few captures into the project so the brief has real references to work from.
  3. 3
    Open the project's briefs section and start a new brief, then pick a brief type.
  4. 4
    Answer the adaptive intake — a short set of questions tailored to the brief type — and attach captures as references.
  5. 5
    Click Generate. The brief is synthesised from your intake and references and opens in a markdown editor you can refine.

What's in a brief

  • Positioning, values, and voice (tone, do/don't say, example phrases).
  • Audience — primary and secondary segments, their needs and channels.
  • Design intent — descriptors, anti-descriptors, and brand tokens (colors, fonts, radius, shadow).
  • A decisions log — what was decided and why, attributable over time.

why it matters for agents

Each of these sections is exposed as a focused MCP tool (get_voice, get_brand_tokens, and so on), so your coding agent can pull exactly the slice it needs instead of re-reading a whole document.

Next

When a brief is ready to circulate, send it for review and approval.