Workflow Approval | Bootspring Docs

The workflow approval system provides a structured process for reviewing, refining, and approving your preseed documents before moving to the seed phase.

Overview#

Instead of generating all documents at once and hoping they're right, the workflow system guides you through:

Generate each document type
Review the content
Refine as needed
Approve or reject
Move to next document

This ensures quality and completeness before you start building.

Starting a Workflow#

bootspring preseed workflow start

This initializes the workflow state and begins the approval process.

Workflow Commands#

`workflow start`#

Begin a new workflow from the beginning.

bootspring preseed workflow start

What happens:

Workflow state is initialized
You're guided to the first document
Progress tracking begins

`workflow resume`#

Continue from where you left off.

bootspring preseed workflow resume

Picks up at the last incomplete step.

`workflow status`#

View current progress.

bootspring preseed workflow status

Example output:

Overall Progress: [████████░░░░░░░░░░░░░░░░] 25%
4/16 documents approved

Phases:
  ✓ Foundation (2/2)
      ✓ Vision
      ✓ Audience

  ▶ Market Analysis (0/2) ← current
      ◇ Market
      ○ Competitors

  ○ Business Strategy (0/2)
      ○ Business Model
      ○ PRD

  ○ Technical Planning (0/2)
      ○ Technical Spec
      ○ Roadmap

Status indicators:

✓ - Approved
◎ - In review
◇ - Draft (generated, not reviewed)
✗ - Rejected (needs revision)
○ - Pending (not yet generated)

`workflow reset`#

Start over from scratch.

bootspring preseed workflow reset

This clears all workflow state but keeps your documents.

Document Commands#

Manage individual documents within the workflow.

Approve a Document#

bootspring preseed doc vision approve

Marks the document as approved and moves to the next step.

Reject a Document#

bootspring preseed doc vision reject "Needs more specific pain points"

Marks for revision with feedback. The feedback is saved for reference.

Edit a Document#

bootspring preseed doc vision edit

Opens the document in your default editor ($EDITOR or vim).

View a Document#

bootspring preseed doc vision view

Displays the document content in the terminal.

Submit for Review#

bootspring preseed doc vision review

Calculates a quality score and flags potential issues.

Document Types#

Type	File	Description
`vision`	VISION.md	Problem, solution, unique value
`audience`	AUDIENCE.md	Target users, personas, ICP
`market`	MARKET.md	TAM/SAM/SOM, trends
`competitors`	COMPETITORS.md	Competitive analysis
`business-model`	BUSINESS_MODEL.md	Revenue, pricing
`prd`	PRD.md	Product requirements
`technical-spec`	TECHNICAL_SPEC.md	Architecture, stack
`roadmap`	ROADMAP.md	Phases, milestones

Workflow Phases#

Documents are organized into phases:

Phase 1: Foundation#

Vision
Audience

Start here. These documents inform everything else.

Phase 2: Market Analysis#

Market
Competitors

Understand your space.

Phase 3: Business Strategy#

Business Model
PRD

Define how you'll make money and what you'll build.

Phase 4: Technical Planning#

Technical Spec
Roadmap

Plan the implementation.

Quality Scoring#

When you submit a document for review, Bootspring calculates a quality score:

bootspring preseed doc vision review

Output:

Quality Analysis: VISION.md

Score: 78/100

Strengths:
  ✓ Clear problem statement
  ✓ Specific solution defined
  ✓ Unique value proposition present

Areas for improvement:
  ⚠ Pain points could be more specific
  ⚠ Missing "Why now?" section
  ⚠ No supporting data/metrics

Suggestions:
  1. Add 2-3 specific pain points with examples
  2. Include market timing rationale
  3. Add industry statistics or research citations

Example Workflow#

Step 1: Start the Workflow#

bootspring preseed workflow start

Step 2: Generate First Document#

The workflow prompts you to generate the Vision document:

bootspring preseed init --doc=vision

Step 3: Review#

bootspring preseed doc vision review

Score: 72/100 - "Good, but could be better"

Step 4: Edit#

bootspring preseed doc vision edit

Make improvements based on feedback.

Step 5: Re-review#

bootspring preseed doc vision review

Score: 89/100 - "Excellent"

Step 6: Approve#

bootspring preseed doc vision approve

Workflow moves to next document (Audience).

Step 7: Continue#

Repeat for each document until all are approved.

Step 8: Complete#

bootspring preseed workflow status

Overall Progress: [████████████████████████████████] 100%
8/8 documents approved

All documents approved! Ready for seed phase.

Next steps:
  bootspring seed synthesize

Team Workflows#

For teams, combine workflow with cloud sync:

Assign Documents#

# Developer A works on technical docs
bootspring preseed doc technical-spec edit
bootspring preseed push --doc=technical-spec

# Developer B works on business docs
bootspring preseed doc business-model edit
bootspring preseed push --doc=business-model

Review Process#

# Lead reviews submitted documents
bootspring preseed pull
bootspring preseed doc technical-spec review
bootspring preseed doc technical-spec approve  # or reject with feedback
bootspring preseed push

Tips#

Don't Rush#

The workflow is designed to slow you down for a reason. Spending time here saves time later.

Use the Quality Score#

Aim for 80+ on important documents like Vision and PRD.

Iterate#

It's normal to reject and revise documents multiple times. That's the point.

Get Feedback#

Share documents with others before approving:

# Export for sharing
cat .bootspring/preseed/VISION.md | pbcopy

preseed start - Smart entry point
Cloud Sync - Team collaboration
seed synthesize - Next step after workflow