Seed Generator Workflow

This guide covers both workflows for generating seed documents: the Dashboard path (BYOK Seed Generator) and the CLI path.

CLI Workflow (Recommended)#

Step 1: Initialize Context#

This creates .bootspring/context/ with markdown templates for your project's vision, audience, PRD, and more.

Step 2: Edit Documents#

Open each .md file in .bootspring/context/ and fill in your actual project details:

• VISION.md — Problem, solution, core values
• AUDIENCE.md — Target users, personas
• BUSINESS_MODEL.md — Revenue, pricing
• PRD.md — Product requirements, user stories
• ROADMAP.md — Phases, milestones

Step 3: Merge & Generate#

This creates:

• SEED.md — merged project specification
• CLAUDE.md, AGENTS.md, CODEX.md, GEMINI.md — AI context files
• planning/TODO.md, planning/MASTER_PLAN.md, etc. — build planning scaffold

Step 4: Customize Tasks#

Edit planning/TODO.md with your actual build tasks using the format:

Step 5: Start Building#

---

Dashboard Workflow (BYOK)#

Prerequisites#

• A Bootspring account on Pro tier or above
• An API key from Anthropic or OpenAI (or both for Enterprise dual-LLM)

Step 1: Add Your API Key#

1. Navigate to Dashboard > Settings
2. Scroll to the Provider API Keys section
3. Enter your API key in the appropriate field:
   • Anthropic: Paste your key starting with sk-ant-...
   • OpenAI: Paste your key starting with sk-...
4. Click Save — the key is validated and encrypted before storage

Step 2: Create a Project#

1. Go to Dashboard > Projects
2. Click New Project
3. Enter your project name and description

Step 3: Complete the Seed Wizard#

1. Open your project and navigate to Seed > Builder
2. Fill in each wizard section:
   • Identity: Project name, tagline, description, category
   • Problem: Problem statement, pain points, why now
   • Solution: Overview, unique value, key features
   • Audience: Primary audience, segments, personas
   • Market: TAM/SAM/SOM, growth, trends
   • Competition: Competitors, positioning, differentiators
   • Business Model: Revenue model, pricing tiers
   • MVP: MVP features, phase goals
3. Save your progress at each step

Step 4: Generate Documents#

1. Navigate to Seed > Studio
2. Verify your connected providers appear in the status bar
3. (Enterprise) Toggle Dual-LLM if you want merged output from both providers
4. Click Generate All to create all 8 documents

Generation takes 30–90 seconds per document depending on the provider.

Step 5: Review and Edit#

1. Click on any generated document card to view its content
2. Click the Edit icon to make manual adjustments
3. Click Save to persist your changes

Step 6: Download & Use#

1. Click Download ZIP in the Studio header
2. Extract the archive to your project:

1. Generate all context files:

---

Troubleshooting#

"Add an API key in Settings"#

You need to save at least one provider API key before generating documents.

"Upgrade to Pro for AI document generation"#

Document generation requires a Pro subscription or higher. Free tier users can use the CLI workflow with bootspring seed init.

"Monthly generation limit reached"#

Your tier's monthly generation quota has been exhausted. Limits reset on the first of each month.

"Invalid API key"#

The API key you entered failed validation. Check that you copied the full key and that it hasn't been revoked in your provider's dashboard.