glossary · Human decisions

Workflow gate

definition

A workflow gate is a condition attached to a step that an engine evaluates on every attempt to advance; until the condition is met, the workflow refuses to move.

in one line: A condition the engine checks. Until it is met, the run waits.

in context

Where does a workflow gate fit?

A sentence asks. A gate holds. The same rule, written two ways. Only one of them stops the run.

in the prompt read by the AI

"wait for approval"

Shipped. Nobody said yes.

as a gate checked by the engine

Waiting for you.

two ways to say it

What is a workflow gate, in plain words?

Same idea at two depths: the plain version, then what the engine actually does.

"Wait for approval" in a prompt is a request. The AI can misread it or skip it.

A gate is checked by the engine, not by the AI. Until it passes, the work does not move, and you see exactly what is missing.

for engineers

A step can carry gate keys. Eight are evaluators, among them requires_approval, require_context, task_status, all_completed and wait_for_children.

A refused advance keeps the cursor where it is and returns unmet_conditions.

the longer answer

Why does a workflow gate matter?

Gates are the enforcement primitive of governed automation. The condition can be human (an approval must be given) or structural (all child work finished, a status reached, context recorded). What makes something a gate rather than an instruction is who evaluates it: an instruction is read by the model, a gate is checked by the engine.

That distinction is why gates hold against the failure mode instructions cannot: a model talking itself past a checkpoint. A refused gate returns exactly which conditions are unmet, which makes the block visible and actionable instead of silent.

Place gates sparingly and deliberately: each one is a point where the loop stops. The craft is putting them where the cost of a wrong advance is high (a release, an outbound message, a publish) and nowhere else.

Gates come in two families. Human gates wait for a person: an approval, or a recorded reason for a decision. Structural gates wait for a state of the work: a task status reached, all child tasks complete, required context written down. Both are evaluated the same way, on every attempt to move on, and both fail closed: an unmet gate means the run stays where it is.

in convops

How does a workflow gate work in ConvOps?

In ConvOps, a step can carry gate keys such as requires_approval, require_context, task_status, all_completed and wait_for_children. When an advance is refused, the cursor does not move and the response lists the unmet conditions, so the agent, or the person watching, knows exactly what is missing. A human approval gate pauses the run until approval is given, and a gate placed after a fix loop turns "only merge on a passing review" into a property of the process.

questions

What do people ask about a workflow gate?

What is the difference between a gate and an instruction?

An instruction is text the model reads and may skip. A gate is a condition the engine checks on every attempt to advance. If the condition is not met, the run stays at its step and the response lists what is missing.

What happens when an approver rejects a gated step?

In ConvOps a step can name an on_rejected target. A rejection moves the run to that step, for example back to the draft, and the step history records the rejection. A step without an on_rejected target refuses the rejection, and the run stays where it is.

Where should approval gates go in a workflow?

Where a wrong advance is expensive or hard to undo: a release, a payment, an outbound message, a publish. Every gate is a stop, so teams start with a few and remove the ones that never catch anything.