Bootspring
HomeGet Started

Workflow Commands

Manage multi-phase workflows from the command line.

Synopsis#

bootspring workflow <command> [options]

Commands#

CommandDescription
listList available workflows
start <name>Start a workflow
status [id]Check workflow status
pause <id>Pause a running workflow
resume <id>Resume a paused workflow
cancel <id>Cancel a workflow

bootspring workflow list#

List all available workflows.

Usage#

bootspring workflow list [options]

Options#

OptionDescription
--tier <tier>Filter by tier
--category <cat>Filter by category
--jsonOutput as JSON

Example#

bootspring workflow list

Output:

Development Workflows (Free) ├── feature-development End-to-end feature building ├── database-migration Safe database migrations ├── security-audit Comprehensive security review ├── performance-optimization Performance improvement ├── code-refactor Structured refactoring └── bug-investigation Systematic debugging Launch Pack (Pro) ├── launch/pre-launch Pre-launch checklist ├── launch/waitlist Waitlist implementation ├── launch/landing-page Landing page creation ├── launch/launch-day Launch day execution └── launch/post-launch Post-launch optimization Fundraising Pack (Pro) ├── fundraising/readiness Fundraising readiness ├── fundraising/materials Pitch deck preparation ├── fundraising/targeting Investor targeting ├── fundraising/pitching Pitch meeting framework └── fundraising/closing Deal closing process Growth Pack (Pro) ├── growth/pmf Product-market fit ├── growth/metrics Metrics dashboard ├── growth/acquisition User acquisition └── growth/retention Retention optimization Enterprise Pack (Team) ├── enterprise/readiness Enterprise readiness ├── enterprise/sales Enterprise sales ├── enterprise/security Security compliance └── enterprise/implementation Enterprise onboarding

bootspring workflow start#

Start a new workflow.

Usage#

bootspring workflow start <name> [options]

Options#

OptionDescription
--params <json>Workflow parameters
--phase <name>Start from specific phase
--no-auto-advanceDon't auto-advance phases
--jsonOutput as JSON

Examples#

# Start feature development bootspring workflow start feature-development

Interactive prompts:

Starting: feature-development ═══════════════════════════════════════════════════════════════════ ? Feature name: User Notifications ? Requirements: Email, push, and in-app notifications Workflow started: wf_abc123 Phase 1/5: Planning Agent: architecture-expert Status: In Progress Use 'bootspring workflow status wf_abc123' to check progress
1# Start with parameters 2bootspring workflow start feature-development \ 3 --params '{"feature": "user notifications", "requirements": "email, push, in-app"}' 4 5# Start from specific phase 6bootspring workflow start feature-development --phase design 7 8# Non-interactive 9bootspring workflow start security-audit --params '{}' --json

bootspring workflow status#

Check workflow status.

Usage#

bootspring workflow status [id] [options]

Options#

OptionDescription
--allShow all workflows
--jsonOutput as JSON
--verboseShow detailed output

Examples#

# Check current workflow bootspring workflow status

Output:

Workflow: feature-development (wf_abc123) ═══════════════════════════════════════════════════════════════════ Status: Running Progress: 2/5 phases (40%) Phases ────── ✓ Plan completed (3m) ✓ Design completed (4m) ► Build in progress (12m) ○ Test pending ○ Review pending Current Phase: Build Agent: backend-expert Task: Implementing API endpoints Artifacts ───────── • plan.md Planning document • design.md Technical design Started: 2024-03-20 10:00:00 (19m ago)
1# Check specific workflow 2bootspring workflow status wf_abc123 3 4# Check all workflows 5bootspring workflow status --all 6 7# Verbose output 8bootspring workflow status --verbose

bootspring workflow pause#

Pause a running workflow.

Usage#

bootspring workflow pause <id>

Example#

bootspring workflow pause wf_abc123

Output:

Workflow wf_abc123 paused Current state saved at phase: Build Resume with: bootspring workflow resume wf_abc123

bootspring workflow resume#

Resume a paused workflow.

Usage#

bootspring workflow resume <id> [options]

Options#

OptionDescription
--retryRetry failed phase
--skipSkip failed phase
--phase <name>Resume from specific phase

Examples#

# Basic resume bootspring workflow resume wf_abc123

Output:

Resuming workflow wf_abc123 Restored checkpoint: Build phase Continuing from where you left off... Phase 3/5: Build Agent: backend-expert Status: In Progress
1# Resume with retry 2bootspring workflow resume wf_abc123 --retry 3 4# Skip failed phase 5bootspring workflow resume wf_abc123 --skip 6 7# Resume from specific phase 8bootspring workflow resume wf_abc123 --phase design

bootspring workflow cancel#

Cancel a workflow.

Usage#

bootspring workflow cancel <id> [options]

Options#

OptionDescription
--forceCancel without confirmation
--keep-artifactsKeep generated artifacts

Example#

bootspring workflow cancel wf_abc123

Output:

? Cancel workflow wf_abc123? (y/N) y Workflow cancelled Artifacts preserved in: .bootspring/workflows/wf_abc123/ To delete: rm -rf .bootspring/workflows/wf_abc123/

Workflow Artifacts#

Workflows generate artifacts in .bootspring/workflows/:

.bootspring/workflows/wf_abc123/ ├── state.json # Workflow state ├── plan.md # Planning document ├── design.md # Technical design ├── implement/ # Implementation artifacts │ ├── files.json # Created/modified files │ └── log.md # Implementation log ├── test/ # Testing artifacts │ ├── results.json # Test results │ └── coverage.json └── review/ # Review artifacts ├── security.md └── quality.md

Configuration#

Workflow Settings#

1// bootspring.config.js 2module.exports = { 3 workflows: { 4 'feature-development': { 5 phases: ['plan', 'design', 'build', 'test', 'review'], 6 agents: { 7 plan: 'architecture-expert', 8 design: ['database-expert', 'api-expert'], 9 build: ['backend-expert', 'frontend-expert'], 10 test: 'testing-expert', 11 review: ['security-expert', 'code-review-expert'], 12 }, 13 qualityGates: { 14 build: 'pre-commit', 15 test: 'pre-push', 16 }, 17 }, 18 }, 19};

Custom Workflows#

1module.exports = { 2 workflows: { 3 'my-custom-workflow': { 4 description: 'Custom development workflow', 5 phases: [ 6 { name: 'research', agent: 'research-expert' }, 7 { name: 'design', agents: ['database-expert', 'api-expert'] }, 8 { name: 'implement', agent: 'backend-expert' }, 9 { name: 'document', agent: 'content-expert' }, 10 ], 11 }, 12 }, 13};

Tips#

Monitor Long Workflows#

For long-running workflows:

# Watch status watch -n 5 bootspring workflow status wf_abc123 # Or use dashboard bootspring dashboard

Review Between Phases#

Check artifacts between phases:

# View planning output cat .bootspring/workflows/wf_abc123/plan.md # View design cat .bootspring/workflows/wf_abc123/design.md

Handle Failures#

When a phase fails:

1# Check what went wrong 2bootspring workflow status wf_abc123 --verbose 3 4# Retry the phase 5bootspring workflow resume wf_abc123 --retry 6 7# Or skip and continue 8bootspring workflow resume wf_abc123 --skip

Related#