User Guide

Everything you need to master Clarion

From importing your first signals to shipping AI-generated specifications.

v2.0March 2026~40 min read

Quick Start Guide

Get up and running in under 10 minutes. This walkthrough covers account creation, importing your first signals, and asking your first AI-driven question.

  1. 1

    Create Your Account

    Navigate to getclarion.in/signup. Enter your name, email, and password — or click Continue with Google for single-sign-on. You can also join via an invite link from a teammate.
  2. 2

    Choose Your Plan

    During sign-up you’ll select an intent: Starter (free — limited PRDs and specs), Essentials ($39/editor/mo — signals, AI intelligence, limited recommendations), Pro ($59/editor/mo — full platform with Agent Bridge and unlimited queries), or Enterprise (custom — unlimited everything, SSO, SCIM, dedicated CSM). You can upgrade any time from Settings → Billing.
  3. 3

    Organization Setup

    Create or join your organization. The onboarding wizard on the Dashboard walks you through connecting your first integration and importing a CSV of signals.
  4. 4

    Invite Your Team

    Head to Settings → Team and invite colleagues via email. Each invitation carries a role (Owner, Admin, Member, or Viewer). Pro plans can assign Pro seats to individual members. You can also create shareable invite links for bulk onboarding.
  5. 5

    Import Your First Signals

    Go to Settings → Integrations and upload a CSV of customer feedback, connect a webhook, or set up a direct integration with Zendesk, Intercom, Gong, Amplitude, Slack, or GitHub.
  6. 6

    Let the AI Work

    Clarion’s AI pipeline automatically classifies each signal, extracts themes and entities, scores sentiment and importance, and generates vector embeddings for semantic search. Watch progress on the Dashboard.
  7. 7

    Explore Insights and Build

    Use the Signals dashboard to deep-dive into imported signal data, the Insights Dashboard to discover patterns, the What to Build? engine for AI recommendations, and Spec Studio to turn decisions into agent-consumable specifications.

Ask "What Should We Build?"

Once your signals are processed, go to What to Build? in the sidebar. Type a question like “What should we build next?” and Clarion returns ranked, evidence-backed recommendations with customer quotes, revenue impact, and confidence levels.

AI-Powered
The “What to Build?” engine uses semantic search across all your signals, combines it with opportunity data and competitive intelligence, and uses Clarion AI reasoning to generate prioritized recommendations — never hallucinated, always evidence-backed.

Core Concepts

Clarion’s data model follows a pipeline that progressively refines raw customer feedback into shippable product decisions. Understanding these four entities is key to using the platform.

Signals

The atomic unit — a single piece of customer feedback: a support ticket, interview snippet, NPS response, analytics event, or feature request. Signals carry metadata about their source, customer, category, and processing status.

Insights

AI-extracted patterns from signals. Each insight has a category (feature request, bug, churn risk, etc.), sentiment score, importance score, extracted themes, and named entities. Insights are linked back to their source signal.

Opportunities

Actionable product decisions synthesized from clusters of related insights. An opportunity has a title, description, evidence (linked signals/insights), scores from PM frameworks (RICE, ICE, MoSCoW, Value-Effort), and a status that moves through the Kanban board.

Specifications

Dual-audience documents generated from opportunities: a human-readable PRD for stakeholder alignment, and a machine-verifiable spec with acceptance criteria, API contracts, and test scenarios that coding agents can directly consume.

The Pipeline

The complete flow from customer voice to shipped code:

  • Ingest — Signals arrive via CSV, webhook, or integration sync.
  • Process — Clarion AI automatically classifies, extracts themes, scores sentiment, computes importance, and generates vector embeddings.
  • Synthesize — The AI engine clusters related insights into opportunities and scores them with PM frameworks.
  • Decide — The “What to Build?” engine recommends priorities. The Knowledge Explorer lets you ask questions against your entire dataset.
  • Specify — Spec Studio generates PRDs and machine specs with agent artifacts (.cursorrules, tasks.json, test scenarios, agents.md).
  • Ship — Agent Bridge exposes specs via MCP, pushes artifacts to GitHub, and exports to Jira/Linear.
  • Measure — Feature-opportunity linking tracks outcomes, the learning system calibrates future recommendations, and the executive dashboard reports ROI.

Onboarding & Getting Started WizardEssentialsProEnterprise

When you first log in, Clarion guides you through a 4-step interactive onboarding wizard so your team is productive from day one.

The Four Steps

  1. 1

    Welcome & Overview

    A quick product tour showing Clarion’s core value proposition — how signals become insights, opportunities, specifications, and shipped features. Includes an animated walkthrough of the complete data pipeline.
  2. 2

    Connect Your Data

    Choose how to get signals into Clarion: CSV Upload (quickest — drag and drop a file), Zendesk/Intercom/Gong (live integrations), or API/Webhook (custom pipelines). You can connect multiple sources.
  3. 3

    Set Up Product Hierarchy

    Define your product structure: create products, add feature areas, and map your team’s vocabulary. This hierarchy powers AI classification — signals auto-route to the right product area. You can also skip this step and let the AI suggest a hierarchy after processing your first signals.
  4. 4

    Interactive Tour

    A spotlight-based guided tour that highlights each section of the interface — sidebar navigation, signal feed, intelligence dashboard, and AI chat. Clickable hotspots explain each feature in context. Dismiss at any time; replay from Settings → General.

Getting Started Checklist

After the wizard, the Dashboard shows a persistent Getting Started Checklist with progress tracking. Items include: connect your first integration, import 50+ signals, review AI insights, explore an opportunity, generate your first spec, and invite a teammate. Items auto-complete as you perform each action. Dismiss the checklist once you’re comfortable.

Tip

You can re-launch the onboarding wizard at any time from the Dashboard’s Quick Actions panel or from Settings → General.

DashboardEssentialsProEnterprise

Your command center — a real-time summary of product intelligence with quick actions and an onboarding guide for new users.

Overview Cards

The top of the dashboard shows four metric cards:

Total Signals

Running count of all ingested signals, with a trend indicator comparing to the previous period.

Open Opportunities

Active opportunities awaiting prioritization or specification, with an average priority score.

Active Specs

Specifications currently in progress — from draft PRDs to machine specs ready for agents.

Avg. Sentiment

Aggregate sentiment score across all signals, scaled from −1 (very negative) to +1 (very positive).

Product Signal Map

A visual heatmap showing which product areas are receiving the most feedback. Color intensity indicates signal volume; hover for sentiment breakdown.

Quick Actions

Buttons for the most common tasks: Import Signals, Ask AI, Create Opportunity, and Generate Spec. New users also see the Onboarding Wizard — a guided 5-step checklist (connect integration, import data, review insights, explore opportunities, generate first spec).

Executive DashboardEssentialsProEnterprise

A leadership-ready overview of your product intelligence — KPIs, trends, risk alerts, team activity, and shareable reports designed for stakeholder presentations and board reviews.

KPI Stat Cards

The top row shows high-level metrics with trend arrows (up/down/flat compared to the previous period): total signals ingested, average sentiment score, unique customers reporting, and top emerging themes. Each card is clickable and drills down into the relevant detail page.

Signal Trends & Sentiment

Signal Volume Trends

Line chart showing signal ingestion volume over time. Toggle between daily, weekly, and monthly views. Filter by source or category.

Sentiment Heatmap

A grid heatmap showing sentiment intensity by product area and customer segment. Quickly spot which areas are trending negative.

Category Trends

Stacked area chart showing how signal categories (feature requests, bugs, churn risk) are evolving over time.

Feature Velocity

Track how many features are moving through your pipeline from opportunity to shipped, with average cycle time.

Risk Alerts Panel

AI-detected anomalies and risks appear here: churn risk clusters, negative sentiment spikes, competitor mention surges, and unresolved high-priority opportunities. Each alert links to the relevant detail page for deeper investigation.

Customer Intelligence

Top customers ranked by ARR with their satisfaction trajectory. Segment-level sentiment comparison. Identify at-risk accounts before they churn.

Team Activity Feed

Recent team actions: specs created, opportunities moved, signals reviewed, insights shared. Helps leaders understand team engagement and workload distribution.

Top Opportunities Panel

The highest-priority opportunities with their evidence strength, customer count, and ARR impact. One-click to open any opportunity or generate a spec directly from the executive view.

