Quick Start Guide to Circuit
What is Circuit?
Circuit is the product intelligence layer between customer feedback and your codebase. It collects feedback from wherever your customers talk — Slack, your website, support transcripts, CSV exports — groups it into ranked priorities and writes codebase-aware product specs for each one. Specs reference your actual codebase, so engineers know exactly what to build and where.
When you ship, Circuit notifies the customers whose feedback drove the feature. Their next message starts the next spec.
Why it helps
Most teams already have the feedback. The problem is what happens to it: buried in Slack threads, spread across spreadsheets, lost between support and product. Turning it into a decision takes days. Turning a decision into a spec takes hours. Circuit compresses both into minutes.
- Feedback from 6 sources flows into one ranked list
- Priorities scored by volume, urgency, sentiment and revenue impact
- Specs generated with real file paths from your codebase
- Customers hear back when their request ships
The loop closes automatically. New feedback on a shipped feature starts a V2 spec.
How to get started
Feedback in → Priorities → Specs out → Ship → Share back
- Feedback flows in from your channels (Slack, Surfaces, CSV, Google Sheets, transcripts, manual entry)
- Circuit groups it into themes and ranks them by volume, urgency, sentiment and revenue impact
- A build spec generates for each priority — 5 sections, codebase-aware if you connect GitHub
- You ship. Circuit notifies the customers whose feedback drove it
- New feedback on that theme starts the next cycle automatically
Step 1: Set up your account
During onboarding you will be asked:
- Your role — Founder, Product Manager, Engineer or Designer
- How you found Circuit — optional, just curious
- Your product in a sentence — if you don’t have a public website for Circuit to scrape, describe your product in one sentence. Circuit uses this to generate relevant specs. You can also set or update this in Settings → Team & Account at any time.
Step 2: Connect GitHub (recommended)
Without GitHub, specs are generated but the Files to Touch section is omitted.
- Go to Settings → Integrations → GitHub
- Click Connect and select your repository
Circuit reads 9 signals from your repo — all read-only. Specs immediately start referencing real paths and following your team’s coding conventions.
Step 3: Bring feedback in
Pick at least one source. You can add more later. Minimum 10 items for meaningful priorities.
Always-on sources
Circuit collects continuously once connected — no manual imports needed.
Slack
- Go to Settings → Integrations → Slack
- Click Connect and authorize
- Select channels (e.g.
#customer-feedback,#support)
Circuit polls every 10 minutes. Forwarded emails are parsed automatically.
Surfaces
- Go to Settings → Integrations → Surfaces
- Choose a surface type (Float is the quickest to set up)
- Copy the embed code and paste before
</body>on your site
Feedback arrives in real time.
Import sources
One-time or recurring imports from files and spreadsheets.
CSV
- Go to Settings → Integrations → Import
- Upload a
.csvfile with a feedback text column - Map columns, preview, import
Good for: NPS exports, support ticket exports, survey responses.
Google Sheets
- Go to Settings → Integrations → Google Drive
- Click Connect and authorize
- Select a spreadsheet and map the feedback column
Good for: Support exports in Sheets, NPS data, bulk historical feedback.
Transcripts
- Go to Settings → Integrations → Import
- Click Upload transcript
- Paste content or upload from Google Drive
Supports Otter.ai, Fireflies, Grain and Whisper formats. Up to 25 feedback segments extracted per call.
Manual entry Click + Add in the top nav and paste feedback directly. Good for one-offs or testing.
Step 4: See your priorities
Once feedback is imported, Circuit classifies and groups it automatically. Go to the Priorities page.
- Priorities are ranked by the User Growth lens by default
- Switch lenses (Revenue Growth, Retention Risks, Bug Fixes, etc.) using the dropdown
- Each priority shows volume, type, trend and a NEW badge if it appeared in the last 7 days
- Click any priority to open its spec
Step 5: Read a spec
Every spec has 5 sections:
| Section | What it contains |
|---|---|
| What to Build | One clear task statement |
| Why It Matters | Who's affected and revenue context |
| Customer Voice | Real quotes from feedback |
| Files to Touch | Suggested file paths from your codebase (requires GitHub) |
| Done When | Exit criteria |
Click Copy to grab the full spec and paste into Cursor, Claude Code or any editor.
Step 6: Connect Cursor or Claude Code (optional)
Pull priorities and specs directly into your editor without copy-pasting.
Cursor — run once:
npx circuit-mcp setup
Claude Code — run once:
claude mcp add circuit -- npx circuit-mcp
First run opens a browser for OAuth. Then ask: "What are my top priorities?" or "Get the spec for [priority name]."
Step 7: Ship and close the loop
When a feature is done:
- Open the spec and click Mark as Shipped
- The Share Back dialog opens — review the recipient list (customers whose email is on file from any feedback source)
- Choose a channel: email, surface banner, or both
- Send
Customers get notified. The spec moves to Shared. New feedback on that theme feeds into a V2 spec automatically.
What's next
- Add your team — Settings → Team → Invite
- Set up more channels — Slack, Surfaces, Transcripts, API
- Connect MCP — work from Cursor or Claude Code without leaving the editor
- Questions? Email support@withcircuit.com