orchestrator

name	orchestrator
description	Submit development specs, approve execution plans, monitor workers, retry failed tasks, check job status, and manage orchestration jobs. Use when asked to start a development job, check worker progress, approve a plan, retry something, or list orchestrator jobs.

Orchestrator

Submit development specs for multi-agent decomposition and parallel execution.

Submit a Spec

Decompose a development task into a parallel execution plan:

scripts/api.sh POST /orchestrate/submit '{
  "title": "Add user authentication",
  "description": "Implement JWT-based auth with login/register endpoints",
  "constraints": ["Use existing User model", "Add pytest tests"],
  "acceptance_criteria": ["All tests pass", "Endpoints return proper status codes"],
  "max_workers": 3,
  "budget_usd": 5.0,
  "provider": "anthropic"
}'

Returns: job_id and decomposed task plan. Always summarize the plan for the user before approving.

Approve a Plan

After reviewing the plan, approve to begin execution:

scripts/api.sh POST /orchestrate/{job_id}/approve '{}'

Check Job Status

Monitor worker progress and task states:

scripts/api.sh GET /orchestrate/{job_id}/status

Returns: task states (pending/running/completed/failed), worker assignments, budget usage.

Retry a Failed Task

Retry a specific failed task within a job:

scripts/api.sh POST /orchestrate/{job_id}/task/{task_id}/retry '{}'

List All Jobs

scripts/api.sh GET /orchestrate/jobs

Delete a Job

Destructive — confirm with user first.

scripts/api.sh DELETE /orchestrate/{job_id}

List Available Providers

Check which LLM providers are configured for planning:

scripts/api.sh GET /orchestrate/providers

Example Interactions

User: "Build me an auth system with JWT" → Ask for any constraints. Compose a spec. Call POST /orchestrate/submit. Summarize the decomposed plan. Ask user to approve before calling /approve.

User: "What's the status of my last job?" → Call GET /orchestrate/jobs to find the latest. Call GET /orchestrate/{job_id}/status. Report task states and budget usage.

User: "Task 3 failed, retry it" → Call POST /orchestrate/{job_id}/task/{task_id}/retry. Report result.