Bootspring
HomeGet Started

Synthesize from Preseed

Convert your preseed documents into a unified SEED.md specification.

The seed synthesize command reads your preseed documents and creates a unified SEED.md that contains everything needed to scaffold your project.

Command#

bootspring seed synthesize [options]
OptionDescription
--forceOverwrite existing SEED.md
--prompt-onlyGenerate AI prompt instead of SEED.md (free tier)

What It Does#

1. Reads Preseed Documents#

The command reads all documents from .bootspring/preseed/:

  • VISION.md - Problem, solution, unique value
  • AUDIENCE.md - Target users, personas
  • BUSINESS_MODEL.md - Revenue, pricing
  • PRD.md - Product requirements
  • TECHNICAL_SPEC.md - Architecture, tech stack
  • ROADMAP.md - Development phases

2. Extracts Key Information#

From each document, it extracts:

SourceExtracted Data
VISION.mdProject name, problem, solution
AUDIENCE.mdTarget user description
BUSINESS_MODEL.mdPricing model, revenue streams
PRD.mdMVP features, user stories
TECHNICAL_SPEC.mdTech stack, architecture
ROADMAP.mdPhases, priorities

3. Generates SEED.md#

Creates a unified specification:

1# My Project 2 3> A platform that helps developers ship faster 4 5## Overview 6 7**The Problem:** Developers spend too much time on boilerplate... 8 9**Our Solution:** An intelligent scaffolding tool... 10 11**Target Users:** Solo developers and small teams... 12 13--- 14 15## Tech Stack 16 17\`\`\`yaml 18stack: 19 framework: nextjs 20 language: typescript 21 database: postgresql 22 hosting: vercel 23 24frontend: 25 uiLibrary: shadcn 26 styling: tailwind 27 stateManagement: zustand 28 29backend: 30 orm: prisma 31 auth: clerk 32 payments: stripe 33 34testing: 35 unit: vitest 36 e2e: playwright 37 38deployment: 39 ci: github-actions 40 hosting: vercel 41\`\`\` 42 43--- 44 45## MVP Features 46 47### Core Features (Must Have) 481. User authentication and onboarding 492. Main dashboard with key metrics 503. Core product functionality 514. Basic settings page 52 53### Secondary Features (Should Have) 545. Email notifications 556. Data export 567. Team invitations 57 58### Nice to Have 598. Dark mode 609. Mobile responsive design 6110. API access 62 63--- 64 65## User Stories 66 67### US-001: User Registration 68As a new user, I want to create an account so that I can access the platform. 69 70**Acceptance Criteria:** 71- [ ] User can sign up with email 72- [ ] Email verification sent 73- [ ] Onboarding flow completes 74 75### US-002: Dashboard Access 76... 77 78--- 79 80## Development Standards 81 82### Code Style 83- TypeScript strict mode enabled 84- ESLint + Prettier configuration 85- Server Components by default 86 87### Security 88- Input validation with Zod 89- CSRF protection 90- Rate limiting on API routes 91 92### Testing 93- Unit tests for utilities 94- Integration tests for API routes 95- E2E tests for critical flows 96 97--- 98 99## Architecture Notes 100 101[High-level architecture from TECHNICAL_SPEC.md] 102 103--- 104 105## Source Documents 106 107This SEED.md was synthesized from: 108- .bootspring/preseed/VISION.md 109- .bootspring/preseed/AUDIENCE.md 110- .bootspring/preseed/BUSINESS_MODEL.md 111- .bootspring/preseed/PRD.md 112- .bootspring/preseed/TECHNICAL_SPEC.md 113- .bootspring/preseed/ROADMAP.md 114 115Generated by Bootspring v1.3.5

Example Usage#

Basic Synthesis#

1# Synthesize from preseed documents 2bootspring seed synthesize 3 4# Output 5Reading preseed documents... 6 ✓ VISION.md 7 ✓ AUDIENCE.md 8 ✓ BUSINESS_MODEL.md 9 ✓ PRD.md 10 ✓ TECHNICAL_SPEC.md 11 ✓ ROADMAP.md 12 13Extracting project information... 14 ✓ Project name: DevTool Pro 15 ✓ Tech stack: Next.js + TypeScript + PostgreSQL 16 ✓ MVP features: 8 identified 17 ✓ User stories: 12 extracted 18 19Generated SEED.md successfully! 20 21Next steps: 22 1. Review: cat SEED.md 23 2. Scaffold: bootspring seed scaffold --preset=nextjs

With Force Overwrite#

bootspring seed synthesize --force

Overwrites existing SEED.md without prompting.

Free Tier (Prompt Only)#

bootspring seed synthesize --prompt-only

Generates an AI prompt at .bootspring/preseed/prompts/synthesize-seed.md that you can use with external AI services.

Free Tier Workflow#

If you're on the free tier:

  1. Generate the prompt:

    bootspring seed synthesize --prompt-only

  2. Copy the prompt:

    cat .bootspring/preseed/prompts/synthesize-seed.md | pbcopy

  3. Paste into ChatGPT/Claude

  4. Copy the AI's response

  5. Save as SEED.md:

    pbpaste > SEED.md

After Synthesis#

Review SEED.md#

# View the file cat SEED.md # Or open in editor code SEED.md

Make Adjustments#

Edit SEED.md to:

  • Adjust tech stack choices
  • Reorder MVP features
  • Add missing details
  • Correct any inaccuracies

Scaffold#

# Preview what will be created bootspring seed scaffold --preset=nextjs --dry-run # Generate project bootspring seed scaffold --preset=nextjs

Troubleshooting#

"No preseed documents found"#

Make sure you have documents in .bootspring/preseed/:

ls .bootspring/preseed/*.md

If empty, run preseed first:

bootspring preseed start

"Incomplete preseed documents"#

Synthesis works best with complete documents. At minimum:

  • VISION.md
  • PRD.md

Run the preseed workflow to complete:

bootspring preseed workflow status bootspring preseed workflow resume

"SEED.md already exists"#

Use --force to overwrite:

bootspring seed synthesize --force

Or rename the existing file:

mv SEED.md SEED.backup.md bootspring seed synthesize

Best Practices#

Complete Preseed First#

Better preseed documents = better SEED.md:

# Check preseed status bootspring preseed workflow status # Should show 100% complete

Review Before Scaffolding#

Always review SEED.md before scaffolding:

  • Verify tech stack is correct
  • Check MVP feature priorities
  • Ensure user stories are accurate

Keep SEED.md Updated#

SEED.md is a living document. Update it as your project evolves:

# After major changes code SEED.md # Re-scaffold specific parts bootspring seed scaffold --component=api

Related#