FAQ
Frequently asked questions.
Everything you need to know about PrimaSpec, governance files, and getting started.
$ Getting Started
What is PrimaSpec?+
PrimaSpec is an AI-powered spec platform that generates up to 26 governance files for any project type. You describe what you want to build through a structured conversation, and PrimaSpec produces everything your AI coding agent needs to build it — CLAUDE.md, BLUEPRINT.md, AGENTS.md, THREATS.md, and more.
What are governance files?+
Governance files are structured documents (CLAUDE.md, BLUEPRINT.md, AGENTS.md, STATE.md, etc.) that AI coding agents read to understand how to build your software. They define architecture, security constraints, coding conventions, module boundaries, and acceptance criteria — so the agent builds exactly what you specified.
How does the conversation work?+
PrimaSpec runs a 6-phase structured conversation: Vision, Stack, Domain, Requirements, Environment, and Review. AI-driven questioning adapts to your project type — if you mention payments, it asks about PCI compliance; if you mention ML, it asks about data leakage. Most conversations take about 15 minutes.
What project types does PrimaSpec support?+
Any project type. PrimaSpec uses AI-driven classification — there is no hardcoded list of supported types. Web apps, mobile apps, ML pipelines, CLI tools, embedded systems, games, blockchain, quantum computing, robotics, FPGA design, satellite firmware — if you can describe it, PrimaSpec can spec it. 75 concern packs with 1,000+ domain-specific questions activate automatically based on your project context.
$ Governance Files
How many files are generated?+
Up to 26 files depending on your project type. Not every file is generated for every project — PrimaSpec automatically selects relevant files. A web app might get BLUEPRINT.md, CLAUDE.md, AGENTS.md, THREATS.md, and deployment configs, while an ML project gets experiment tracking, validation strategy, and data pipeline docs instead.
How long does generation take?+
AI-rendered files with the self-healing review pass take 15-20 minutes. Each file is generated individually by Claude, then all files go through a cross-consistency review to ensure naming, references, and architecture align across the entire governance pack.
Can I regenerate files after editing my spec?+
Yes. Edit your spec from the project page, and PrimaSpec detects the change automatically. Navigate to the forge page and you will see a "Regenerate" banner indicating your governance files are out of date. Click it to regenerate with your updated spec.
Can I regenerate a single file?+
Yes. Individual file regeneration is available from the forge page. Click on any file in the sidebar and use the regenerate option to re-render just that file without regenerating the entire pack.
Which AI coding agents work with PrimaSpec?+
All major AI coding agents are supported: Cursor, Windsurf, GitHub Copilot, Aider, and Claude Code. PrimaSpec generates IDE-specific configuration files — .cursor/rules/spec.mdc for Cursor, .windsurf/rules/spec.md for Windsurf, .github/copilot-instructions.md for Copilot, and CONVENTIONS.md for Aider.
$ Billing & Plans
How does billing work?+
PrimaSpec uses a pay-per-project model with tiered credit packs: $29 for 1 credit, $99 for 5 ($19.80 each), or $179 for 10 ($17.90 each). Each credit generates a new project with full governance — up to 26 files. Credits never expire. No subscriptions. Payments are processed by Lemon Squeezy.
Can I try PrimaSpec for free?+
Yes. Every new account starts with 1 free project — complete conversation, spec extraction, and full governance file generation included. No credit card required to start.
$ Import & CLI
Can I import an existing project description?+
Yes. Use Import from Text on the spec page to paste a README, CLAUDE.md, or any project description. PrimaSpec parses it and pre-fills your spec, so you can skip straight to refinement instead of starting from scratch.
Is there a CLI?+
A CLI package (@primaspec/cli) is scaffolded and will ship soon. For now, PrimaSpec runs entirely in the web dashboard at primaspec.com — describe your project, extract the spec, and download the generated governance files as a ZIP.
$ Troubleshooting
Generation seems stuck — what do I do?+
Governance generation takes 15-20 minutes for AI-rendered files. If it appears stuck for more than 30 minutes, try refreshing the page. The system tracks progress server-side and will resume from where it left off — you will not lose any completed files.
I edited my spec but files look outdated.+
Navigate to the forge page for your project. PrimaSpec detects when spec changes make governance files stale and shows a "Regenerate" banner at the top. Click it to regenerate files with your updated spec data.
Can I cancel a generation in progress?+
Yes. Click "Cancel generation" below the progress bar on the forge page. Files that have already completed will be preserved — only pending files will be skipped.