Switch workflow lanes (FAST / STANDARD / DEEP)
Lane selection governs how many phases run (spec writing, analyser, QA-only passes, cross-cutting review lenses, etc.) and therefore token spend (/guides/team-setup/). The concrete markdown lives in parallel workflow files such as:
workflows/job-fast/workflow.mdworkflows/job/workflow.md(STANDARD)workflows/job-deep/workflow.md
Coro plan mode on New Run also picks an initial lane when shaping the brief (lightest lane that fits — STANDARD by default). That choice is advisory; the Planner may still call switch_workflow after inspecting the repo. See /guides/coro-plan-mode/.
switch_workflow tool
The Planner (and occasionally Coder when scope explodes) calls switch_workflow with:
workflowPath— destination workflow relative path (must exist in some intelligence layer; resolver validates presence, not an allowlist).reason— human-auditable string stored injob.workflowPathHistory[].- Optional
toPhasewhen you must land on a specific entry phase.
The tool is a first-class MCP primitive — other automation (convert_to_campaign, reroute hooks) should funnel through it so history stays coherent (/reference/workflow-extension/).
Risk heuristics (STANDARD baseline)
From the base Planner agent’s matrix (paraphrased — always read your tenant copy):
| Signal | FAST bias | DEEP bias |
|---|---|---|
| Change touches public API / schema / cross-service contract | Require all “small change” checks | Any single strong signal can justify DEEP |
| Migration or durable state change | Usually not FAST | Usually DEEP (pair with db-migrations-safe skill) |
| Observability / security sensitive code paths | Downgrade only with evidence | Prefer DEEP when uncertain |
| Single repo, single reviewer, ≤ few files | Candidate for FAST | — |
FAST requires all FAST signals; any DEEP signal moves you to DEEP (or at least STANDARD). When in doubt, escalate via add_insight so future jobs learn the pattern (/guides/manage-memory/).
Lane-specific agent behaviour
Examples:
- Code reviewer skips heavy L3/L4 lenses on FAST but runs full cross-cutting review on STANDARD/DEEP (/guides/add-skill/ for
cross-cutting-review). - DEEP introduces dedicated Analyser + QA phases separating design notes from verification.
Custom lanes
Tenants may ship additional workflows/job-*.md files (for example compliance-heavy industries). So long as switch_workflow can resolve the path, the runner executes it — document your local naming scheme in tenant memory so operators know which lane id maps to which file.
Related reading
- /guides/run-campaign/ — lane choice also applies per child.
- /guides/cookbook/ — FAST vs DEEP recipes.