Docs

Get started

Quick Start Guide to Circuit

Feedback inImportPrioritiesRankSpecsGenerateShip + Close the loopNotify

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

  1. Feedback flows in from your channels (Slack, Surfaces, CSV, Google Sheets, transcripts, manual entry)
  2. Circuit groups it into themes and ranks them by volume, urgency, sentiment and revenue impact
  3. A build spec generates for each priority — 5 sections, codebase-aware if you connect GitHub
  4. You ship. Circuit notifies the customers whose feedback drove it
  5. 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.

  1. Go to Settings → Integrations → GitHub
  2. 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

  1. Go to Settings → Integrations → Slack
  2. Click Connect and authorize
  3. Select channels (e.g. #customer-feedback, #support)

Circuit polls every 10 minutes. Forwarded emails are parsed automatically.

Surfaces

  1. Go to Settings → Integrations → Surfaces
  2. Choose a surface type (Float is the quickest to set up)
  3. 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

  1. Go to Settings → Integrations → Import
  2. Upload a .csv file with a feedback text column
  3. Map columns, preview, import

Good for: NPS exports, support ticket exports, survey responses.

Google Sheets

  1. Go to Settings → Integrations → Google Drive
  2. Click Connect and authorize
  3. Select a spreadsheet and map the feedback column

Good for: Support exports in Sheets, NPS data, bulk historical feedback.

Transcripts

  1. Go to Settings → Integrations → Import
  2. Click Upload transcript
  3. 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:

SectionWhat it contains
What to BuildOne clear task statement
Why It MattersWho's affected and revenue context
Customer VoiceReal quotes from feedback
Files to TouchSuggested file paths from your codebase (requires GitHub)
Done WhenExit 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:

  1. Open the spec and click Mark as Shipped
  2. The Share Back dialog opens — review the recipient list (customers whose email is on file from any feedback source)
  3. Choose a channel: email, surface banner, or both
  4. 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

Can't find what you're looking for?

Contact support