bootspring_orchestrator | Bootspring Docs

Intelligent agent coordination and workflow management. Analyze context, suggest agents, and manage multi-step workflows.

Overview#

The bootspring_orchestrator tool (also known as the workflow tool) coordinates agents and manages workflows. It analyzes your project context, recommends the best agents to consult, and guides you through multi-step development processes.

Parameters#

Parameter	Type	Required	Description
`action`	string	Yes	Action to perform
`context`	string	No	Context text to analyze
`workflow`	string	No	Workflow name
`signal`	string	No	Completion signal ref for checkpoints
`limit`	number	No	Max recommendations (default: 5, max: 50)
`mode`	string	No	Entitlement mode: `local` or `server`
`entitled`	boolean	No	Override for premium workflows
`tier`	string	No	Tier override: free, pro, team, enterprise

Available Actions#

Action	Description
`analyze`	Analyze context and get suggestions
`suggest`	Alias for analyze
`recommend`	Get recommended workflows and skills
`workflows`	List all available workflows
`workflow`	Show specific workflow details
`start`	Start a workflow
`next`	Advance to next workflow step
`checkpoint`	Mark a workflow checkpoint complete
`status`	Get current orchestrator status

Usage Examples#

Analyze Context#

Use the bootspring_orchestrator tool with:
- action: "analyze"
- context: "I need to add user authentication with social login"

Response:

{
  "phase": "feature",
  "phaseName": "Feature Development",
  "suggestions": [
    {
      "type": "agent",
      "name": "security-expert",
      "reason": "Authentication implementation"
    },
    {
      "type": "skill",
      "name": "auth/oauth",
      "reason": "Social login patterns"
    }
  ],
  "skills": ["auth/clerk", "auth/nextauth", "auth/oauth"]
}

List Available Workflows#

Use the bootspring_orchestrator tool with:
- action: "workflows"

Response:

{
  "workflows": [
    {
      "name": "feature-development",
      "description": "Complete feature from spec to production",
      "tier": "free",
      "steps": 5
    },
    {
      "name": "code-review",
      "description": "Thorough code review process",
      "tier": "free",
      "steps": 4
    },
    {
      "name": "database-migration",
      "description": "Safe database migration workflow",
      "tier": "pro",
      "steps": 6
    }
  ],
  "hiddenCount": 3
}

Start a Workflow#

Use the bootspring_orchestrator tool with:
- action: "start"
- workflow: "feature-development"

Response:

{
  "success": true,
  "workflow": "feature-development",
  "currentStep": 1,
  "totalSteps": 5,
  "stepName": "Requirements Gathering",
  "instructions": "Review the feature requirements and create user stories...",
  "signalProgress": {
    "total": 5,
    "completed": 0,
    "signals": ["requirements-complete", "design-approved", "implementation-done", "tests-passing", "deployed"]
  }
}

Advance Workflow#

Use the bootspring_orchestrator tool with:
- action: "next"

Response:

{
  "success": true,
  "currentStep": 2,
  "totalSteps": 5,
  "stepName": "Design",
  "instructions": "Create technical design for the feature...",
  "signalProgress": {
    "total": 5,
    "completed": 1,
    "signals": ["requirements-complete", "design-approved", "implementation-done", "tests-passing", "deployed"]
  }
}

Mark Checkpoint Complete#

Use the bootspring_orchestrator tool with:
- action: "checkpoint"
- signal: "design-approved"

Response:

{
  "success": true,
  "signal": "design-approved",
  "completed": true,
  "progress": {
    "completed": 2,
    "total": 5
  }
}

Get Status#

Use the bootspring_orchestrator tool with:
- action: "status"

Response:

## Orchestrator Status

**Current Phase:** feature
**Active Workflow:** feature-development (Step 2/5)
**Available Agents:** 36

### Recent Suggestions
1. security-expert - Authentication implementation
2. auth/clerk skill - Clerk authentication pattern

### Workflow Progress
- [x] requirements-complete
- [x] design-approved
- [ ] implementation-done
- [ ] tests-passing
- [ ] deployed

Get Recommendations#

Use the bootspring_orchestrator tool with:
- action: "recommend"
- context: "Building a SaaS with Stripe billing"
- limit: 10

Response:

{
  "agents": [
    { "name": "backend-expert", "relevance": 0.9 },
    { "name": "security-expert", "relevance": 0.85 }
  ],
  "skills": [
    { "name": "payments/stripe", "relevance": 0.95 },
    { "name": "saas/subscription", "relevance": 0.88 }
  ],
  "workflows": [
    { "name": "saas-setup", "relevance": 0.92 }
  ]
}

Workflow Concepts#

Phases#

Projects go through development phases:

Phase	Description
`setup`	Initial project setup
`feature`	Active feature development
`testing`	Testing and QA
`deployment`	Production deployment
`maintenance`	Ongoing maintenance

Signals#

Signals are checkpoints within workflows that indicate progress:

Can be marked complete with exact text, partial match, or index
Track overall workflow progress
Enable resuming workflows

Tier Access#

Some workflows require specific subscription tiers:

Tier	Access
free	Basic workflows
pro	Advanced workflows
team	Team collaboration workflows
enterprise	Custom workflows

Error Handling#

Unknown Workflow#

{
  "error": "Unknown workflow: invalid-workflow"
}

Premium Workflow Access#

{
  "error": "Premium workflow access required",
  "tier": "pro",
  "upgradeUrl": "https://bootspring.com/pricing"
}

Best Practices#

Start with Analysis#

Run analyze first to understand your project context before starting a workflow.

Use Signals#

Mark checkpoints as you complete them to track progress accurately.

Follow the Flow#

Workflows are designed with specific ordering - follow steps in sequence for best results.

Combine with Agents#

Use workflow suggestions to invoke the right agents at each step.

bootspring_agent - Invoke suggested agents
bootspring_skill - Apply recommended skills
bootspring_assist - Natural language requests