Awaiting reviewPublish the revised onboarding guideReplaces the current guide for all new workspace owners.
A focused approval block with the proposed result, consequences, and distinct approve, revise, and reject paths.
OutcomeApproval becomes informed and auditable instead of a vague yes or no.Use when
A human must own a consequential decision before work proceeds.
Avoid when
The action is easily reversible and does not need a formal checkpoint.
Anatomy
- Proposal summary
- Impact
- Evidence link
- Approve
- Request changes
- Reject reason
Required states
- Awaiting review
- Approved
- Changes requested
- Rejected
- Expired
Build prompt
Build a Decision Approval component for [workflow].
Present one decision at a time. State what is being approved, what will happen next, which inputs informed it, and whether the action can be reversed. Keep Approve, Request changes, and Reject visually distinct without making the destructive choice dominant.
Require a short reason for rejection. Let a reviewer request changes with specific feedback. After any decision, replace the controls with a receipt containing the reviewer, time, decision, and next action.
Include awaiting-review, approved, changes-requested, rejected, expired, and permission-error states. Trap no focus, support keyboard use, and announce the saved decision.