Export & Presentation Mode

Presentation Mode

Click “Present” to enter a full-screen, slide-by-slide view of the executive dashboard. Perfect for all-hands meetings, board reviews, and leadership standups. Navigate with arrow keys.

Export Options

PDF — downloadable executive summary.
PowerPoint — auto-generated slide deck with all charts and data.
Share Link — generate a public read-only link for external stakeholders (see Shared Reports).

Spec TranslatorStarterEssentialsProEnterprise

Convert any human-readable PRD into a machine-verifiable specification that AI coding agents can execute — completely free, no sign-up required.

How It Works

  1. 1

    Paste Your PRD

    Navigate to /translate (or click “Spec Translator” on the landing page). Paste any product requirements document, user story, or feature brief into the editor. Supports plain text, markdown, and rich text.
  2. 2

    AI Translation

    Click “Translate to Machine Spec”. The AI produces a SPEC.md — every vague requirement is quantified: “fast” becomes “< 200ms p95”, “responsive” becomes specific breakpoints, “secure” becomes OWASP compliance requirements.
  3. 3

    Download & Use

    Copy the generated SPEC.md or download it. Drop it into your project directory and point Cursor, Claude Code, or Bolt at it — the coding agent knows exactly what to build, with testable acceptance criteria for every requirement.
AI-Powered
The Spec Translator is available at /translate and works without authentication. It’s the free entry point to Clarion — users who try the translator often upgrade to Pro for the full signal-to-spec pipeline.

What Gets Translated

Human Spec SaysMachine Spec Outputs
"The page should load fast"< 200ms p95 latency, < 3s LCP
"Responsive on all devices"Layout adapts at 640px, 768px, 1024px, 1440px breakpoints
"Handle errors gracefully"Try-catch on all async ops, user-facing toast on failure, retry 3x with backoff
"Secure authentication"OWASP Top 10, bcrypt(12), 100 req/min rate limit, CSRF tokens
"Good test coverage"≥ 80% line coverage, all edge cases in spec tested, E2E for critical paths

Signal CollectorEssentialsProEnterprise

Signals are the raw customer data that powers everything in Clarion — feedback, support tickets, feature requests, interview notes, NPS responses, and more.

Signal Feed

The main Signals page shows a real-time feed of all ingested signals. Each card displays the source icon, customer name, content preview, category badge, sentiment indicator, and timestamp.

Search & Filter

Full-text search across signal content. Filter by category (Feature Request, Bug Report, Churn Risk, etc.), source, date range, segment, and sentiment polarity.

Auto-Enrichment

Toggle automatic AI enrichment — new signals are immediately classified, themed, and scored by the Intelligence Engine.

Signal Detail

Click any signal to see the full raw content, AI-extracted metadata (category, themes, sentiment, urgency, emotions, key quote), customer information, and links to derived opportunities or insights.

Signal Fields Reference

Every signal contains these core fields:

FieldRequiredDescription
titleYesShort summary of the feedback (max 500 chars)
rawContentYesFull feedback text
sourceTypeYesOrigin: csv, webhook, zendesk, intercom, gong, amplitude, manual
categoryNoAuto-classified: feature_request, bug_report, ux_feedback, praise, churn_signal, support_question, competitive_intel
customerNameNoName of the customer who gave the feedback
customerEmailNoCustomer email — used for matching
customerCompanyNoCompany name
customerArrNoAnnual recurring revenue (USD)
sourceMetadataNoJSON object with source-specific fields (ticket ID, channel, tags, etc.)

Importing Signals

CSV Import — Go to Signals → Import CSV for the multi-step import wizard. Upload, map columns, preview, and confirm. Your CSV should have a header row — Clarion recognizes these column names (case-insensitive):

example.csv
title,rawContent,customerName,customerEmail,customerCompany,customerArr
"Need dark mode","Our entire team works late and the bright UI is painful","Jane Smith","jane@acme.com","Acme Corp",120000
"API rate limiting","Getting 429s when syncing more than 100 records","Bob Lee","bob@widgets.io","Widgets Inc",45000

Note

CSV Limits: Maximum file size 5 MB, maximum 1,000 rows per upload. Signals with identical rawContent within 24 hours are automatically skipped (duplicate detection). Processing typically completes within 30–60 seconds per signal.

Integrations (Live Sync) — Connect third-party platforms for continuous signal ingestion. Navigate to Settings → Integrations to configure:

IntegrationSignal TypesSync
ZendeskSupport tickets, customer conversationsReal-time webhook
IntercomChat messages, survey responsesReal-time webhook
GongCall transcripts, meeting notesPeriodic polling
SlackChannel messages, feedback threadsReal-time webhook
GitHubIssues, PR comments, discussionsWebhook
AmplitudeProduct analytics events, user behavior dataPeriodic import

Webhook & API — Create custom webhook endpoints to receive signals from any external system.

  1. 1

    Create a Webhook

    Navigate to Settings → Webhooks. Give it a name (e.g., “Typeform Feedback”) and optionally restrict accepted source types. Clarion generates a unique URL and a signing secret.
  2. 2

    Configure Your Source

    Point your external system to the generated URL. Include the signing secret as an X-Webhook-Secret header for HMAC verification.
  3. 3

    Send Signals

    POST a JSON payload matching the signal schema. Clarion validates, enqueues, and processes each signal automatically.
POST /api/v1/webhooks/:id/ingest
{
  "title": "Feature request from Typeform",
  "rawContent": "I wish I could export reports as PDF...",
  "sourceType": "webhook",
  "customerName": "Alice Chen",
  "customerEmail": "alice@example.com",
  "sourceMetadata": {
    "formId": "abc123",
    "submittedAt": "2026-02-15T10:30:00Z"
  }
}

Note

Clarion signs every expected payload with your webhook secret using HMAC-SHA256. Include the secret in the X-Webhook-Secret header. Requests with missing or invalid signatures are rejected with a 401 status.

Signal Reprocessing

If classification results seem off — or after you’ve corrected enough items in the Review Queue for the system to learn — you can trigger Reprocessing on individual signals or in bulk. This re-runs the AI pipeline (classification, theme extraction, sentiment) on selected signals with the latest model context. Access via the signal detail page’s “Reprocess” button or through the bulk actions toolbar.

Tip

You can bulk-import up to 10,000 signals at once using the POST /api/v1/signals/bulk-import endpoint. The processing queue handles them asynchronously.

AI Intelligence EngineEssentialsProEnterprise

The multi-stage AI processing pipeline that transforms raw signals into structured, actionable intelligence — classification, theme extraction, sentiment analysis, and anomaly detection. The pipeline runs asynchronously in the background — you import data and Clarion AI handles the rest.

How Processing Works

Every signal that enters Clarion goes through a multi-stage AI pipeline:

  1. 1

    Classification

    AI assigns the signal to one of six categories. A confidence score (0–1) is attached; low-confidence items go to the review queue.
CategoryDescriptionExample
Feature RequestCustomer asks for new functionality"We need a bulk export option"
Bug ReportSomething is broken or not working"Login fails on Safari when using SSO"
QuestionHow-to or troubleshooting inquiries"How do I set up webhook authentication?"
PraisePositive feedback about existing features"The new dashboard is exactly what we needed"
ComplaintDissatisfaction with current experience"The settings page is hard to navigate"
Churn RiskIndicators of potential customer loss"We're evaluating alternatives because..."
  1. 2

    Theme & Entity Extraction

    1–3 theme labels are extracted (e.g., “Dashboard Performance”, “Export Functionality”). Products, features, and competitor mentions are identified. A key representative quote is selected.
  2. 3

    Sentiment & Urgency Scoring

    Sentiment ranges from −1 (very negative) to +1 (very positive). Urgency from 1 (informational) to 5 (critical/blocking). Emotions are tagged (frustration, excitement, confusion, etc.).
  3. 4

    Importance Scoring

    Signals are scored 1–10 for importance based on urgency, customer ARR, frequency of similar requests, and business impact. Importance scores feed into opportunity prioritization and the “What to Build?” engine.
  4. 5

    Vector Embeddings and Indexing for Semantic Search

    Clarion AI generates high-dimensional vector embeddings for every signal and insight. These embeddings power semantic search — search by meaning, not just keywords. Vectors are indexed for sub-millisecond retrieval. This powers the Knowledge Explorer, “What to Build?” recommendations, and opportunity clustering.

