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