Skip to content

DOCUMENTATION

How PrimaSpec works.

GETTING STARTED

Create a project

Describe your idea in one sentence. PrimaSpec builds the initial scaffold and starts asking questions. Already have a README or CLAUDE.md? Use Import from Text to paste it and skip straight to refinement.

New Project

A real-time multiplayer card game with matchmaking, ELO ranking, and daily challenges in Godot

Detected: game-dev, real-time, matchmaking3 packs ready
Conversation Phases
Vision
Stack
Domain
4
Requirementscurrent
5
Environment
6
Review

THE CONVERSATION

Six phases. 1,000+ questions.

Each phase covers one aspect of your project. 75 concern packs with AI-driven selection ask the right domain-specific questions. Quick selections or detailed free-form text. About 15 minutes total.

CONCERN PACKS

Domain questions activate automatically

Mention "payments" and PrimaSpec loads escrow, refund, and PCI questions. Mention "ML pipeline" and it loads cross-validation, data leakage, and hyperparameter questions. 75 concern packs with 1,000+ questions ship built in, with AI-driven selection.

Active Packs
fintech
20 questions
ai-ml
21 questions
data-science
16 questions
marketplace
11 questions
embedded-hardware
14 questions
competition-hackathon
12 questions
Architecture Audit
high

Missing input validation on user-facing mutation

medium

No error handling for external service timeout

low

Consider adding structured logging for debugging

ARCHITECTURE AUDIT

AI review catches gaps

Checks consistency, security holes, and missing error handling. Every finding includes severity and a concrete fix.

EXPORT

JSON, Markdown, and up to 26 governance files.

Export your spec as JSON or Markdown, or download the full governance bundle: BLUEPRINT.md, CLAUDE.md, AGENTS.md, AGENTS-full.md, STATE.md, FEATURES.md, THREATS.md, CONTRIBUTING.md, RUNBOOK.md, and more — all dynamically tailored to your project type. Smart file selection means not every project gets all 26 files — only the ones relevant to your stack and domain. A self-healing review pass cross-checks all files for consistency, and can delete inapplicable files automatically.

spec.json
{
"entities": [...]
"endpoints": [...]
"auth": { ... }
}
governance.zip
BLUEPRINT.md
CLAUDE.md
AGENTS.md
FEATURES.md
STATE.md
THREATS.md
+ 20 more files
Version History
v3+2 features, +1 module
92%2 min ago
v2+auth strategy, +error handling
78%8 min ago
v1Initial extraction
45%14 min ago

VERSION HISTORY

Every save creates a snapshot

Browse the timeline, diff two versions, and roll back with one click.