Insights Dashboard

The Insights page shows the output of the Intelligence Engine in visual form:

Category Distribution

Horizontal bar chart breaking down signals by type. See at a glance whether your feedback is mostly feature requests, bugs, or churn risks.

Sentiment Trend

Line chart showing average sentiment over the last 30/60/90 days. Spot negative trends early before they become churn problems.

Top Themes

Ranked list of the most frequently occurring themes. Click any theme to see all related signals, sentiment breakdown, and revenue impact.

Anomaly Alerts

AI-detected spikes, unusual sentiment shifts, or sudden surges in churn-risk signals. Get notified before problems escalate.

Theme Detail View

Click any theme from the Insights dashboard to open its detail page. You’ll see a sentiment breakdown for that theme (positive/neutral/negative split), segment distribution (which customer groups care most), revenue impact (total ARR of customers mentioning this theme), a 30-day trend chart, and a scrollable list of all linked signals. Use this to go deep on any specific product concern.

Anomaly Detail View

When the system detects an anomaly, click to see its detail page. Anomaly types include volume spikes (sudden surge in a theme), sentiment drops (sharp negative shift), and new theme emergence (a previously unseen pattern). Each anomaly shows the triggering data, comparison against historical baselines, affected signals, and suggested investigation actions.

Review Queue

When the AI classifies a signal with confidence below 70%, it lands in the Review Queue (accessible from the Insights page). Each item shows the signal content, the AI’s proposed classification, and its confidence. You can confirm or override the category — corrections train the system over time.

AI-Powered
All AI processing uses Clarion AI for fast operations (classification, extraction) and Clarion AI Pro for complex reasoning (opportunity generation, spec writing). Every call includes retry logic, cost tracking, and structured output validation.

Clarion AI Tiers

TierAvailable OnUsed For
Clarion AIFree + ProClassification, theme extraction, sentiment analysis, summaries
Clarion AI ProPro onlyPRD generation, What to Build recommendations, machine spec generation
Vector EmbeddingsPro onlySemantic search powered by advanced AI embeddings

Note

Your data is never used to train AI models. All AI processing is per-organization — your data is never mixed with another organization’s data.

Knowledge ExplorerEssentialsProEnterprise

A conversational AI interface for open-ended exploration of your product data. Ask anything about your customers, signals, trends, insights, opportunities, specifications or competitive landscape.

How to Use It

Navigate to Knowledge Explorer in the sidebar. You’ll see a full-screen chat interface. Type any question in the input area at the bottom:

“What do customers say about our onboarding?”

Returns a themed summary with specific quotes, sentiment breakdown, and signal count.

“Compare enterprise vs SMB feedback”

Generates a side-by-side comparison table with segment-specific themes and sentiment.

“Has sentiment about billing improved?”

Shows a time-series analysis with trend indicators and supporting evidence.

“Show me all feedback from Acme Corp”

Deep-dives into a single customer with their complete feedback history and themes.

Capabilities

  • Natural language queries — “What are our top-requested features this quarter?” “How do enterprise customers feel about our API?” “Which competitors offer real-time sync?”
  • Multi-entity search — Semantic search across signals, insights, opportunities, specs, and competitors simultaneously. Results are ranked by relevance.
  • Context-aware responses — The AI is aware of your org’s product hierarchy, customer segments, opportunity scores, and competitive landscape.
  • Rich responses — AI responses include inline data tables for comparisons, mini charts for trends, clickable customer names (navigate to customer view), and citation markers linking to source signals. The system always cites specific data — “23 customers mentioned this” rather than “several customers.”
  • Charts and visualizations — The AI can generate opportunity comparison charts and data visualizations inline in the conversation.
  • Conversation history — Conversations are saved automatically. Recent chats appear in the sidebar panel so you can revisit or continue previous explorations. You can also share conversation links with teammates.

Tip

  • Knowledge Explorer is different from “What to Build?” — it’s for open-ended data exploration, whereas “What to Build?” is specifically optimized for prioritized, actionable recommendations.
  • Knowledge Explorer works best when you have at least 50–100 signals in your system. The more data Clarion has, the richer and more accurate the responses.

Competitive IntelligenceEssentialsProEnterprise

Track competitors, compare feature sets, understand your market position, see how customers perceive you vs. alternatives, and discover feature gaps — powered by AI research agents that continuously scan multiple sources. The competitive intelligence database integrates with the Knowledge Explorer — ask “How does our API compare to Competitor X?” and get answers grounded in your data.

Competitor Database

Navigate to Competitors in the sidebar. A grid of competitor cards shows each competitor’s logo, name, mention count, and average sentiment. Click Add Competitor to register a new one — enter the name and website; AI auto-scrapes for a description.

Competitor Detail

Click any competitor to see the detail page with four sections:

Overview

Description, key features, mention trend chart over time.

Mentions

All signals mentioning this competitor, with extracted context and mention type (switching_to, compared_to, came_from, feature_gap).

Feature Comparison

Side-by-side table of your features vs. the competitor’s. Manually curated plus AI suggestions based on signal analysis.

Win/Loss Signals

Signals where customers chose you over them (wins) or vice versa (losses). Critical intelligence for sales and product strategy.

AI Research Agents

AI-Powered
Clarion’s competitive research agents scan multiple sources — customer signals, public reviews, social media, and market data — to build and update competitive intelligence profiles. Agents produce SWOT analyses, feature gap reports, and market positioning insights.
Report TypeWhat You Get
Competitor ProfileDeep dive on a single competitor — features, pricing, strengths, weaknesses, customer perception
Head-to-HeadYour product vs. one competitor — feature comparison, sentiment analysis, win/loss patterns
Multi-CompetitorCompare 3+ competitors simultaneously with a comparison matrix and positioning map
Market LandscapeFull market overview — all tracked competitors with market positioning, trends, and whitespace
Custom QueryAsk any competitive question and get a researched answer

Research Report Viewer

Each completed research report opens in a structured viewer with an executive summary, detailed findings with comparison tables, SWOT analysis, signal correlations (linking competitive insights back to your customer data), and recommended actions. Reports can be shared with teammates or exported.

Competitor Mention Tracking

Whenever a new signal mentions a known competitor, Clarion automatically creates a CompetitorMention record, classifies the mention type (switching_to, compared_to, came_from, feature_gap), and feeds the data into “What to Build?” recommendations and spec generation context.

Adaptive Taxonomy EngineEssentialsProEnterprise

An auto-evolving category hierarchy that grows with your product. As new themes emerge and signal volume grows, the taxonomy engine continuously analyzes themes, suggests merges, splits, and suggests structural improvements to your categorization system.

How It Works

The AI continuously monitors incoming signals and identifies when the taxonomy needs updating. Navigate to Taxonomy in the sidebar to view the current category tree. Each node shows its name, signal count badge, and sentiment indicator. Click any node to open the Taxonomy Node Detail page — see the breadcrumb path, child nodes, all linked signals, and a 30-day trend chart showing signal volume for that category. A sunburst visualization provides an alternative hierarchical view where ring segments represent category depth and size indicates signal volume.

Merge Suggestions

Two categories are semantically similar and could be combined (e.g., “Loading Speed” + “Performance Issues” → “Performance”).

Split Suggestions

A category is too broad and should be split (e.g., “Integrations” → “Data Export” + “Third-party Connectors”).

OperationDescriptionAuto-Applied?
CREATENew category for emerging themes with no existing matchYes
MERGECombine two similar categories into oneNo — requires review
SPLITDivide an overly broad category into sub-categoriesNo — requires review
ARCHIVERetire categories with declining signal volumeNo — requires review

Hierarchy

The taxonomy supports up to 5 levels of nesting. Visualize your taxonomy as an interactive tree or treemap view. The tree view shows parent-child relationships and signal counts at each level.

Review Queue

MERGE, SPLIT, and ARCHIVE proposals enter a review queue. Team members can approve, reject, or modify proposals before they take effect. CREATE proposals are auto-applied since they add new categories without affecting existing data.

Segment ComparisonEssentialsProEnterprise

Compare customer segments side-by-side to understand how different groups experience your product.

