Quick Start Guide
Get from zero to your first brief in 5 minutes. Two steps, then data.
What is Circuit?
Circuit transforms customer feedback into engineering specs. The flow is simple:
Feedback in → Priorities → Specs out → Ship → Notify customers
The 4-Stage Pipeline
- Feedback - Import from CSV, Slack, Google Sheets, Widget, API or manual entry
- Priority - Groups and ranks by volume, sentiment, urgency
- Brief - Generate engineering specs with one click
- Notify - Tell customers when you ship
Step 1: Import your feedback sources
Pick the sources where customer feedback lives:
| Source | Best For |
|---|---|
| CSV Upload | Migrating existing feedback (NPS, surveys, support exports) |
| Slack | Ongoing collection from #feedback or #support channels |
| Google Sheets | Importing from spreadsheets |
| Widget | Collecting feedback directly from your website |
| Manual Entry | Quick one-off feedback |
You can always add more sources later.
Step 2: Connect GitHub
- Select your repository during setup
- Circuit reads your code structure to suggest real file paths in briefs
That's it. A progress bar tracks each stage: analyzing, ranking, writing briefs. When it finishes, your priorities and briefs appear automatically. No refresh needed.
What happens next
Once feedback is flowing, Circuit:
- Groups similar feedback into priorities
- Ranks them by volume, sentiment, urgency and revenue
- Generates a brief for each priority with 5 sections: What to Build, Why It Matters, Customer Voice, Files to Touch and Done When
Go to the Priorities page to see your ranked list. Click any priority to read its brief.
A quick walkthrough highlights priorities, filters, briefs and key actions the first time through.
Connect Cursor or Claude Code via MCP
Work directly from your coding tool without copy-paste. Install via circuit-mcp on npm.
Cursor: Add to ~/.cursor/mcp.json:
{"mcpServers": {"circuit": {"command": "npx", "args": ["circuit-mcp"]}}}
Claude Code: Run:
claude mcp add circuit -- npx circuit-mcp
Then ask your coding tool: "What are my top priorities?" or "Implement the brief for [priority name]."
When you're done building, click Mark as Shipped and Circuit notifies your customers automatically.
Theme
Circuit follows your OS preference automatically. If your system is set to dark mode, Circuit starts in dark mode. Switch between Light, Dark and System themes anytime using the toggle in the header.
Need help? Email support@withcircuit.com