Template
Memory Review
Review proposed durable context before it is saved or reused.
Memory Ledger ItemSource PreviewReference ItemDecision Surface
Use
Workflow Guidance
Use when an agent wants to remember preferences, facts, project constraints, or user corrections.
Human Control
Users can edit, scope, expire, save, or reject each proposed memory.
What Can Fail
A memory lacks source provenance, scope, expiry, or user consent.
Recovery Behavior
Keep the memory proposed, not saved, until provenance and scope are clear.
State Matrix
Required States
A template is only useful when it shows normal, blocked, and recovery states.
State Coverage
Proposed
User sees
Memory text, source, scope, and expiry.
System does
Stores the item in a review queue.
Saved
User sees
Where it applies and when it was last used.
System does
Makes it available to future matching tasks.
Removed
User sees
Removal confirmation and affected scope.
System does
Stops using the durable context.
| State | User Sees | System Does |
|---|---|---|
| Proposed | Memory text, source, scope, and expiry. | Stores the item in a review queue. |
| Saved | Where it applies and when it was last used. | Makes it available to future matching tasks. |
| Removed | Removal confirmation and affected scope. | Stops using the durable context. |
Implementation
Pattern Pieces
Templates are guidance; registry items stay smaller so teams can compose them into their own product surface.
Memory Ledger Item
A provenance-rich memory row with scope, expiry, last-used metadata, source inspection, edit, and removal actions.
Source Preview
A citation and provenance preview card with source title, excerpt, location, navigation, and open-source action.
Reference Item
A composable item row for sources, memories, findings, files, tasks, and agent activity with media, metadata, and action slots.
Decision Surface
A composable confirmation surface for approvals, risky actions, clarifying interruptions, and rollback decisions.
| Element | Spec |
|---|---|
| Memory Ledger Item | A provenance-rich memory row with scope, expiry, last-used metadata, source inspection, edit, and removal actions. |
| Source Preview | A citation and provenance preview card with source title, excerpt, location, navigation, and open-source action. |
| Reference Item | A composable item row for sources, memories, findings, files, tasks, and agent activity with media, metadata, and action slots. |
| Decision Surface | A composable confirmation surface for approvals, risky actions, clarifying interruptions, and rollback decisions. |
Build Rules
- 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.