glossary · The process

Fix loop

definition

A fix loop is a workflow pattern where work that fails a check is sent through a fix and back to an earlier step, so it comes round again until it passes, instead of moving on with the failure.

in one line: Failed work goes back through a fix and comes round again.

in context

Where does a fix loop fit?

Fix it, then check it again. In ConvOps, a failed review sends the work through a fix and back to verify.

findings: back to fix
fixreviewsign-offdone
Review sends it back until the gate opens on green.
two ways to say it

What is a fix loop, in plain words?

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

Without a loop, the last step ships whatever it got. With one, failure has a path back.

Return to the step that checks the fix, not to the very start.

for engineers

A decision has a pass and a fail condition. The fail condition invokes a fix sub-workflow.

resume_at names the earlier step to return to. Each pass is kept in the step history.

the longer answer

Why does a fix loop matter?

A linear process ships whatever the last step produced. If a review finds problems, the agent is left to remember to go back, and in a long session it often does not. A fix loop makes "go back and fix it" part of the structure: the check is a decision, one outcome is "passed", the other is "needs fixes", and the failure path leads back.

Good fix loops return to the right place. Sending failed work back to the very start wastes the steps that were fine. Sending it only to the fix step skips re-verification. The usual shape is: build, verify, review; if the review fails, run a fix, then return to verify, so the fixed work is checked again before it can reach review a second time.

Placing a gate after the loop turns it into an enforced definition of done. The work cannot move past the gate until the condition is met, so "only merge on a passing review" becomes a property of the process, not a hope about the agent.

in convops

How does a fix loop work in ConvOps?

In ConvOps, a fix loop is built from two primitives. A decision step has a passing condition and a failing condition; the failing condition invokes a fix sub-workflow. The decision also names where the run resumes when that sub-workflow finishes, typically an earlier step such as verify. The exit is always a choice made at the decision, by the agent or a person, and every pass round the loop is kept in the step history. Steps in the loop run one after another; nothing in one workflow runs at the same time. If you want an approval before the work moves on, put a requires_approval gate on the step after the loop: it holds the step until an explicit approval is given, recorded with the account that gave it.

questions

What do people ask about a fix loop?

What is a fix loop in ConvOps?

A fix loop is a pattern where work that fails a check goes through a fix and back to an earlier step until it passes. In ConvOps it is built from a decision with a passing and a failing condition: the failing one invokes a fix sub-workflow, and the decision names where the run resumes, typically the verify step. Every pass is kept in the step history.

Where should a fix loop send failed work?

Back to the step that re-checks it, not to the start and not straight to review. In ConvOps the usual shape is build, verify, review: a failed review runs a fix sub-workflow, then the decision resumes the run at verify, so fixed work is checked again before it reaches review a second time.

Who decides when a fix loop exits?

The decision step decides. In ConvOps the agent or a person picks the passing or the failing condition on each pass, and every pass is kept in the step history, so you can see how many rounds a piece of work took. A requires_approval gate after the loop can also hold the work for a reviewer.

Can a fix loop require human approval?

Yes. In ConvOps, put a requires_approval gate on the step after the loop: it holds the step until an explicit approval is given, recorded with the account that gave it. Only work that passed the loop and was approved moves on, so "only merge on a passing review" becomes a property of the process.

Who uses fix loops outside software?

Fix loops serve any team whose work is checked and sent back, not only software teams: an editor returning a draft, a controller rejecting a reconciliation, a reviewer failing a test run. In ConvOps the loop sends failed work through a fix and back to the check, and the step history shows how many rounds each item took.