IF $ARGUMENTS contains PR number or URL:
  Use provided PR identifier
ELSE:
  gh pr view --json number,url,baseRefName,headRefName

FAIL FAST if no open PR found for current branch.

gh repo view --json owner,name --jq '.owner.login + "/" + .name'

# PR metadata + diff
gh pr view $PR --json title,body,author,reviewRequests,reviews,labels,files
gh pr diff $PR

# Changed files list (for scope guard)
gh pr view $PR --json files --jq '.files[].path'

# Conversation comments (top-level PR discussion)
gh api repos/{owner}/{repo}/issues/$PR/comments

# Inline review comments (line-level feedback)
gh api repos/{owner}/{repo}/pulls/$PR/comments

# Review verdicts and summaries
gh api repos/{owner}/{repo}/pulls/$PR/reviews

For each comment/review:
  - blocking   — Must fix before merge
  - question   — Needs a response (may or may not need code change)
  - suggestion — Alternative approach worth considering
  - nit        — Minor style/preference, non-blocking
  - resolved   — Already addressed or outdated
  - unclear    — Cannot determine intent; needs clarification

ORDERED FIX PLAN:
1. [blocking]   — Description (file:line) — from: @reviewer
2. [blocking]   — ...
3. [suggestion] — ...
4. [nit]        — ...

UNCLEAR (need clarification before implementing):
- Comment #id: "..." — What is unclear

# Reply to an inline review comment thread
gh api repos/{owner}/{repo}/pulls/$PR/comments/{comment_id}/replies \
  -f body="Fixed — [brief description of change]. See [commit_sha_short]."

# Reply to a top-level issue comment
gh api repos/{owner}/{repo}/issues/$PR/comments \
  -f body="Addressed — [brief description]."

1. Run project tests (identify test command from package.json, Makefile, etc.)
2. Run linter if configured
3. Review full diff: git diff $(git merge-base HEAD origin/{base_branch})..HEAD
4. Confirm no unintended changes leaked in
5. Push
6. Watch CI: gh pr checks $PR --watch
7. Re-request review from original reviewers:
   gh pr edit $PR --add-reviewer {reviewer1},{reviewer2}

## PR Comment Resolution Summary

### Comments Addressed
- [blocking] {description} — {commit_sha_short} (replied to @reviewer)
- [suggestion] {description} — {commit_sha_short}
- ...

### Questions Answered
- @reviewer: "{question}" — replied with explanation

### Deferred Items
- {description} — Reason: {out of scope / needs design discussion / ...}

### Verification
- Tests: {PASS/FAIL — evidence}
- Lint: {PASS/FAIL — evidence}
- CI: {PASS/FAIL/PENDING — link}
- Review re-requested: {reviewers}