“That's not what we asked for.”
Code stopped being the bottleneck. Knowing what to build is. CrystalSpec turns your idea into a structured spec in minutes, interrogates the gaps, and checks it against your competitors, GDPR, and SOC 2.
Free 14-day trial. No credit card. Cancel in two clicks.
Four sentences every product team says out loud.
They sound like communication problems. They are not. Each one is a product that was never written down in a form that stays true, and each one has a specific answer.
The person who decided has moved on, or simply forgot. So the team keeps a rule nobody understands, or removes it and learns the reason from production.
Open History on any flow, step, role, field, or term. It shows who introduced it, every revision that changed it, the exact field-level diff, and the reason recorded at the time.
Two rules written three months apart. Both true when written, mutually exclusive now. Nobody notices until an engineer has to build both.
The analyzer reads the whole project and returns contradictions, gaps, and dead glossary terms, graded by severity. Every finding quotes the lines it rests on, and the server verifies each quote before you see it.
Agents do not ask clarifying questions. They fill silence with confident guesses, and the cost arrives at review.
Agents connect to the live spec through a hosted MCP endpoint. They pull the exact flow, branch, data model, and test case they need, and can ask the project a question instead of guessing at the answer.
The product moved and the file did not. Once people stop trusting it, they stop reading it, and it quietly dies.
Editing forks a draft, so the published spec stays stable. Publishing cuts a version with a change summary and a field-level changeset, gated by approval, revertible with its lineage, and exportable straight into GitHub, Linear, or ClickUp.
Change is inevitable. Drift isn't.
Keep every decision connected to the product it shapes, from the first draft through every revision after launch.
See how a spec gets builtDefine it clearly. Keep it alive as the product changes.
AI helps maintain the structure. Your team owns every decision, from the first draft through every revision after launch.
Define
Describe the product in plain language. CrystalSpec turns it into connected flows, roles, data models, decisions, and test cases.
Review & approve
The AI returns concrete proposals: create this flow, update that step. Each one is validated before it can be applied, and you accept or reject them individually.
Connect
Publish the current revision for stakeholders, Slack, and coding agents. Everyone queries the same approved context.
Evolve
Version changes as the product grows. Analyze contradictions and gaps, review what changed, and revert any revision when needed.
AI proposes. You decide.
Chat with an assistant that knows your whole project. Suggestions arrive as structured proposals (create this flow, update that field, delete that role), each validated before it can be applied. Nothing is written until you approve it.
- Approve or reject proposals one by one, or all at once
- Validation catches missing fields and broken references up front
- Every approval and rejection is recorded
Find the holes before they cost a sprint.
One click scans a project, flow, or step for contradictions, gaps, and dead glossary terms. Findings come back graded by severity, and "Fix all with AI" turns the report into proposals you review like any other change.
- Whole-project, per-flow, or per-step analysis with an optional goal
- Findings graded as contradictions, warnings, and notes
- A browsable history of past analyses, with jumps straight to the flow
Git-style history for product decisions.
Editing forks a draft revision locked to one editor, so the published spec stays stable while you work. Publishing cuts a new version with a change summary and a field-level changeset. Any version can be reverted.
- One active editor per draft, so edits never collide
- Field-level "View changes" diffs between revisions
- Optional sign-off before publish, with named approvers
- Revert with full lineage, plus a per-project activity timeline
Your agents can query the spec.
The spec is typed data, so an agent can pull a flow, list revisions, diff what changed, or ask the project a question over a hosted MCP server, a scoped GraphQL API, and signed webhooks on every publish. A markdown PRD can't answer those questions. A structured spec can.
- MCP tools for Claude Code, Claude Desktop, and Cursor
- Query the typed graph: flows, models, revisions, glossary terms
- HMAC-signed revision.published webhooks, plus read-only public links
Everything a spec needs, in one place.
Once the product is defined properly, other work gets easier. These tools read the same approved spec your team and your agents do.
Stop hearing about competitors from your customers.
Watch up to 25 competitors on a daily or weekly scan. Every signal leads with the fact and its clickable sources, then explains why the move might matter. Send one to the project AI and it proposes spec changes you review.
Find out you are not compliant before the auditor does.
Check your spec against GDPR, HIPAA, SOC 2, ISO 27001, PCI DSS, CCPA, or WCAG 2.2. Every requirement comes back graded, with evidence quoted from your own spec. Each finding carries Fix with AI.
Answer “why does this exist?” without asking anyone.
Open History on any flow, step, role, field, or term. You see who introduced it, every revision that changed it, the exact field-level diffs, and the reason given at the time.
An AI that has to show its evidence.
The analyzer quotes up to three lines from your spec for every finding. The server verifies each quote and reference, then badges anything it cannot confirm. Dismiss a false positive once and it stays dismissed.
Know how far along you actually are.
A delivery view over your current revision, filtered by phase. Partial work counts honestly: a ten-step flow with nine steps done contributes 0.9, not zero and not one.
An investor deck that matches the product you built.
Ten VC sections, drafted by AI from your active revision. Add charts, set your colors and logo, then share a link or download the PDF. When the product moves, regenerate one section instead of the deck.
And the spec itself
Flows that branch
Plain steps, nested sub-flows, and decision points with labelled branches. Every flow renders as a live diagram you can click into.
Data models, drawn or generated
Typed fields, enums, arrays, and references between models. Build them by hand or generate them from your project's context.
Test cases on every flow
Each flow carries verification cases with codes and descriptions, so QA starts from the spec instead of guessing at it.
Discussions where the work is
Threads anchored to flows and projects, with @mentions, a global unread inbox, and an AI teammate that answers when you mention @cs.
Share without an account
Publish a read-only link to any project. Visitors can browse the live spec and ask AI questions about it; that usage is associated with the shared workspace.
The full anatomy of a spec
Roles, phases, epics, glossary terms, and reference resources, typed and cross-referenced so every flow and model shares one vocabulary.
Cmd+K everything
A command palette that searches every flow, step, model, and term in your project, and lands you there with the editor open.
Access control that holds
Owners, admins, and contributors, with per-project read/write overrides enforced server-side on every operation.
PDF & DOCX export
A server-rendered PDF or a styled Word document of the entire specification, for whenever a stakeholder asks for "the document."
Ask the spec in Slack
Mention @CrystalSpec in a bound channel and it answers in-thread from your published revision, with a link back to the project.
Standing instructions
House style, tone, and things to always check, injected into every AI call across chat, analysis, and revision summaries. Only an owner can change them.
Sign-off before a revision ships
Require approval before publish. Drafts park as pending, approvers are notified in-app, in Slack, and over webhooks, and both sides are credited on release.
Ten dollars a seat. That's the pricing page.
Try everything free, then pay $10 per member per month, with each member's monthly AI allowance included. A five-person team runs $50 a month, all in.
Free Trial
Every feature unlocked for 14 days while you evaluate.
Upgrade only when you're ready to commit.
- Full spec authoring & AI assistant
- 500 AI credits per member, monthly
- Versioned revisions & publishing
- Read-only public sharing
Team
One flat price per seat, however your team grows.
5 members → $50/month. Add or remove seats anytime.
- Unlimited projects
- Unlimited seats, billed per seat
- 500 AI credits per member, monthly
- Shared AI top-ups when you need more
- Per-project read/write access control
- Push to GitHub, Linear & ClickUp
- MCP server, GraphQL API, webhooks & PDF/DOCX export
Questions we hear a lot.
Is CrystalSpec a project management tool?
No. Project management tools track work: tickets, owners, deadlines, and status. CrystalSpec defines the product itself: its flows, roles, data models, decisions, terminology, and test cases. It can push implementation tasks to tools like GitHub, Linear, and ClickUp, but the living specification remains the source of truth.
Can the AI change my spec without me knowing?
No. That's the core design decision. The assistant only produces proposals: structured create, update, and delete suggestions that wait for your explicit approval. Each one is validated before you can approve it, every decision is recorded, and rejected proposals are kept so you can see what was suggested and who declined it.
How do AI credits work?
Every team member gets 500 AI credits each month (roughly $5 of AI usage), included with their seat and refreshed automatically. When someone runs out, usage draws from a shared team top-up balance you can buy once and keep. Reviewing proposals never costs credits; only generation does.
What happens when two people edit the spec at once?
Only one draft can exist at a time. If two people start editing together, the first person to create the draft becomes its active editor. Everyone else keeps seeing the stable published version and can continue the discussion, but no competing draft can overwrite the work in progress. Once the draft is published, the next change starts from that new current version: no silent overwrites and no conflicting versions to untangle.
Can I share a spec with someone outside my team?
Yes. Any project can publish a read-only share link that requires no account. Visitors can browse the live published spec and ask AI questions about it; that usage is associated with the shared workspace. Rotate or disable the link at any time and old URLs stop resolving immediately.
Can my coding agents and tools read the spec?
Yes, it's a first-class feature. CrystalSpec hosts an MCP server that Claude Code, Claude Desktop, and Cursor can connect to with a scoped personal token. There's also a GraphQL API, HMAC-signed webhooks that fire when a revision is published, and PDF and DOCX export for the humans in the room.
Can my team ask the spec questions in Slack?
Yes. Connect a Slack workspace, bind a channel, and mention @CrystalSpec with a question. It answers in the thread from the project's published revision, formatted natively, with a link back to the project. It's stateless and read-only, so a Slack question can never change the spec. Usage is billed to the connection owner's allowance, so anyone in the channel can ask without an account or credits of their own.
Can we require sign-off before a spec goes live?
Turn on "require approval before publish" and a submitted draft parks as pending instead of publishing, while its editor keeps working. Choose who can approve: any member, the team owners, or a named set. Approvers are notified in-app, in Slack, and over webhooks, and re-pinged if the draft changes before they sign off. On publish, both the author and the approver are credited.
Do I need a credit card to try it?
No. Create an account and start a free trial with every feature unlocked, including your monthly AI allowance. When you're ready, the paid plan is a single per-seat price: $10 per member per month.
Didn't find your question? Start free →
Change the product
without losing the plot.
Keep every flow, decision, dependency, and test case structured, versioned, and consistent as your software evolves. Your team and coding agents always read the same approved spec.