Using Segments

Navigate to Segments in the sidebar. Select two or more segments to compare (e.g., Enterprise vs. SMB, or North America vs. EMEA). The comparison view shows:

  • Sentiment comparison per segment
  • Top themes for each segment, ranked by frequency
  • Category breakdown (feature requests vs. bugs vs. churn risk)
  • Revenue impact (total ARR) for each segment’s signals
  • Unique themes that appear in one segment but not the other

Tip

Segment comparisons are particularly valuable for “What to Build?” queries — to get segment-specific recommendations. Ask: “What do enterprise customers want that SMB customers don’t?”

Integration Points

  • What to Build — Filter recommendations by segment.
  • Knowledge Explorer — Ask segment-specific questions (e.g., “What do enterprise customers want?”).
  • Signal Feed — Filter the feed by segment to focus on specific customer cohorts.
  • Digest Reports — Segment-aware digest summaries.

Trend & Anomaly DetectionEssentialsProEnterprise

Clarion continuously monitors your signal data for statistically significant deviations from normal patterns. When anomalies are detected, you are notified immediately.

Detection Types

  • Volume spikes — Sudden increase in signal volume for a specific category or theme, detected using statistical analysis.
  • Sentiment drops — Statistically significant decline in customer sentiment across a theme or customer segment.
  • New themes — Emergence of previously unseen topics in customer feedback — potential early indicators of new needs or problems.

Notifications

  • In-app — Bell icon notifications with badge count. Click to see anomaly details.
  • Email — Real-time email alerts to your inbox.
  • Slack — Slack notifications with anomaly summary and link to details.

Anomaly Detail Page

Each anomaly has a dedicated detail page showing the underlying data: the signals that triggered the anomaly, historical baseline comparison, affected customers, and suggested actions.

Opportunity CanvasEssentialsProEnterprise

A Kanban board for managing product opportunities through their lifecycle — from AI-discovered insights to shipped features.

The Board

The Opportunities page shows a drag-and-drop Kanban board with five columns:

ColumnMeaning
IdentifiedNewly discovered opportunities (auto-generated or manually created)
Under ReviewBeing evaluated by the product team
ApprovedApproved for specification and development
In ProgressActive specification or development underway
ShippedFeature has been released

Toggle between Board, List, and Table views using the top bar. Filter by status, product area, priority range, owner, and date.

Opportunity Cards

Each card on the board shows: title, priority score badge, signal count, customer count, ARR impact, owner avatar, and a category color stripe. Drag cards between columns to update status; drag within a column to reorder.

Opportunity Detail

Click an opportunity to open its detail page with four tabs:

Overview

Editable description, AI summary, AI recommendation, RICE/ICE scores, product area, and tags. Regenerate the AI summary at any time.

Evidence

All linked signals/insights with customer quotes and metadata. Use “Find More Related Signals” to discover additional evidence via semantic search.

Specs

Specifications generated from this opportunity. Click “Generate Spec” to create a new PRD and machine spec.

Activity

Full audit log of changes and a comments thread for team collaboration.

Auto-Generation

AI-Powered
Clarion automatically clusters related insights into opportunities using vector similarity. When 3+ signals from different customers describe the same need, a new opportunity is created with an AI-generated title, description, and priority score. This runs hourly and after every bulk import.

Priority Scoring

Each opportunity receives an AI-calculated priority score (0–100) based on five weighted factors:

FactorWeightWhat It Measures
Signal Volume20%How many signals mention this need
Revenue Impact25%Total ARR of affected customers
Sentiment20%How negative the feedback is (negative = higher priority)
Competitor Pressure15%Signals mentioning competitors in this context
Customer Breadth20%Number of unique customers requesting this

Tip

Priority weights are configurable per organization in Settings. Adjust them to match your company’s prioritization philosophy.

What to Build?EssentialsProEnterprise

The heart of Clarion. The “What to Build?” engine analyzes your entire signal corpus and recommends what your team should build next, backed by quantitative evidence and customizable PM frameworks.

How It Works

  • Evidence synthesis: The engine aggregates signals by theme, weighs them by customer ARR, importance score, and recency, and clusters them into opportunity candidates.
  • Framework scoring: Each opportunity is automatically scored using your chosen PM framework — RICE, ICE, MoSCoW, or Value-Effort. Scores are derived from real signal data, not manual estimates.
  • Recommendation generation: Clarion AI Pro synthesizes the top-scored opportunities into a ranked list with reasoning, trade-offs, and suggested next steps.
  • Learning system: As you ship features and measure outcomes, Clarion AI adjusts future recommendations based on historical accuracy.

The Experience

Navigate to What to Build? in the sidebar. You’ll see a spacious chat interface with suggested starter questions: “What should we build next?”, “What features would reduce churn?”, “What are enterprise customers asking for?”, and “What’s our biggest competitive gap?”

Type your question and press Enter. Clarion streams the response in real-time, first showing a thinking indicator (“Analyzing X signals...”), then rendering structured recommendation cards. The chat is context-aware — it knows your signals, insights, opportunities, and competitive landscape.

Multi-Turn Conversations

Follow up with questions like “Tell me more about recommendation #2” or “Which customers are most affected?” The AI maintains conversation context for coherent, deep-dive analysis.

Warning

The quality of recommendations depends directly on signal volume. For best results, import at least 50–100 signals before relying on “What to Build?” for strategic decisions.

Recommendation Cards

Each recommendation includes:

Title & Confidence

Clear recommendation title with a confidence badge: HIGH (20+ signals), MEDIUM (10–19), or EMERGING (3–9).

Evidence Summary

“47 signals from 23 customers ($4.2M ARR)” — always specific, never vague. Includes a priority score bar.

Customer Quote

A real, attributed quote from your signal data: “We’d pay double for real-time sync” — VP Product at Acme Corp

Actions

Create Opportunity — one click to turn a recommendation into a tracked opportunity. Follow-up question chips at the bottom for deeper exploration.

Data Quality Badge

Every response includes a data quality note at the bottom: “Based on 342 signals from 89 customers (Jan–Feb 2026)”. If data is insufficient, the AI says so clearly — it never fabricates evidence.

PM Frameworks

Each opportunity is automatically scored using your chosen PM framework. Scores are auto-derived from signal data — not manual estimates:

FrameworkFactorsBest For
RICEReach × Impact × Confidence / EffortData-driven teams with good usage metrics
ICEImpact × Confidence × EaseFast prioritization with less data
MoSCoWMust / Should / Could / Won'tStakeholder alignment and requirement triage
Value-EffortBusiness Value / Implementation EffortQuick 2×2 mapping for sprint planning

Reach comes from customer count and ARR, Impact from sentiment and importance scores, Confidence from signal volume, and Effort from complexity indicators in the feedback. Switch frameworks any time from the Opportunity Board settings.

Segment Filtering

Filter recommendations by customer segment to see what different cohorts want. “What should we build for Enterprise customers?” vs. “What do SMB users need most?” Segment-aware analysis prevents one-size-fits-all roadmaps.

Opportunity ValidationEssentialsProEnterprise

Validate opportunities directly with customers before investing in specifications and development. Run lightweight survey campaigns to measure demand confidence.

Creating a Validation Campaign

  1. 1

    Select an Opportunity

    Navigate to Opportunity Validation in the sidebar. Click “New Campaign” and select the opportunity to validate.
  2. 2

    Design the Survey

    Define 3–5 quick questions: problem severity, willingness to pay, feature importance ranking. Clarion suggests questions based on opportunity data.
  3. 3

    Target Audience

    Choose which customers to survey — all who submitted signals for this opportunity, a specific segment, or a custom list.
  4. 4

    Review Results

    Responses roll in with a confidence score — a statistical measure of how validated the opportunity is. High confidence means strong product-market signal.

Survey Question Types

The survey builder supports five question types for maximum flexibility:

TypeUse Case
Multiple ChoiceFeature preference, priority selection, categorical choices
Open TextFree-form feedback, feature descriptions, pain point details
Scale / NPSSatisfaction scores (1–10), likelihood to recommend, severity ratings
RankingPriority ordering of features, importance ranking
ConfirmationYes/No validation of a specific hypothesis or need
AI-Powered
Click “Generate Questions” and the AI will analyze the opportunity’s linked signals to suggest 3–5 contextually relevant survey questions. Edit them or use as-is.

