pr

PR

Agents review the PR first. The body is for the human who opens it afterwards and wants the essential at a glance: what changed shape, what was checked, what was decided, and what is left open. Not a wall of text, not every file. The body shows the change, then says only what a picture cannot. Every view is text, so an agent reads the same facts.

Input

$ARGUMENTS

• --dry-run: no push, no publish; print the title, the base, the body and the attachments instead.
• Paths ending in .png, .jpg, .gif, .mp4, .mov: files to attach. Alt text may follow the path after #.
• The rest: what the reviewer should know, kept as facts in the body.
• Empty: everything comes from the branch.

Protocol

1. Branch. git branch --show-current. On dev, main, the repo's default branch, or no branch: stop, show git status --short, ask for a branch name; with no user to ask, report no branch and stop. Uncommitted changes: stop and say so; the commit comes first (/git:commit).
2. Base. dev when origin/dev exists, else gh repo view --json defaultBranchRef. gh takes that bare name; a git command or the script takes origin/<base>, since a local branch of that name may be missing or stale.
3. Evidence. Read before citing.
   • git log --oneline origin/<base>..HEAD and git diff --stat origin/<base>...HEAD: the size, the files.
   • Tests added by the branch: git diff --stat origin/<base>...HEAD -- '*test*'.
   • The issue: Closes #N in a commit body, else the leading number of the branch name, else none. gh issue view <n> --json title,body when there is one.
   • When the issue has an Out of scope section: every file of git diff --name-only origin/<base>...HEAD that it names.
   • The repo's .claude/github-flow.json: the validate commands, and the verdict and tier commands of steps 8 and 9. Without the file, the validation commands of its AGENTS.md or CLAUDE.md. Its GLOSSARY.md or CONTEXT.md when one exists: the words that name the nodes of a view.
   • What ran this session, with its numbers.
4. Views. Pick the smallest view that makes the key point clear, from the table under Views. A standard change gets one; a large one gets one per concern, three at most, a Before/After pair counting as one. Past three, Left open names the views left out.
   • Moved, added or deleted directories: ${CLAUDE_PLUGIN_ROOT}/scripts/tree-diff.ts origin/<base> prints the tree diff. A directory moved, added or deleted whole is one line, and a directory where more than three files changed, all of them only modified, is a count. Keep the lines the reader needs and comment each one with what it owns now.
   • A Mermaid diagram: read references/mermaid.md first. GitHub's renderer has traps a terminal never shows.
   • Worked examples of every view: references/views.md.