Make PR Easy to Review

Workflow

1. Resolve the target PR from the user-provided URL or current branch.
2. Inspect commits, diff size, changed paths, generated files, and PR description.
3. Identify reviewability issues: noisy commits, stale description, unrelated changes, mixed mechanical and logic changes, missing tests, or unclear reviewer entry points.
4. Propose a plan before rewriting history or force-pushing.
5. Apply safe improvements, then verify the tree or diff still matches the intended code.

History Cleanup

gh pr view <PR> --json title,headRefName,baseRefName,state,commits
git fetch origin <headRefName> <baseRefName>
ORIGINAL_TREE=$(git rev-parse origin/<headRefName>^{tree})

1. Schema/storage or generated API definitions.
2. Core logic.
3. Wiring and integration.
4. UI or surface behavior.
5. Tests.

echo "Original tree: $ORIGINAL_TREE"
echo "Current tree:  $(git rev-parse HEAD^{tree})"
git diff origin/<headRefName> --stat

Reviewer Guidance

• Add a TL;DR that matches the actual diff.
• Separate core files from generated or mechanical files.
• Call out risky behavior changes, migration order, rollout plan, and test coverage.
• Link issue trackers, dashboards, or design docs when they explain intent.

Guardrails

• Never hide meaningful behavior changes inside "cleanup".
• Do not bypass hooks unless the user explicitly asks.
• If the PR is too large to make reviewable with notes, recommend splitting instead of polishing around the problem.