How it works
- Request a review — The plan owner requests a review by entering a reviewer’s email address
- Reviewer is notified — The reviewer receives an email notification and sees an unread indicator in their sidebar
- Open in review mode — When the requested reviewer opens the plan, they land directly in review mode instead of a normal read view
- Review the plan — The reviewer reads through the plan and either:
- Approves the plan — signals it’s ready for implementation
- Requests changes — signals the plan needs more work
- Iterate — If changes are requested, the owner updates the plan and re-requests review
- Withdraw — A reviewer can withdraw their review at any time
Review statuses
When an agent requests a review with the
Comments MCP tool’s request_review action or waits on one with AwaitReview, the tool result includes a direct link to the review, not just the review status.
Access and permissions
Requesting a review automatically grants the reviewer write access to the plan. This lets them leave inline comments and suggest edits directly. Reviewer replies and comment threads also appear in the plan’s sidebar, so feedback stays available in a persistent thread list as well as inline in the document.Email notifications
Both the reviewer and the plan owner receive email notifications:- Reviewer gets notified when a review is requested
- Owner gets notified when a review is submitted (approved or changes requested)