Campaign Methods

Choose how to reach participants: Email Only (send survey link via email), Email + Survey (inline questions in the email body), or High-Touch (for phone/video calls — manually log responses after conversations).

Participant Selection

Select participants from: all customers who submitted signals for this opportunity, a specific segment, or upload a custom list. The AI can also recommend participants based on who has the most relevant signal history and engagement patterns.

Public Survey Experience

Survey recipients receive a branded link (/validate/[slug]) that opens a clean, public micro-survey page. The survey displays your organization’s logo and brand color (configured in Settings → Branding), presents questions one by one, supports concept images for visual validation, and ends with a customizable thank-you page. No login required for respondents.

Campaign Lifecycle & Analysis

Campaigns move through six stages: Draft ReviewScheduled ActiveAnalyzing Completed. At completion, the AI generates a Validation Report with a recommendation: Proceed, Proceed with Changes, Pivot, Kill, or Needs More Data — each with a confidence percentage and supporting rationale.

Spec StudioStarterEssentialsProEnterprise

Spec Studio is where product decisions become shippable specifications. It generates dual-audience documents — human-readable PRDs for stakeholder alignment and machine-verifiable specs that coding agents (Cursor, Claude Code, Windsurf, v0, Bolt, Lovable) can directly consume.

Specification List

Navigate to Spec Studio in the sidebar. The list page shows all specifications as a table or card view, with columns for title, linked opportunity, status, version, author, and last updated date. Click “Generate New Spec” to begin.

Creating Specifications

There are two ways to create a spec:

  • From an Opportunity (Essentials, Pro, Enterprise) — Select an opportunity and Clarion generates a PRD pre-filled with evidence from linked signals — customer quotes, pain points, and quantitative data.
  • Standalone (Free, Essentials, Pro, Enterprise) — Paste existing PRD text or describe a feature — Clarion structures it into the full PRD format. Free users get Clarion AI; Pro users get Clarion AI Pro for higher quality output.

PRD Editor

Every PRD is editable with a rich text editor. The editor supports:

  • Structured sections — Problem Statement, Goals, User Stories, Requirements, Success Metrics, Risks, Timeline, and more.
  • Inline editing with formatting toolbar (bold, italic, lists, headings, links).
  • Auto-save every 30 seconds with visual save indicator.
  • Version history — revert to any previous version.

The Split-Pane Editor

Left: Human PRD

Rich text editor (Tiptap) with structured sections: Problem Statement, Goals & Metrics, User Stories with acceptance criteria, Proposed Solution, Technical Considerations, Risks, and Timeline. Customer quotes appear as special blocks with signal attribution. An evidence sidebar shows linked signals for each section.

Right: Machine Spec

SPEC.md in markdown format — every requirement quantified, no vague terms. Toggle between rendered preview and raw code view. Validation indicators show green checkmarks on complete requirements and red flags on gaps.

Generation Process

AI-Powered
Step 1: PRD Generation. Click “Generate PRD” — Clarion fetches the opportunity, all linked signals, org context, and product hierarchy, then uses Clarion AI Pro to produce a complete PRD with real customer quotes and evidence-backed sections.

Step 2: Machine Spec Translation. Click “Generate Machine Spec” — the human PRD is translated into a SPEC.md where every vague term is replaced: “fast” → “< 200ms p95”, “responsive” → “layout adapts at 768px, 1024px, 1440px”, “secure” → “OWASP Top 10 compliant, 100 req/min rate limit.”

Step 3: Validation. Click “Validate” — the AI scans for remaining vague terms, missing error handling, incomplete API contracts, and untestable acceptance criteria. Results show inline as gap indicators.

Version Control

Specs auto-save every 30 seconds. Click “Save Version” to create a named checkpoint with an optional change note. The version history panel shows all versions with timestamps — click any to see a diff against the current spec. You can restore any previous version.

Machine Spec Generation

Click “Generate Machine Spec” to translate the PRD into a structured, machine-verifiable specification. Progress is shown in real-time with a phase timeline. If generation is interrupted, it automatically resumes from where it left off.

The machine spec includes:

  • Functional requirements — Detailed specifications with acceptance criteria in Given/When/Then format.
  • API contracts — Endpoint definitions, request/response schemas, error codes, and authentication requirements.
  • Data models — Database schema changes, field types, constraints, and relationships.
  • Test scenarios — Comprehensive test cases covering happy paths, edge cases, error handling, and performance criteria.
  • Non-functional requirements — Performance targets, security requirements, accessibility standards.

Coding Agent Artifacts

After generating a machine spec, you can generate five agent artifacts optimized for AI coding assistants:

ArtifactFilePurpose
Cursor Rules.cursorrulesProject context, tech stack, coding conventions, spec constraints, testing requirements, and implementation guidance for Cursor
Machine SpecSPEC.mdMachine-verifiable specification with numbered requirements, data models, API contracts, and acceptance tests
Agent Guideagents.mdAgent persona definitions — how each AI coding agent should approach the implementation. Architecture overview, file structure, and implementation strategy for any AI agent.
Task Breakdowntasks.jsonStructured task breakdown with dependency ordering, priorities, files to create/modify, effort estimates, estimated complexity and acceptance criteria
Test Scenariosacceptance_tests.spec.tsTypeScript test file (Jest/Vitest) — Comprehensive test plan with scenarios, fixtures, and coverage targets. Each requirement becomes one or more test cases with edge cases.

Download individually or as a ZIP bundle. Preview each artifact before downloading.

Tip

“How do machine specs work without knowledge of my existing architecture?” Clarion’s specifications are self-sufficient by design. The SPEC.md defines exact data models, API contracts, integration points, error cases, and performance targets — it tells the agent precisely what tables to create, what endpoints to expose, and what responses to return. The agents.md defines a 5-agent team (Architect, Backend, Frontend, Testing, Review) with a phased workflow — the Architect agent scans the codebase and defines the foundation (data models, API contracts, component structure) before any implementation begins. Each subsequent agent works within the constraints the Architect defined. Quality gates ensure nothing ships without passing through the full review chain. The spec defines the what at the interface boundary, and the agent artifacts provide the how — the complete implementation strategy, task ordering, and test coverage. Drop the artifacts into any AI coding assistant and they have everything they need to build it, in any tech stack.

Export to Other Tools

From the spec editor, use the “Export for Agents” dropdown to generate and download:

Jira / Linear

Export the task breakdown as issues. Acceptance criteria map to subtasks. Issues link back to the Clarion specification.

GitHub

Push all artifacts to a new branch in your repo. Optionally auto-create a PR with the spec summary as description.

Cursor / Claude Code

Cursor gets an optimized .cursorrules with project context. Claude Code gets a CLAUDE.md with implementation guidance.

v0 / Bolt / Lovable

Copy an optimized prompt to clipboard, formatted for each tool’s requirements.

Word / PDF / Markdown / ZIP

Download as Word (.docx), PDF, Markdown (.md), or a ZIP bundle of all agent artifacts for offline sharing.

GitHub Push

Push generated artifacts directly to a GitHub repository. Clarion creates a new branch, commits all artifact files, and opens a pull request. When the PR is merged, Clarion automatically detects the shipped feature and updates the linked opportunity status.

Validation

Specs are validated for completeness and consistency. The validator checks for missing acceptance criteria, undefined API contracts, inconsistent data models, and untested edge cases. Validation results are shown as warnings that you can address before generating artifacts.

Approval WorkflowsEnterprise

Configure multi-stage approval workflows for specifications, ensuring the right stakeholders sign off before specs move to development. When a spec is submitted for approval, it moves through configured stages with designated approvers.

Setting Up Approval Roles

Navigate to Settings → Workflows to configure your approval pipeline. The workflow visual editor lets you design approval pipelines by dragging and connecting stages. Preview the flow before activating it for your organization. The editor lets you:

Define Approval Stages

Create sequential stages (e.g., “Tech Lead Review” → “PM Approval” → “VP Sign-off”). Each stage requires approval from one or more designated roles before the spec advances.

Parallel Branches

Configure parallel approval branches where multiple reviewers can approve simultaneously (e.g., Engineering Lead AND Design Lead must both approve).

Custom Roles

