Key Concepts

Understand the core concepts behind Brief: how it builds your Product Graph, integrations, and how Brief navigates AI coding agents to the context they need.

Last updated: July 5, 2026

Understanding these core concepts will help you get the most value from Brief—your Navigator from vision to impact.

How Brief Builds Your Product Graph

Brief builds your Product Graph automatically by connecting to your existing tools. It extracts and synthesizes:

  • Features — Your product capabilities and their status
  • Personas — Your customer segments and their needs
  • Decisions — Important choices with rationale
  • Goals — Your strategic objectives
  • Velocity — How fast you ship
  • Research Signals — What customers are saying

The Process

  1. You provide company info during onboarding
  2. Brief syncs your tools (Linear, GitHub, Notion, etc.)
  3. Brief builds your Product Graph from decisions, customers, and strategy
  4. You review and approve what Brief found
  5. It updates continuously as new data arrives

Brief keeps every builder aligned as you connect more tools and as your product evolves.

Data Sources & Integrations

Brief connects to your tools in two ways:

One-Click OAuth

Linear, GitHub, GitLab, Notion, Confluence, Jira, Asana, Fathom, Granola, Plaud, Zoom, Gong, Google Drive, SharePoint, HubSpot, Attio, Supabase, Miro, Slack, Microsoft Teams, Webex

These use OAuth—you click "Connect," authorize Brief, choose what to share, and you're done. After authorization, many integrations include a scoping step where you select exactly what data Brief can access.

  • Sync time: 30 seconds to 5 minutes depending on workspace size
  • Update frequency: Continuous (webhooks + polling)

API Key Setup

Fireflies, PostHog, Mixpanel, Stripe, LangFuse, Arize, Lightfield

These require you to create an API key and paste it into Brief. PostgreSQL uses a similar guided setup where you enter database connection details.

  • Why API keys? These tools don't offer OAuth for their APIs
  • Security: Brief stores your keys encrypted

Team vs. Personal Connections

Some integrations are team connections—an admin connects once and the whole workspace is covered (for example Fireflies, Gong, Stripe, HubSpot, Supabase). Others are personal connections—each user authorizes their own account, so Brief only sees what that user can see (for example Linear, GitHub, Notion, Slack).

Communication Tools

Slack, Microsoft Teams, Webex

Brief lives where your team talks. In Slack you can DM Brief directly for full chat—streaming answers, decision capture, and file understanding—or use the /decide command to log decisions from any conversation. Microsoft Teams is a full chat surface too, and Webex spaces feed team context into your Product Graph.

Current State vs Product Understanding

Brief distinguishes between what's actually built and what's planned or understood:

Current State (Ground Truth)

What's actually in your codebase right now—analyzed from GitHub. This is reality.

Use Current State when:

  • "Do we have authentication?"
  • "What's our tech stack?"
  • "Is feature X already built?"

Product Understanding (Synthesized)

Your company context, velocity, personas, and goals—synthesized from all your tools. This is strategic intelligence.

Use Product Understanding when:

  • "Who are our users?"
  • "What should we build next?"
  • "Why did we decide X?"
Always check Current State for critical decisions about what's actually in your codebase. Product understanding shows what's planned or documented, but code is the source of truth for what exists.

Documents & Decisions

Documents

General product documents you create in Brief—specs, strategy docs, planning docs. These live in your Brief workspace and are searchable via chat.

Decisions

A special type of document that records important choices with:

  • What was decided
  • Why that choice was made
  • When and by whom

Decisions are immutable—they can be archived but never deleted. This creates an audit trail of your product evolution.

Logging Decisions

From Slack:

/decide Use weekly sprints instead of kanban

From Chat:

"Let's decide to use Postgres for the database"

From the Web UI: Navigate to Documents → New Decision

When an AI later asks "Why did we choose React?", Brief can surface the original decision with full context.

Model Context Protocol (MCP)

MCP is how Brief navigates AI coding agents like Cursor, Claude Code, Windsurf, and VS Code to the context they need.

What Brief Provides via MCP

When you ask your AI coding agent a question, Brief navigates it to:

  • Your Product Graph (personas, features, goals)
  • Decision history ("Why did we do X?")
  • Current State ("Do we already have Y?")
  • Create new documents with your approval

How It Works

  1. You install Brief's MCP server in your AI tool
  2. You authenticate via OAuth or API key
  3. Brief navigates your AI to the right context
  4. Every builder stays aligned, session after session
Destructive operations require confirmation. If an AI tries to delete or move something, Brief asks you to approve first.

Preset Prompts

Brief's chat suggests contextual presets—starter prompts chosen for you based on the page you're on, which tools you've connected, and how long you've been using Brief. Common examples include:

  • 🔭 "I'm new to Brief" — Guided tour
  • 🚏 "What should we build next?" — Evidence-backed priorities
  • 👤 "Who are we building for?" — ICP with data
  • 📏 "How do we know it's working?" — Measurement plan

The presets you see change as your workspace grows, so they always query the data sources you actually have.

Brief Agents

Beyond chat, Brief runs agents—scheduled workers that turn your connected tools into recurring insight. You can create custom agents by chatting with the Agent Builder, run them on a weekly cadence with results delivered in-app and to Slack, and get org-wide digests like the Weekly Brief. Brief also proactively nudges you with review invitations and reminders when something needs your attention.

Learn more in the Agents Overview.

Next Steps

Now that you understand the key concepts: