Building with Workflows

A practical guide to using Bootspring workflows for efficient development

This guide shows you how to effectively use Bootspring workflows for your development process, from simple features to complex releases.

Understanding Workflows#

Workflows are structured development processes that:

  • Guide you through phases with the right agents
  • Track progress with completion signals
  • Ensure quality with best practices at each step

Choosing the Right Workflow#

For New Features#

Use Feature Development for most new functionality:

Loading code block...

This workflow guides you through:

  1. Design - Plan the feature with ui-ux-expert and api-expert
  2. Implementation - Build with backend/frontend experts
  3. Testing - Verify with testing-expert
  4. Review - Final check with security/performance experts

For Bug Fixes#

For small fixes, you might not need a full workflow. But for significant bugs:

Loading code block...

For Security Work#

Use Security Audit for security-focused work:

Loading code block...

For Performance Work#

Use Performance Optimization:

Loading code block...

For Releases#

Use Launch Preparation before deploying:

Loading code block...

Workflow Lifecycle#

Starting#

Loading code block...

Working Through Phases#

Each phase has recommended agents. Invoke them:

Loading code block...

Advancing#

When a phase is complete:

Loading code block...

Tracking Signals#

Mark completion signals as you achieve them:

Loading code block...

Completing#

When all phases are done:

Loading code block...

Practical Example: Building User Authentication#

1. Start the Workflow#

Loading code block...

2. Design Phase#

Loading code block...

Outputs:

  • API contract for auth endpoints
  • UI mockups for auth screens
  • Database schema for users

3. Move to Implementation#

Loading code block...

4. Implementation Phase#

Loading code block...

5. Move to Testing#

Loading code block...

6. Testing Phase#

Loading code block...

7. Move to Review#

Loading code block...

8. Review Phase#

Loading code block...

9. Complete#

Loading code block...

Using Parallel Execution#

For independent work, use parallel workflows:

Loading code block...

Backend and frontend development happen simultaneously:

Loading code block...

Handling Failures#

If something goes wrong:

Loading code block...

Chaining Workflows#

For complex processes, use composition:

Loading code block...

Best Practices#

1. Start with the Right Workflow#

Don't over-engineer small tasks, but don't skip workflows for complex work.

2. Use Agents at Each Phase#

The recommended agents exist for a reason. Invoke them.

3. Track Your Signals#

Completion signals help you know when phases are truly done.

4. Handle Failures Properly#

Use the remediation system instead of abandoning workflows.

5. Review Your History#

Loading code block...

Learn from past workflows to improve your process.

Quick Reference#

CommandDescription
workflow start <name>Start a workflow
workflow nextAdvance to next phase
workflow statusCheck current status
workflow signalsList completion signals
workflow checkpoint <signal>Mark signal complete
workflow pausePause the workflow
workflow resumeResume paused workflow
workflow report-failure <type>Report a failure