Define approval roles beyond the default RBAC roles (e.g., “Security Reviewer,” “Legal Counsel”).

Timeouts

Set auto-escalation or auto-approval timers for each stage. If an approver does not respond within the configured window, the system takes the configured action.

Submitting for Approval

From the Spec Studio editor, click “Submit for Approval”. The spec enters the approval pipeline and reviewers are notified. An approval progress bar shows which stages are complete and who’s pending.

Pending Approvals Page

Navigate to Specs → Pending Approvals to see all specs awaiting your review. For each spec, you can: Approve (advance to next stage), Request Changes (send back with comments), or Send Reminder (nudge the assigned reviewer). Comments thread below each spec for reviewer discussion.

Note

Approval workflows are optional and only available on Enterprise plans. They only apply to specs created from opportunities — standalone specs skip the approval process. Without workflows, any Member or Admin can create and publish specs.

Agent BridgeProEnterprise

Agent Bridge connects AI coding agents (Cursor, Claude Code, Claude Desktop, Bolt) directly to Clarion’s intelligence via MCP server and APIs. Instead of copy-pasting specs, your coding agent can query Clarion in real-time.

MCP Server

Clarion exposes a Model Context Protocol (MCP) server that any MCP-compatible client can connect to. The server provides seven tools:

ToolWhat It Does
query_opportunitiesSearch and retrieve product opportunities based on customer feedback
get_specificationGet a complete specification (human PRD + machine spec) for a feature
search_feedbackSearch customer feedback by topic, sentiment, or segment
get_customer_contextGet customer information and their feedback history
what_to_buildAsk what features to build next based on customer data
get_cursorrulesGet .cursorrules file for a specification
get_tasksGet task breakdown for a specification

MCP Configuration

MCP requests are authenticated with API keys. Generate a key in Settings → API Keys. Include it as a Bearer token:

