Skip to main content

Product Epic

Target: MVP Launch (3-4 months) | Foundation: Constellation

Vision​

"When AI writes your code, specifications become your source code."

Positioning:

  • 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."

MVP Goal​

Build a functional spec authoring platform where users can:

  1. Sign in with GitHub
  2. Create spec (creates GitHub repo)
  3. View rendered spec (embedded GitHub Pages)
  4. Edit sections with AI assistance
  5. See changes committed to GitHub

Success: End-to-end flow works, AI edits produce quality Markdown, 10 alpha users iterate on specs.

Epic Breakdown​

EpicDescriptionDurationDependencies
Epic 1User Management & Auth (GitHub OAuth)2 weeksNone
Epic 2GitHub Integration Core (API client)3 weeksEpic 1
Epic 3Project Management (CRUD)2 weeksEpic 1, 2
Epic 4Template System (Docusaurus)1 weekEpic 2
Epic 5Spec Viewing (iframe + Pages)2 weeksEpic 3, 4
Epic 6AI-Assisted Editing3 weeksEpic 2, 3, 5
Epic 7Polish & Launch Prep1 weekAll

Total: 14 weeks (~3.5 months)

Epic Details​

Epic 1: User Management & Auth (2 weeks)​

  • GitHub OAuth sign-in
  • User profile with GitHub info
  • Session management with JWT
  • Tech: Extend AuthenticationController, add GitHubOAuth2Service

Epic 2: GitHub Integration Core (3 weeks)​

  • Create repos via GitHub API
  • Commit file changes
  • Read file contents
  • Enable GitHub Pages
  • Tech: New com.saas.springular.github package

Epic 3: Project Management (2 weeks)​

  • Create project (creates GitHub repo)
  • List projects dashboard
  • Project details view
  • Soft delete with archive
  • Tech: New com.saas.springular.project package

Epic 4: Template System (1 week)​

  • Default Docusaurus template
  • Template variable replacement
  • Initial commit with structure

Epic 5: Spec Viewing (2 weeks)​

  • Embed GitHub Pages in iframe
  • Table of contents navigation
  • Build status indicator

Epic 6: AI-Assisted Editing (3 weeks)​

  • Select section to edit
  • AI rewrite with instruction
  • Preview before commit
  • Edit history (links to GitHub)
  • Tech: AI provider abstraction (OpenAI/Anthropic), rate limiting

Epic 7: Polish & Launch Prep (1 week)​

  • Onboarding flow
  • Error handling
  • Performance optimization
  • Documentation

Success Criteria​

Functional​

  • ✅ Sign in with GitHub
  • ✅ Create project (GitHub repo + template)
  • ✅ View rendered spec
  • ✅ Edit spec with AI
  • ✅ Changes commit to GitHub

Quality​

  • ✅ No critical bugs
  • ✅ API uptime >99%
  • ✅ AI rewrite success rate >90%

UX​

  • ✅ New user creates first spec in <5 min
  • ✅ Edit-to-commit cycle <60s

Non-Goals (MVP)​

  • ❌ Multi-user collaboration
  • ❌ Custom templates
  • ❌ Prototyping (Phase 2)
  • ❌ Cursor extension
  • ❌ CLI tool
  • ❌ Enterprise features

Dependencies​

Requires Constellation:

  • Phase 1A complete (AI foundation)
  • Phase 2 complete (text intelligence primitives)
DocumentPurpose
OverviewNavigation
ArchitectureTechnical design
Business AnalysisMarket & pricing
UX VisionInterface philosophy

Status: Ready for implementation after Constellation Phase 2