Review plan documents with an independent critical pass, then patch them in place with minimal high-value edits. Use when a plan needs a quality gate before implementation.
[optional: path to plan document]
Run a high-signal quality gate on a plan and improve it in place.
Primary input: $ARGUMENTS
If a path is provided, use it. If no path is provided:
docs/plans/ for the most recent *.md.docs/brainstorms/.Before reviewing, re-read AGENTS.MD and any local conventions relevant to planning.
Use these constraints as hard checks while reviewing.
Read the entire document once without editing. Capture:
Do not edit during this pass.
Apply the review lenses in references/review-lenses.md.
At minimum, evaluate:
Record issues with severity (blocker, high, medium, low) and evidence.
Revise the document directly with targeted edits:
If a major conceptual rewrite is required, pause and ask the user before proceeding.
Re-read the edited plan end-to-end and verify:
If this directory is a git repo, commit the Plan edits as a docs-only commit so reviewers can diff/rollback the plan independently of code changes.
git status --porcelain and git diff -- <plan-path>git add <plan-path>git commit \
-m "docs: <primary theme> in <slug> plan" \
-m $'Changes:\n- <edit 1>\n- <edit 2>\n- <edit 3>'
Example:
git commit \
-m "docs: tighten acceptance checks in search-api plan" \
-m $'Changes:\n- Make validation commands explicit per milestone\n- Reorder steps to satisfy dependencies\n- Add rollback notes for migration step'
Format results using assets/fresh-eyes-report-template.md.
Include: