/onboard with Context
Start each session with /onboard. Claude Code loads your product context from Brief: personas, decisions, current work, strategic goals.
Claude Code Integration
Claude Code + Brief
Claude Code is powerful. With Brief, it understands your product, not just your code. One command to connect.
Beyond CLAUDE.md
CLAUDE.md tells Claude Code about your project conventions. But it's static text, manually maintained, and knows nothing about why you built things the way you did.
| Capability | CLAUDE.md alone | Claude Code + Brief |
|---|---|---|
| Project conventions | ✓ Static rules | ✓ Dynamic + history |
| Tech stack | ✓ You write it | ✓ Auto-detected |
| Past decisions | ✗ No memory | ✓ Full history |
| Customer context | ✗ Unknown | ✓ Personas, needs |
| Strategic constraints | ✗ Not available | ✓ Goals, priorities |
| Decision validation | ✗ Manual | ✓ guard_approach |
How It Works
Query Decisions
"What did we decide about auth?" Claude Code searches Brief and returns the actual decision with rationale, not a generic answer.
Validate Before Building
Before architectural changes, Claude Code runs guard_approach to check for conflicts with existing decisions.
Record as You Go
"We're using Postgres for this." Claude Code logs the decision to Brief with rationale, so future sessions remember.
Connect Brief to Claude Code
One command. No config files to edit.
Step 1: Add Brief MCP
claude mcp add --transport http brief https://app.briefhq.ai/mcpStep 2: Authenticate
Run /mcp inside Claude Code. A browser window opens for authentication.
Step 3: Verify
claude mcp listLook for brief ✔ connected.
Frequently Asked Questions
Can I use both CLAUDE.md and Brief?
Yes. Keep CLAUDE.md for hard rules and conventions. Brief adds dynamic context on top: decision history, customer personas, strategic constraints.
What MCP tools does Brief provide?
search, get_document, create_document, record_decision, search_decisions, guard_approach, get_product_context, list_personas, list_features. See full list →
Does Brief work with Claude Desktop too?
Yes. Add Brief to your claude_desktop_config.json. Same context, different interface. Setup instructions →
Make Claude Code Product-Aware
CLAUDE.md tells Claude Code how to code. Brief tells it why. One command to connect.