Configure visual-verify gates

A visual-verify gate captures screenshots of a UI change and has a model judge them, so a backlog run that touches the interface is checked before it merges. The gate is configured per agent profile — a profile that builds UI turns it on and says what to capture.

Turn the gate on for a profile

1. Open the agent profile in the editor and switch to its Form tab.
2. In the Visual verify gate, set:
   • Enable — turn the gate on for runs that use this profile.
   • Capture routes — the app routes to screenshot (for example / and /tasks). Leave it empty to capture the root route only.
   • Viewports — which device widths to capture: mobile, desktop, or both.
   • Judge threshold — the minimum confidence (0–100) the model judge must reach for a pass. A pass below the threshold is treated as a fail.
3. Save the profile.

On a run that uses the profile, the gate captures the configured routes at the configured viewports, the judge scores them, and a score below the threshold holds the run for attention rather than letting it merge.

Note

The gate captures only what you list. With no routes set it captures the root route; with no viewports set it captures the full matrix. A higher threshold is stricter — a near-miss the judge would otherwise pass becomes a fail.

See also

• Approve agent actions
• Run the backlog