Template
Review Workflow
Collect evidence, inspect gaps, ask focused follow-ups, and produce a reviewable result.
Use
Workflow Guidance
Use when an agent reviews source material and the user must trust, cite, or approve the result.
Human Control
Users choose source scope, answer unresolved questions, and approve the final summary before distribution.
What Can Fail
Sources conflict, required scope is missing, or the agent cannot verify a claim.
Recovery Behavior
Keep the draft blocked, show unresolved sources, and ask targeted clarifying questions.
State Matrix
Required States
A template is only useful when it shows normal, blocked, and recovery states.
State Coverage
User sees
System does
User sees
System does
User sees
System does
| State | User Sees | System Does |
|---|---|---|
| Collecting | Sources being touched and current collection progress. | Reads only selected or permitted project artifacts. |
| Blocked | Missing assumptions and the exact answer needed. | Pauses synthesis until the required decision is supplied. |
| Ready | Cited findings, confidence, and approval action. | Prepares the result without sending it automatically. |
Implementation
Pattern Pieces
Templates are guidance; registry items stay smaller so teams can compose them into their own product surface.
| Element | Spec |
|---|---|
| Observable Work | A step disclosure pattern for showing visible agent work, touched sources, state, and completion without exposing hidden reasoning traces. |
| Reference Item | A composable item row for sources, memories, findings, files, tasks, and agent activity with media, metadata, and action slots. |
| Clarifying Questions | A controlled question group for collecting missing requirements through text, single-choice, and multiple-choice prompts. |
| Action Preview | A locked consequence preview for approvals, external actions, document changes, and rollback-aware agent work. |
| Decision Surface | A composable confirmation surface for approvals, risky actions, clarifying interruptions, and rollback decisions. |
- ApprovalRisky external actions use a Decision Surface before execution.
- ProvenanceSources, memory, cost, and owner metadata stay visible at the decision point.
- RecoveryBlocked states expose the next input needed instead of showing indefinite activity.