FitWhen to use it — and when not
Use it when
- The action cannot be undone (send, pay, delete, publish)
- The action affects other people or costs money
- The agent made a judgement call the user may disagree with
Skip it when
- Easily reversible actions — use undo instead
- Purely informational steps
- Repeated low-risk actions where trust is established (offer "always allow")
AnatomyThe parts of the pattern
- ProposalOne sentence: what will happen, to whom, how many.
- DetailsPreview of content, affected items, cost, reversibility.
- ChoicesApprove, edit, cancel — plus "always allow" where safe.
- ExecutionProgress and the real outcome, including partial failures.
- AuditWho approved what, when.
GuidelinesDo & don’t
Do
- Say exactly what happens: "Send to 50 customers" not "Proceed?".
- State reversibility in plain words.
- Offer edit, not only yes/no.
Don’t
- Ask on every trivial step — people learn to click yes blindly.
- Stack several dialogs for one action.
- Show UUIDs and byte counts instead of a human summary.
From my projectsApprovals in production
Vigilo — risk alert
Raise the country risk to 4/5 and send a red alert
342 travellers in the region
Analyst track record: 94% accuracy
Send alert · Review data · Downgrade to yellow · Hold
EngiBoard — production deploy
Deploy to production on all 4 platforms
6 commits · 156/156 tests passing
Yes — previous version tagged for rollback
Deploy · View changes · Re-run tests · Cancel
Also used in Navigator.Taxi: before an agent locks a vehicle for overdue maintenance, the fleet manager sees the driver, reason, downtime and can notify the driver first.
In the wildReal-world examples
Products named for reference only — no affiliation, and the demo above is an original illustration, not a copy of their UI.
For engineersImplementation notes
- Model risky tools with a "requires_approval" flag; the agent loop pauses and emits a pending action instead of calling the tool.
- Store the approval (who, when, exact payload hash) and execute exactly that payload — never a re-generated one.
- Escalate to a person after repeated rejections instead of asking again.