> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ref.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Review Requests

> PR-style review workflow for plans.

Ref Plans supports a PR-style review workflow so you can get structured feedback on your plans before sending them to agents.

## How it works

1. **Request a review** — The plan owner requests a review by entering a reviewer's email address
2. **Reviewer is notified** — The reviewer receives an email notification and sees an unread indicator in their sidebar
3. **Open in review mode** — When the requested reviewer opens the plan, they land directly in review mode instead of a normal read view
4. **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
5. **Iterate** — If changes are requested, the owner updates the plan and re-requests review
6. **Withdraw** — A reviewer can withdraw their review at any time

## Review statuses

| Status            | Meaning                                      |
| ----------------- | -------------------------------------------- |
| Review requested  | Waiting for the reviewer to look at the plan |
| Approved          | The reviewer has approved the plan           |
| Changes requested | The reviewer wants changes before approving  |

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)

You can configure notification preferences in your account settings to control which emails you receive.