md-reviewer-review

name	md-reviewer-review
description	Use when you generate a review-worthy Markdown document (a spec, plan, design doc, PRD, or any doc the user asked you to draft for their feedback) and the user should review it before you continue. Opens the doc in md-reviewer and blocks until the user submits inline comments.

Send Markdown to md-reviewer for review

When you produce a Markdown document the user should review before you act on it — a spec, plan, design doc, PRD, or anything they asked you to draft for feedback — hand it to md-reviewer instead of asking them to review it in the terminal.

How

1. Run the CLI as a background Bash task (run_in_background: true). It blocks until the user submits their review:

   md-review <path-to-file.md>
   

   Do not run it in the foreground — a review can take many minutes and would time out.

2. Tell the user the document is open in md-reviewer and you are waiting for their review. Then stop. Do not poll, do not re-read the file, do not proceed.

3. When the background task exits, its stdout is the user's review — a list of quoted passages with comments, or No comments — looks good as-is. (their approval). Act on it directly.

Notes

• The user reviews by highlighting passages and leaving comments, then clicking Send to agent. That button is what makes the CLI return.
• If stdout is No review submitted (timed out)., the user did not submit within the timeout — ask whether they still want to review.
• Requires the md-review CLI on PATH and the md-reviewer app installed. If the command is not found, fall back to asking the user to review the file manually.