josephschmitt/monocle/review-plan-wait

Send Plan to Monocle and Wait for Review

Submits a plan file to Monocle and blocks until the reviewer responds with feedback.

Important: This is for content that isn't already a tracked file change — plans, architecture docs, summaries, etc. You do NOT need to send regular code files; Monocle automatically picks up file changes in the workspace and shows them as diffs.

Steps

1. Find the plan file — if the user provided a path via $ARGUMENTS, use that. Otherwise, find the most recently modified plan file in the project.

1. Read the plan file to confirm it exists and get its filename.

1. Run `monocle review send-artifact --wait` with:

• --title: The first markdown heading from the plan, or the filename if no heading found
• --file: Absolute path to the plan file
• --id: The plan filename (e.g. my-plan.md) — ensures updates replace the previous version
• --type: md
• --wait: Blocks until the reviewer responds

1. Handle the response:

• If the reviewer approved with no comments, inform the user and continue
• If the reviewer provided feedback requesting changes, share the feedback with the user and act on it — update the plan, then run monocle review send-artifact --wait again
• Keep iterating until the reviewer approves

If any command fails with a message that Monocle is not running, let the user know they need to start Monocle with monocle in the same directory as the project.