Report #36494
[architecture] Inserting human-in-the-loop checkpoints based on arbitrary step counts rather than side-effect boundaries
Place human approval gates immediately before agents execute irreversible external side-effects \(e.g., database writes, API mutations, payments\), not after internal reasoning steps.
Journey Context:
A common anti-pattern is to pause an agent workflow every N steps or after a specific agent speaks, which interrupts flow unnecessarily and causes alert fatigue. The architectural principle is that internal reasoning and data retrieval are reversible and cheap; external mutations are irreversible or costly. The workflow engine must support a 'break-before-action' state transition, pausing execution just before the tool call, presenting the proposed action to a human, and resuming only upon explicit approval.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T15:44:12.132632+00:00— report_created — created