MCP Configuration
{
  "mcpServers": {
    "clarion": {
      "url": "https://getclarion.in/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Agent Bridge UI

The Agent Bridge page in Clarion provides a visual interface for managing MCP connections, testing tool calls, and monitoring agent activity. You can see which specs agents are currently reading and track tool call history.

Setting Up the Connection

  1. 1

    Generate API Key

    Create a dedicated API key for MCP use in Settings → API Keys. This key maps to your organization and controls which data the agent can access.
  2. 2

    Copy Configuration

    Clarion provides ready-to-paste configuration snippets for Cursor (add to .cursor/mcp.json), Claude Desktop (add to claude_desktop_config.json), Claude Code (add to MCP settings), and Bolt.new.
  3. 3

    Test Connection

    Use the “Test Connection” button to verify that the MCP server starts, registers all tools, and can return data.
AI-Powered
With the MCP server connected, your coding agent can ask Clarion: “What are the requirements for the auto-save feature?” and receive the complete machine spec, task breakdown, and acceptance tests — without leaving your IDE.

Usage Logs

The Agent Bridge page shows recent MCP calls — which tools were invoked, when, by which client, and the response times. Monitor how your coding agents are leveraging Clarion’s intelligence.

Feature Impact TrackingEssentialsProEnterprise

Track shipped features, link them back to the opportunities and signals that drove them, and measure their real-world impact.

Features Page

Navigate to Feature Impact in the sidebar. The page lists all tracked features with their name, status (planned, in development, shipped), linked opportunity, ship date, and impact metrics.

Linking Features to Opportunities

When you ship a feature, link it to the opportunity it addresses. This closes the loop — you can now see which customer requests were fulfilled and measure whether the investment was worthwhile.

GitHub Integration

If GitHub is connected, feature status automatically updates based on PR lifecycle:

PR StateFeature Status
PR CreatedIn Development
PR MergedShipped

Outcomes DashboardEssentialsProEnterprise

Measure the ROI of your product decisions. Did the features you shipped actually move the metrics you predicted?

What You’ll See

The Outcomes page connects shipped features to their predicted success metrics from the original PRD. For each feature, you can track:

Predicted vs. Actual

Compare the success metrics defined in the spec (e.g., “reduce support tickets by 30%”) against actual observed outcomes.

Closed-Loop Learning

Post-ship signals are analyzed: did customer sentiment improve in this area? Did the theme volume decrease? The system learns from outcomes to improve future recommendations.

Full Traceability ChainEssentialsProEnterprise

Every decision in Clarion is traceable — from the original customer quote all the way to the shipped feature and its measured outcome.

The Complete Chain

  1. 1

    Signal → Insight

    A customer says “I wish I could export reports as PDF.” The AI classifies this as a Feature Request, extracts the “Export” theme, and links it to other similar signals.
  2. 2

    Insight → Opportunity

    When 3+ signals cluster around the same need, an Opportunity like “PDF Export Functionality” is created with a priority score based on customer count, ARR, and sentiment.
  3. 3

    Opportunity → Specification

    You generate a PRD and Machine Spec from the opportunity. The spec includes direct customer quotes as evidence for each requirement. Push to GitHub with all coding artifacts.
  4. 4

    Specification → Feature

    When the linked GitHub PR is merged, the Feature status updates to “Shipped” automatically. The opportunity moves to the “Shipped” column.
  5. 5

    Feature → Outcome

    Measure whether the feature achieved its goals — did support tickets decrease? Did NPS improve? The learning system records the outcome and improves future recommendations.

On the Feature Detail page, the Traceability Chain visualization shows this entire journey as an interactive flow diagram. Click any node to navigate to that entity. This is what makes Clarion unique — you can always answer “why did we build this?” with evidence.

Closed-Loop Learning

AI-Powered
The learning system tracks whether each shipped feature achieved its predicted outcome. Over time, this feedback loop calibrates the AI’s priority scoring and “What to Build?” recommendations — the system learns which types of opportunities deliver real customer value and adjusts future predictions accordingly.

Settings & Administration

Configure your workspace, manage your team, connect integrations, and control platform behavior.

Team & Roles

Clarion uses role-based access control (RBAC) to manage permissions within your organization.

RolePermissions
OwnerFull access. Manage billing, delete org, transfer ownership. One per org.
AdminManage team, settings, integrations, workflows, and all content. Cannot manage billing or delete org.
MemberCreate and edit signals, insights, opportunities, and specs. Cannot manage team or settings.
ViewerRead-only access to all data. Cannot create, edit, or delete anything.

Invitations

Invite team members from Settings → Team. Each invitation specifies a role. For Pro plans, you can optionally assign a Pro seat to the invited member (giving them access to Pro features). Invitations are delivered via email and expire after 7 days.

You can also create shareable invite links for bulk onboarding. Invite links can be configured with a maximum number of uses and an expiration date.

General Settings

Organization name, logo, default timezone, and global preferences. Configure the product hierarchy (Product → Areas → Features) that’s used by all AI operations for accurate signal classification.

Team Management

Invite team members by email. Four role levels:

RolePermissions
OwnerFull access. Manage billing, delete organization, manage all settings.
AdminManage team members, integrations, and settings. Full data access.
MemberCreate and edit signals, opportunities, specs. Cannot manage team or billing.
ViewerRead-only access to all data. Can comment but not create or edit.

Integrations

Connect and manage all third-party integrations from Settings → Integrations. Each integration shows its connection status, last sync time, and signal count.

Zendesk

  • What syncs: Support tickets (subject, description, priority, status, tags, assignee, channel, via, timestamps).
  • Auth: Secure OAuth. Clarion requests read-only access to tickets.
  • Sync frequency: On-demand or scheduled. Default lookback window is 24 hours.
  • Field mapping: Zendesk subject → signal title, description → rawContent. Priority, status, tags, and timestamps are stored in sourceMetadata.

Intercom

  • What syncs: Conversations (messages, user info, tags, conversation state).
  • Auth: OAuth 2.0. Read-only access to conversations and users.
  • Field mapping: Conversation body → rawContent. User name, email, and company are mapped to customer fields.

Gong

  • What syncs: Call recordings and transcripts. Speaker segments, topics, and action items.
  • Auth: OAuth 2.0. Read-only access to calls and transcripts.
  • Processing: Transcripts are chunked into individual feedback signals based on speaker turns and topic shifts.

Amplitude

  • What syncs: Analytics events, user properties, and cohort data.
  • Auth: API key + secret. Read-only access to event data.
  • Use case: Quantitative signals — feature usage patterns, drop-off points, engagement metrics — complement qualitative feedback from other sources.

GitHub

  • Purpose: Push generated agent artifacts (.cursorrules, tasks.json, test scenarios) directly to a GitHub repository as a new branch and pull request.
  • Auth: GitHub OAuth App. Requires write access to selected repositories.
  • PR webhooks: Clarion listens for PR merge events to automatically detect shipped features and update opportunity status.

Jira

  • Purpose: Export specifications as Jira issues or epics, import issue data back into Clarion.
  • Auth: OAuth flow.

Linear

  • Purpose: Export specifications as Linear issues, import issue data back into Clarion.
  • Auth: OAuth flow.

Slack

  • Purpose: Receive anomaly alerts, digest reports, and notification summaries directly in Slack channels.
  • Setup: Configure a Slack webhook URL in Settings → Notifications.

Custom Webhooks

  • Purpose: Send signals from any external system via a simple POST request.
  • Setup: Create a webhook in Settings → Webhooks. Clarion generates a unique URL and signing secret.
  • Security: HMAC-SHA256 signature verification for all incoming payloads.

API Keys

Navigate to Settings → API Keys to generate keys for programmatic access and MCP server authentication. Each key is shown once on creation (copy immediately), with a name, creation date, last used timestamp, and a revoke button. Keys are scoped to your organization.

Product Hierarchy

Define your product structure as a multi-level hierarchy — from top-level product areas down to individual features: Product → Areas → Features → Sub-features. The hierarchy uses a drag-and-drop tree editor. Each node displays its signal count badge, aggregated sentiment, and auto-mapped signals. This hierarchy feeds into every AI operation — classification maps signals to product areas, themes roll up to the hierarchy, and specs reference specific product areas for context. Reorder by dragging; add children by clicking the “+” button on any node. Clarion automatically maps incoming signals to 1–3 relevant product areas using AI, enabling per-area analytics and filtering.

  • Tree management — Add, edit, reorder, and nest product areas up to 5 levels deep.
  • Signal mapping — Each signal is automatically assigned to relevant product areas during processing. The AI reads signal content and matches it against your hierarchy.
  • Aggregated metrics — View signal counts, sentiment averages, and opportunity counts per product area — with automatic rollup from children to parent nodes.
  • Tree visualization — Interactive tree view with expand/collapse, drag-and-drop reordering, and color-coded health indicators.

Segment Manager

Navigate to Settings → Segments to create and manage customer segments. Define segments with rule-based criteria:

  • ARR range — e.g., Enterprise (>$100K ARR), Mid-market ($10K–$100K), SMB (<$10K).
  • Company size — filter by employee count or organization tier.
  • Custom attributes — any metadata from your signal sources (plan type, region, industry, etc.).

Each segment shows a live match count — the number of customers that meet the criteria. Segments power the Segment Comparison page, filter “What to Build?” recommendations, scope Knowledge Explorer queries, and shape every AI analysis across the platform.

Branding

Navigate to Settings → Branding to customize your organization’s appearance in outbound communications. Upload your company logo and set a primary brand color. These appear on validation survey pages, digest emails, and shared reports — giving a professional, white-labeled experience to customers and stakeholders.

Approval Workflows

Navigate to Settings → Workflows to configure multi-stage approval processes (see the Approval Workflows section for full details). The visual drag-and-drop editor lets you define stages, assign roles, configure parallel branches, and set auto-escalation rules.

Notifications

Navigate to Settings → Notifications to configure how you receive alerts. Two delivery channels: Email and Slack webhook. Toggle notifications for: new high-priority signals, anomaly alerts, spec status changes, approval requests, and team activity. Set a Slack webhook URL to receive notifications in your team channel.

Digest Reports

Scheduled summary reports delivered via email or Slack. Digests keep stakeholders informed without requiring them to log in.

Navigate to Settings → Digests to configure automated summary emails. Each team member can set their own schedule and delivery method independently. Choose frequency (Daily, Weekly, or Monthly), set your timezone, and toggle which sections appear: Signal Summary, Highlights, Anomaly Alerts, New Opportunities, Sentiment Trends, and AI Recommendations. Use “Send Test” to preview the email. View digest history to see what was sent.

Configuration

  • Frequency — Daily, weekly, or monthly.
  • Delivery — Email or Slack.
  • Timezone — Reports are generated at the configured time in the user’s timezone.
  • Content — AI-generated highlights summarizing new signals, emerging themes, sentiment shifts, and top opportunities since the last digest.

Login Activity

Navigate to Settings → Login Activity to view your login history — timestamps, IP addresses, device info, and success/failure status. Filter by date range and status. Useful for security auditing and detecting unauthorized access attempts.

User Profile

Manage your personal account settings, password, avatar, and connected OAuth providers.

Profile Settings

Navigate to Settings → Profile (or click your avatar in the top-right corner). You can update your display name, email address, and upload a profile avatar. Your avatar appears on signals you create, specs you author, opportunity cards you own, and in the team activity feed.

Password & Security

Change your password from the profile page. If you signed up with Google OAuth, you can optionally add a password for email/password login. You can also link additional OAuth providers to your account for flexible sign-in options.

Organization Switching

If you belong to multiple organizations, click the organization name in the sidebar dropdown to switch between them. Each organization has its own data, team, plan, and settings — switching is instant with no logout required.

Plans & Billing

Choose the plan that fits your team. Upgrade, downgrade, or manage your subscription from Settings → Billing.

Starter

$0

forever

  • 5 PRD generations
  • 1 Machine Spec
  • 1 product workspace
  • Community support
  • No signal ingestion
  • No AI recommendations

Essentials

$39

per editor / month

  • Unlimited signals
  • Signal Collector (4 sources)
  • AI Intelligence Engine
  • 15 "What to Build?" recs/mo
  • 3 validation campaigns/mo
  • Unlimited PRDs + 20 Machine Specs
  • 50 Knowledge Explorer queries/mo
  • Up to 5 viewers
  • Email support

Pro

$59

per editor / month

  • Everything in Essentials
  • Signal Collector (10+ sources)
  • 50 "What to Build?" recs/mo
  • Unlimited validation campaigns
  • Unlimited PRDs + 40 Machine Specs
  • Unlimited Knowledge Explorer
  • Agent Bridge & MCP Server
  • GitHub, Jira, Linear integrations
  • 3 product workspaces
  • Unlimited viewers
  • Priority support

Enterprise

Custom

contact sales

  • Everything in Pro
  • Unlimited "What to Build?"
  • Unlimited Machine Specs
  • Custom connectors & taxonomies
  • Unlimited workspaces
  • Team seat management
  • Role-based access control
  • SSO, SCIM & audit logs
  • Dedicated CSM

Note

Prices shown are in USD. Annual billing is available at a discount ($390/yr for Essentials, $590/yr for Pro — save ~17%). INR pricing is also supported (₹3,299/mo Essentials, ₹4,999/mo Pro). Toggle billing interval and currency on the pricing page.

Feature Access by Plan

FeatureStarterEssentialsProEnterprise
Spec Translator5 PRDs, 1 SpecUnlimited PRDs, 20 SpecsUnlimited PRDs, 40 SpecsUnlimited all
Signal Collector4 sources10+ sourcesCustom connectors
AI Intelligence Engine
Executive Dashboard
"What to Build?"15/mo50/moUnlimited
Knowledge Explorer50 queries/moUnlimitedUnlimited
Validation Campaigns3/moUnlimitedUnlimited
Agent Bridge & MCPCustom config
GitHub / Jira / Linear
Product Workspaces113Unlimited
ViewersUp to 5UnlimitedUnlimited
SSO, SCIM & Audit Logs
Custom Taxonomies
Dedicated CSM

Payment

Payments are processed securely. We accept all major credit/debit cards, UPI, and net banking. Billing is monthly or annual (annual saves 20%). Manage your subscription, download invoices, and update payment methods in Settings → Billing.

Coupon Codes

If you have a coupon code, enter it on the checkout page before completing payment. Coupons can provide a percentage discount or grant free access for a specific plan. Coupon codes are created by platform administrators and may have expiration dates or usage limits.

Enterprise

Enterprise plans include custom seat counts, dedicated support, SLA guarantees, custom integrations, and advanced security features. Contact sales to discuss your requirements.

Platform Admin Panel

For platform super-administrators only — manage all organizations, users, coupons, and monitor platform health.

Warning

The Admin Panel is only visible to users with the SUPER_ADMIN role and is accessible at /admin. Regular org users will never see these pages.

Platform Overview Dashboard

The admin home page shows key platform metrics: total organizations, total users, Pro subscribers, monthly recurring revenue (MRR), recent signups, and billing events. Sparkline charts show trends over the last 30 days.

User Management

Navigate to Admin → Users to see a searchable, sortable table of all platform users: name, email, role, subscription tier, Pro seat status, last login timestamp, and organization count. Admins can edit user details or deactivate accounts.

Organization Management

Navigate to Admin → Organizations to see all organizations: name, plan, Pro seats used vs. allocated, member count, and total signal count. Click any organization for detailed management options.

Coupon Management

Navigate to Admin → Coupons to create and manage promotional coupon codes. Create coupons with a code, discount percentage or fixed amount, expiration date, and maximum usage count. Toggle coupons active/inactive. View redemption history for each coupon. Users redeem coupons during checkout on the billing page.

Platform Login Activity

Navigate to Admin → Login Activity to see a platform-wide login log. Paginated for large datasets. Filter by date range, success/failure status, and search by email. Monitor for suspicious login patterns or brute-force attempts.

AI Cost Tracking

Monitor LLM API spending across the platform. Track costs by organization, model (Clarion AI vs. Clarion AI Pro), and operation type (classification, spec generation, knowledge chat). Identify high-usage organizations and optimize AI spend.

Test Mode & Seed Data

Navigate to Admin → Test Mode to access the seed control panel. Generate demo data for testing: sample signals, opportunities, specs, and features. Useful for onboarding demos, sales presentations, and development environments.

Shared ReportsEssentialsProEnterprise

Generate public, read-only links to share product intelligence with external stakeholders — no login required.

Creating a Shared Report

From the Executive Dashboard, click “Share” to generate a shareable report link. Choose which sections to include: executive summary, top opportunities, risk alerts, team activity, sentiment trends, and feature velocity. Set an expiration date (7 days, 30 days, or never). The generated URL looks like /reports/[token] and works for anyone with the link.

Report Types

Executive Dashboard Report

Full dashboard view with KPIs, charts, top opportunities, risk alerts, and team activity. Perfect for board meetings and investor updates.

Feature Outcomes Report

Feature success metrics, unresolved gaps, prediction accuracy trends. Share with engineering leadership to demonstrate product-market fit of shipped features.

Reports show your organization’s branding (logo and colors) and include a Clarion watermark. Viewers see a read-only interface with no ability to modify data.

Note

Shared report links can be revoked at any time from the Executive Dashboard. Once revoked, the link returns a 404 error.

Keyboard Shortcuts

Power-user shortcuts to navigate Clarion quickly.

ShortcutAction
+KGlobal search — search across signals, opportunities, specs, and customers
+NCreate new signal
+Shift+AOpen "What to Build?" chat
+.Toggle sidebar
+/Show keyboard shortcuts overlay
EscClose modal / cancel action

Note

On Windows/Linux, replace with Ctrl.

Frequently Asked Questions

Answers to common questions about using Clarion.

How does Clarion's AI work? Is my data safe?
Clarion uses advanced AI models for all operations (classification, extraction, spec generation, recommendations). Your data is processed in real-time and is never used to train any AI model. Vector embeddings are generated and stored securely in your Clarion database. All processing is scoped to your organization — no cross-tenant data sharing.
How many signals can I import?
Pro and Enterprise plans support unlimited signal ingestion. Individual CSV imports can contain up to 10,000 signals. The bulk API endpoint also supports 10,000 per call. Integration syncs run continuously without limits.
What's the difference between Knowledge Explorer and “What to Build?”
Knowledge Explorer is for open-ended data exploration — ask any question about your signals, customers, trends, or competitive landscape. “What to Build?” is specifically optimized for prioritized, actionable product recommendations backed by evidence and confidence scores. Use Knowledge Explorer to understand your data; use “What to Build?” to make decisions.
How does the MCP server work with Cursor?
The MCP server runs as a local process launched by your IDE. When you add the Clarion configuration to your .cursor/mcp.json, Cursor starts the server automatically and gains access to seven tools for querying opportunities, specifications, feedback, and customer context — all from within your coding environment. Your API key authenticates all requests.
Can I use Clarion just for the Spec Translator?
Yes. The Starter plan (free) gives you 5 PRD generations and 1 Machine Spec. The Spec Translator at /translate is accessible without authentication — paste any PRD and get a machine-verifiable SPEC.md. For unlimited PRDs and more Machine Specs, upgrade to Essentials ($39/editor/mo) or Pro ($59/editor/mo).
How does opportunity auto-generation work?
Every hour (and after bulk imports), Clarion runs a clustering job that uses vector similarity to group related insights. When 3+ similar signals from different customers describe the same need, a new opportunity is created with an AI-generated title, description, and priority score. Existing opportunities are automatically updated when new matching signals arrive.
What happens when a GitHub PR linked to a spec is merged?
Clarion’s GitHub webhook listener detects PR merge events. When a PR linked to a specification is merged, the spec status automatically updates to “Implemented” and the linked feature’s status updates to “Shipped.” This creates a complete audit trail from customer signal → opportunity → specification → shipped feature.
Is there a dark mode?
Yes. Dark mode is built into every component and follows your system preference automatically. You can also toggle it manually from Settings → General.
How do I get support?
Pro users can reach support via the in-app help widget. Enterprise customers have a dedicated support channel and account manager. For the Starter plan, visit our documentation or community forum for self-service help.
Can I share reports with external stakeholders?
Yes. From the Executive Dashboard, click “Share” to generate a public, read-only report link. Choose sections to include and set an expiration date. The link works for anyone — no login required. Reports show your organization’s branding and can be revoked at any time.
How do approval workflows work?
Approval workflows are an Enterprise feature. In Settings → Workflows, you define multi-stage approval pipelines with specific roles assigned to each stage. When a spec is submitted for approval, it follows the pipeline — each stage must approve before the spec advances. Stages can run in parallel (both Tech Lead AND PM must approve) or sequentially. Approvers can approve, request changes, or send reminders.
What integrations does Clarion support?
Currently: Zendesk, Intercom, Gong, Amplitude, GitHub, Jira, Linear, Slack, and custom webhooks. Integrations are configured in Settings → Integrations. Most use OAuth for authentication. GitHub also supports outbound functionality (pushing specs to repos). Custom webhooks let you send data from any system via a simple POST request.
Can I export the executive dashboard as a presentation?
Yes. The Executive Dashboard supports three export options: PDF (downloadable summary), PowerPoint (auto-generated slide deck), and Presentation Mode (full-screen slides navigable with arrow keys, perfect for live meetings). You can also generate a shareable link for async viewing.
How do digest emails work?
Configure digests in Settings → Digests. Choose frequency (daily, weekly, monthly), set your timezone, and toggle which sections to include: Signal Summary, Highlights, Anomaly Alerts, New Opportunities, Sentiment Trends, and AI Recommendations. Use “Send Test” to preview before going live. Digests display your organization’s branding and include actionable links back to the platform.
Can I customize the AI classification categories?
The six default categories (Feature Request, Bug Report, Question, Praise, Complaint, Churn Risk) cover most use cases. The Adaptive Taxonomy system learns new sub-categories from your data. Full custom categories are on the roadmap for a future release.
How does the traceability chain work?
Every entity in Clarion is linked: Customer Signals → AI Insights → Opportunities → Specifications → Features → Outcomes. On the Feature Detail page, the Traceability Chain visualization shows this complete journey. You can always answer “why did we build this?” with direct evidence from the customers who requested it — and “did it work?” with measured outcomes.
What is the Spec Translator and is it really free?
The Spec Translator at /translate takes any human-readable PRD and converts it to a machine-verifiable SPEC.md that coding agents can execute. Every vague term gets quantified. It works without authentication — just paste and translate. The Starter plan (free) includes 5 PRD generations and 1 Machine Spec. It’s a standalone feature designed as an entry point to the Clarion platform.