From importing your first signals to shipping AI-generated specifications.
Get up and running in under 10 minutes. This walkthrough covers account creation, importing your first signals, and asking your first AI-driven question.
Create Your Account
Choose Your Plan
Organization Setup
Invite Your Team
Import Your First Signals
Let the AI Work
Explore Insights and 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.
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 complete flow from customer voice to shipped code:
When you first log in, Clarion guides you through a 4-step interactive onboarding wizard so your team is productive from day one.
Welcome & Overview
Connect Your Data
Set Up Product Hierarchy
Interactive Tour
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
Your command center — a real-time summary of product intelligence with quick actions and an onboarding guide for new users.
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).
A visual heatmap showing which product areas are receiving the most feedback. Color intensity indicates signal volume; hover for sentiment breakdown.
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).
A leadership-ready overview of your product intelligence — KPIs, trends, risk alerts, team activity, and shareable reports designed for stakeholder presentations and board reviews.
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 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.
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.
Top customers ranked by ARR with their satisfaction trajectory. Segment-level sentiment comparison. Identify at-risk accounts before they churn.
Recent team actions: specs created, opportunities moved, signals reviewed, insights shared. Helps leaders understand team engagement and workload distribution.
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.
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).
Convert any human-readable PRD into a machine-verifiable specification that AI coding agents can execute — completely free, no sign-up required.
Paste Your PRD
/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.AI Translation
SPEC.md — every vague requirement is quantified: “fast” becomes “< 200ms p95”, “responsive” becomes specific breakpoints, “secure” becomes OWASP compliance requirements.Download & Use
/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.| Human Spec Says | Machine 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 |
Signals are the raw customer data that powers everything in Clarion — feedback, support tickets, feature requests, interview notes, NPS responses, and more.
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.
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.
Every signal contains these core fields:
| Field | Required | Description |
|---|---|---|
| title | Yes | Short summary of the feedback (max 500 chars) |
| rawContent | Yes | Full feedback text |
| sourceType | Yes | Origin: csv, webhook, zendesk, intercom, gong, amplitude, manual |
| category | No | Auto-classified: feature_request, bug_report, ux_feedback, praise, churn_signal, support_question, competitive_intel |
| customerName | No | Name of the customer who gave the feedback |
| customerEmail | No | Customer email — used for matching |
| customerCompany | No | Company name |
| customerArr | No | Annual recurring revenue (USD) |
| sourceMetadata | No | JSON object with source-specific fields (ticket ID, channel, tags, etc.) |
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):
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",45000Note
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:
| Integration | Signal Types | Sync |
|---|---|---|
| Zendesk | Support tickets, customer conversations | Real-time webhook |
| Intercom | Chat messages, survey responses | Real-time webhook |
| Gong | Call transcripts, meeting notes | Periodic polling |
| Slack | Channel messages, feedback threads | Real-time webhook |
| GitHub | Issues, PR comments, discussions | Webhook |
| Amplitude | Product analytics events, user behavior data | Periodic import |
Webhook & API — Create custom webhook endpoints to receive signals from any external system.
Create a Webhook
Configure Your Source
X-Webhook-Secret header for HMAC verification.Send Signals
{
"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
X-Webhook-Secret header. Requests with missing or invalid signatures are rejected with a 401 status.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
POST /api/v1/signals/bulk-import endpoint. The processing queue handles them asynchronously.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.
Every signal that enters Clarion goes through a multi-stage AI pipeline:
Classification
| Category | Description | Example |
|---|---|---|
| Feature Request | Customer asks for new functionality | "We need a bulk export option" |
| Bug Report | Something is broken or not working | "Login fails on Safari when using SSO" |
| Question | How-to or troubleshooting inquiries | "How do I set up webhook authentication?" |
| Praise | Positive feedback about existing features | "The new dashboard is exactly what we needed" |
| Complaint | Dissatisfaction with current experience | "The settings page is hard to navigate" |
| Churn Risk | Indicators of potential customer loss | "We're evaluating alternatives because..." |
Theme & Entity Extraction
Sentiment & Urgency Scoring
Importance Scoring
Vector Embeddings and Indexing for Semantic Search
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.
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.
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.
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.
| Tier | Available On | Used For |
|---|---|---|
| Clarion AI | Free + Pro | Classification, theme extraction, sentiment analysis, summaries |
| Clarion AI Pro | Pro only | PRD generation, What to Build recommendations, machine spec generation |
| Vector Embeddings | Pro only | Semantic search powered by advanced AI embeddings |
Note
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.
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.
Tip
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.
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.
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.
| Report Type | What You Get |
|---|---|
| Competitor Profile | Deep dive on a single competitor — features, pricing, strengths, weaknesses, customer perception |
| Head-to-Head | Your product vs. one competitor — feature comparison, sentiment analysis, win/loss patterns |
| Multi-Competitor | Compare 3+ competitors simultaneously with a comparison matrix and positioning map |
| Market Landscape | Full market overview — all tracked competitors with market positioning, trends, and whitespace |
| Custom Query | Ask any competitive question and get a researched answer |
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.
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.
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.
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”).
| Operation | Description | Auto-Applied? |
|---|---|---|
| CREATE | New category for emerging themes with no existing match | Yes |
| MERGE | Combine two similar categories into one | No — requires review |
| SPLIT | Divide an overly broad category into sub-categories | No — requires review |
| ARCHIVE | Retire categories with declining signal volume | No — requires review |
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.
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.
Compare customer segments side-by-side to understand how different groups experience your product.
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:
Tip
Clarion continuously monitors your signal data for statistically significant deviations from normal patterns. When anomalies are detected, you are notified immediately.
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.
A Kanban board for managing product opportunities through their lifecycle — from AI-discovered insights to shipped features.
The Opportunities page shows a drag-and-drop Kanban board with five columns:
| Column | Meaning |
|---|---|
| Identified | Newly discovered opportunities (auto-generated or manually created) |
| Under Review | Being evaluated by the product team |
| Approved | Approved for specification and development |
| In Progress | Active specification or development underway |
| Shipped | Feature has been released |
Toggle between Board, List, and Table views using the top bar. Filter by status, product area, priority range, owner, and date.
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.
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.
Each opportunity receives an AI-calculated priority score (0–100) based on five weighted factors:
| Factor | Weight | What It Measures |
|---|---|---|
| Signal Volume | 20% | How many signals mention this need |
| Revenue Impact | 25% | Total ARR of affected customers |
| Sentiment | 20% | How negative the feedback is (negative = higher priority) |
| Competitor Pressure | 15% | Signals mentioning competitors in this context |
| Customer Breadth | 20% | Number of unique customers requesting this |
Tip
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.
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.
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
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.
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.
Each opportunity is automatically scored using your chosen PM framework. Scores are auto-derived from signal data — not manual estimates:
| Framework | Factors | Best For |
|---|---|---|
| RICE | Reach × Impact × Confidence / Effort | Data-driven teams with good usage metrics |
| ICE | Impact × Confidence × Ease | Fast prioritization with less data |
| MoSCoW | Must / Should / Could / Won't | Stakeholder alignment and requirement triage |
| Value-Effort | Business Value / Implementation Effort | Quick 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.
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.
Validate opportunities directly with customers before investing in specifications and development. Run lightweight survey campaigns to measure demand confidence.
Select an Opportunity
Design the Survey
Target Audience
Review Results
The survey builder supports five question types for maximum flexibility:
| Type | Use Case |
|---|---|
| Multiple Choice | Feature preference, priority selection, categorical choices |
| Open Text | Free-form feedback, feature descriptions, pain point details |
| Scale / NPS | Satisfaction scores (1–10), likelihood to recommend, severity ratings |
| Ranking | Priority ordering of features, importance ranking |
| Confirmation | Yes/No validation of a specific hypothesis or need |
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).
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.
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.
Campaigns move through six stages: Draft → Review → Scheduled → Active → Analyzing → 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 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.
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.
There are two ways to create a spec:
Every PRD is editable with a rich text editor. The editor supports:
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.
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.
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:
After generating a machine spec, you can generate five agent artifacts optimized for AI coding assistants:
| Artifact | File | Purpose |
|---|---|---|
| Cursor Rules | .cursorrules | Project context, tech stack, coding conventions, spec constraints, testing requirements, and implementation guidance for Cursor |
| Machine Spec | SPEC.md | Machine-verifiable specification with numbered requirements, data models, API contracts, and acceptance tests |
| Agent Guide | agents.md | Agent persona definitions — how each AI coding agent should approach the implementation. Architecture overview, file structure, and implementation strategy for any AI agent. |
| Task Breakdown | tasks.json | Structured task breakdown with dependency ordering, priorities, files to create/modify, effort estimates, estimated complexity and acceptance criteria |
| Test Scenarios | acceptance_tests.spec.ts | TypeScript 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
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.
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.
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.
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.
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.
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.
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
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.
Clarion exposes a Model Context Protocol (MCP) server that any MCP-compatible client can connect to. The server provides seven tools:
| Tool | What It Does |
|---|---|
| query_opportunities | Search and retrieve product opportunities based on customer feedback |
| get_specification | Get a complete specification (human PRD + machine spec) for a feature |
| search_feedback | Search customer feedback by topic, sentiment, or segment |
| get_customer_context | Get customer information and their feedback history |
| what_to_build | Ask what features to build next based on customer data |
| get_cursorrules | Get .cursorrules file for a specification |
| get_tasks | Get task breakdown for a specification |
MCP requests are authenticated with API keys. Generate a key in Settings → API Keys. Include it as a Bearer token:
{
"mcpServers": {
"clarion": {
"url": "https://getclarion.in/api/v1/mcp",
"headers": {
"Authorization": "Bearer your-api-key-here"
}
}
}
}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.
Generate API Key
Copy Configuration
.cursor/mcp.json), Claude Desktop (add to claude_desktop_config.json), Claude Code (add to MCP settings), and Bolt.new.Test Connection
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.
Track shipped features, link them back to the opportunities and signals that drove them, and measure their real-world impact.
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.
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.
If GitHub is connected, feature status automatically updates based on PR lifecycle:
| PR State | Feature Status |
|---|---|
| PR Created | In Development |
| PR Merged | Shipped |
Measure the ROI of your product decisions. Did the features you shipped actually move the metrics you predicted?
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.
Every decision in Clarion is traceable — from the original customer quote all the way to the shipped feature and its measured outcome.
Signal → Insight
Insight → Opportunity
Opportunity → Specification
Specification → Feature
Feature → Outcome
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.
Configure your workspace, manage your team, connect integrations, and control platform behavior.
Clarion uses role-based access control (RBAC) to manage permissions within your organization.
| Role | Permissions |
|---|---|
| Owner | Full access. Manage billing, delete org, transfer ownership. One per org. |
| Admin | Manage team, settings, integrations, workflows, and all content. Cannot manage billing or delete org. |
| Member | Create and edit signals, insights, opportunities, and specs. Cannot manage team or settings. |
| Viewer | Read-only access to all data. Cannot create, edit, or delete anything. |
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.
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.
Invite team members by email. Four role levels:
| Role | Permissions |
|---|---|
| Owner | Full access. Manage billing, delete organization, manage all settings. |
| Admin | Manage team members, integrations, and settings. Full data access. |
| Member | Create and edit signals, opportunities, specs. Cannot manage team or billing. |
| Viewer | Read-only access to all data. Can comment but not create or edit. |
Connect and manage all third-party integrations from Settings → Integrations. Each integration shows its connection status, last sync time, and signal count.
subject → signal title, description → rawContent. Priority, status, tags, and timestamps are stored in sourceMetadata.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.
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.
Navigate to Settings → Segments to create and manage customer segments. Define segments with rule-based criteria:
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.
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.
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.
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.
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
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.
Manage your personal account settings, password, avatar, and connected OAuth providers.
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.
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.
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.
Choose the plan that fits your team. Upgrade, downgrade, or manage your subscription from Settings → Billing.
$0
forever
$39
per editor / month
$59
per editor / month
Custom
contact sales
Note
| Feature | Starter | Essentials | Pro | Enterprise |
|---|---|---|---|---|
| Spec Translator | 5 PRDs, 1 Spec | Unlimited PRDs, 20 Specs | Unlimited PRDs, 40 Specs | Unlimited all |
| Signal Collector | — | 4 sources | 10+ sources | Custom connectors |
| AI Intelligence Engine | — | ✓ | ✓ | ✓ |
| Executive Dashboard | — | ✓ | ✓ | ✓ |
| "What to Build?" | — | 15/mo | 50/mo | Unlimited |
| Knowledge Explorer | — | 50 queries/mo | Unlimited | Unlimited |
| Validation Campaigns | — | 3/mo | Unlimited | Unlimited |
| Agent Bridge & MCP | — | — | ✓ | Custom config |
| GitHub / Jira / Linear | — | — | ✓ | ✓ |
| Product Workspaces | 1 | 1 | 3 | Unlimited |
| Viewers | — | Up to 5 | Unlimited | Unlimited |
| SSO, SCIM & Audit Logs | — | — | — | ✓ |
| Custom Taxonomies | — | — | — | ✓ |
| Dedicated CSM | — | — | — | ✓ |
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.
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 plans include custom seat counts, dedicated support, SLA guarantees, custom integrations, and advanced security features. Contact sales to discuss your requirements.
For platform super-administrators only — manage all organizations, users, coupons, and monitor platform health.
Warning
/admin. Regular org users will never see these pages.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.
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.
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.
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.
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.
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.
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.
Generate public, read-only links to share product intelligence with external stakeholders — no login required.
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.
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
Power-user shortcuts to navigate Clarion quickly.
| Shortcut | Action |
|---|---|
| ⌘+K | Global search — search across signals, opportunities, specs, and customers |
| ⌘+N | Create new signal |
| ⌘+Shift+A | Open "What to Build?" chat |
| ⌘+. | Toggle sidebar |
| ⌘+/ | Show keyboard shortcuts overlay |
| Esc | Close modal / cancel action |
Note
Answers to common questions about using Clarion.
.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./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)./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.