hay-kot/dotfiles/diff-review

Diff Review

Open code changes in Plannotator's review UI, then act on the user's feedback in the same conversation. Plannotator's review mode handles both the current worktree (no args) and a specific PR (URL).

Argument handling

$ARGUMENTS controls what gets reviewed:

Don't try to detect or resolve the current PR yourself — plannotator review already inspects the worktree when called with no args. Just pass $ARGUMENTS through.

Run

plannotator review $ARGUMENTS

Run the command yourself. Don't ask the user to copy it into a terminal.

After plannotator returns

• Feedback or annotations returned — address each one in the same

conversation. For each comment, locate the referenced file/line, make the change, and summarize what was fixed. Offer to re-run review when done.

• Approval / LGTM — acknowledge the review passed and continue (commit,

push, open PR, whatever the next step is).

• No feedback returned — the user closed the session without comment. Say

so briefly and continue.

Notes

• Plannotator review surfaces diff-anchored annotations; treat each one as a

request for a specific code change, not a general suggestion.

• For deep multi-dimensional review (correctness, design, tests, comments) use

/review instead — that runs parallel sub-agents. This skill is for the human-in-the-loop browser review, not automated review.

• If the user wants to gate a markdown plan or research doc instead of code,

use /doc-review.