Automation levels

L1, L2, and L3: how each step decides how much human involvement it needs.

Every step in a workflow runs at one of three automation levels.

The three levels

LevelNameWho runs itHuman approval
L1AutonomousAutomationNone (runs on its own)
L2Automation + approvalAutomationA human must approve the output
L3ManualA humanN/A (fully manual)

The ceiling

Each step has a max level, the highest level it's allowed to reach. A step whose ceiling is L2 can never drop its approval gate, no matter how well it performs.

Client-facing work is a classic L2-ceiling step: a draft offer is never sent without a human approving it.

How a step's level is set

A step's level comes from its definition:

  • No handler (no automation) → L3, fully manual.
  • Handler + requires_approval → L2, automation runs but a human approves.
  • Handler, no approval → L1, autonomous.

Read Promotion & drift to see how an L2 step can be promoted to L1, and pulled back.

Overrides

When an automated step (L1 or L2) completes by hand instead, it's recorded as an override. The platform tracks overrides so autonomy and override stats stay accurate even when the workflow definition changes.