Overview
Status: Implementation Ready ✅ | Foundation: Constellation | Target: Q2 2026
What is Spec Doc?
One-Liner: "Cursor is for writing code. Spec Doc is for writing the specs that tell AI what code to write."
Tagline: "Write better specs, get better code."
The Paradigm Shift
Old World: Developer writes spec → Developer writes code → Git for code
New World (AI Era): Developer writes spec → AI writes code → Git for spec?
Problem: We're versioning output (code) instead of input (specs).
Solution: Spec Doc treats specs as first-class artifacts with proper tooling.
Core Value
- Document-First Interface: 95% document, 5% AI input (not chat-first) - UX Vision
- Complete Workflow: Write Spec → Generate Prototype → Validate → Export to Cursor → Build
- AI That Learns: Personalizes to your writing style, learns company terminology, lock-in through personalization
Documentation Structure
| Document | Purpose |
|---|---|
| Epic | Product scope & MVP (read first) |
| Architecture | Technical design, database schema, API |
| Business Analysis | Market, pricing, metrics, GTM |
| Roadmap | 3-year strategic vision |
| UX Vision | Interface philosophy (document-first, not chat) |
| Cursor Integration | Export workflow |
| Prototyping | Prototype generation ("Skip Figma") |
Try Prototypes
- 🧪 Spec Doc Prototype - Document-first UX demo
- 🧪 Instant Preview - Split-pane editor demo
Quick Start
- Vision: Read Epic + UX Vision
- Business Case: Read Business Analysis + Roadmap
- Technical: Read Architecture + Alternatives Considered
- Try: Open prototype links above
For Developers
Prerequisites: Constellation Phase 1A + Phase 2 complete
First Task: Epic 1 (User Management & Auth) - see Epic
Success Metrics
| Phase | Target |
|---|---|
| MVP (Month 1) | 20 paying users |
| PMF (Month 6) | 300 paying users |
| Scale (Month 12) | 1,000 paying users |
See Business Analysis for full metrics.
What Makes This Special
We Ate Our Own Dog Food
This spec was created using the workflow Spec Doc productizes:
- 7 comprehensive markdown files through AI iteration
- 50+ refinements captured in Git
- Never reviewed code, only reviewed decisions
This proves: The "specs as source code" paradigm works.
Open Prompt Development
We're sharing these specs publicly. If you can rebuild Spec Doc from these specs:
- ✅ Validates Spec Doc works
- ✅ Code isn't the moat (specs are)
- ✅ Free marketing
The moat: Workflow + UX + AI personalization + Prototyping
Status: Ready for implementation after Constellation Phase 2