Orchestrator API
The Orchestrator API provides intelligent agent coordination, context analysis, workflow management, and recommendation services. It is the brain behind Bootspring's intelligent assistance.
Overview
The Orchestrator manages:
- Context Analysis: Understanding what you're working on
- Agent Suggestions: Recommending the right experts
- Workflow Management: Guiding structured development processes
- Recommendations: Suggesting skills, workflows, and actions
REST API Endpoints
Analyze Context
Analyze context and get intelligent suggestions.
Request Body:
Response:
Get Recommendations
Get intelligent recommendations for agents, skills, and workflows.
Request Body:
Response:
List Workflows
List all available workflows.
Response:
Get Workflow Details
Get detailed information about a specific workflow.
Parameters:
| Parameter | Type | Description |
|---|---|---|
key | string | Workflow identifier |
Response:
Start Workflow
Start a workflow.
Response:
Advance Workflow
Advance to the next phase of the active workflow.
Response:
Mark Checkpoint
Mark a completion signal as done.
Request Body:
Response:
Get Status
Get current orchestrator status.
Response:
MCP Tool
The bootspring_orchestrator MCP tool provides orchestrator functionality to AI assistants.
Tool Definition
Actions
| Action | Description | Parameters |
|---|---|---|
analyze | Analyze context | context |
suggest | Get agent suggestions | context |
recommend | Get recommendations | context, limit |
workflows | List all workflows | - |
workflow | Get workflow details | workflow |
start | Start a workflow | workflow |
next | Advance workflow | - |
checkpoint | Mark signal complete | signal, workflow (optional) |
status | Get current status | - |
Examples
Analyze context:
Get recommendations:
Start workflow:
Mark checkpoint:
Workflow Phases
The orchestrator tracks development phases:
| Phase | Description | Typical Agents |
|---|---|---|
initialization | Project setup | software-architect, devops-expert |
requirements | Defining requirements | product-expert, software-architect |
design | Technical design | software-architect, frontend-expert |
implementation | Building features | frontend-expert, backend-expert |
testing | Writing tests | testing-expert |
debugging | Fixing issues | debugging-detective |
optimization | Performance tuning | performance-expert |
deployment | Going live | devops-expert, security-expert |
maintenance | Ongoing work | varies |
Advanced Features
Workflow Composition
Create custom workflows by composing phases. See Workflow Composition for details.
Agent Collaboration
Coordinate multiple agents on complex tasks. See Agent Collaboration for details.
Parallel Phase Execution
Run phases in parallel for workflows that support concurrent execution. See Parallel Execution for details.
Adaptive Workflows
Handle failures and remediation during workflow execution. See Adaptive Workflows for details.
Error Handling
Workflow Not Found
No Active Workflow
Premium Required
Best Practices
- Start with Analysis: Always analyze context before starting workflows
- Follow Workflow Phases: Let the orchestrator guide you through structured development
- Mark Checkpoints: Track progress by marking completion signals
- Use Recommendations: Follow agent and skill recommendations for best results
- Handle Failures: Use adaptive workflows when things go wrong
Related
- Agents API - Agent invocation
- Skills API - Skill patterns
- Workflows - Workflow documentation
- bootspring_orchestrator MCP Tool - MCP tool reference