max_revisions

Scope: domain • Default: 3

Integer lever. Maximum number of review → in_progress → review loops allowed before the task is marked blocked and surfaced in the coordinator inbox.

Storage

max_revisions:
  position: 5
  rationale: "Complex migration domain — reviewers are picky."

Why cap revisions

Without a cap, an LLM worker and an LLM reviewer can thrash indefinitely, each turn spinning without meaningful progress. The cap brings the task back to you once the loop has failed to converge.

When a task hits the cap, the blocking reason includes every reviewer verdict from the revisions, so you can see what was tried and rejected without having to hunt.