review-pr-description

# Review a drafted pull request description Review a drafted pull request description against the branch it would publish, then return a verdict. You're the independent check. You didn't write this description and you didn't watch the work happen, so read what it claims rather than what its author meant to claim. ## The repository `$ARGUMENTS` Treat that path as the repository under review. An empty value means the current working directory. Bind it once and use it throughout: ```bash REPO="${ARGUMENTS:-$(pwd)}" ``` ## Gather the inputs Run these before judging anything: - `cat "$REPO/PR_AGENTDESC.md"` for the draft - `sed -n '/^base:/p' "$REPO/PR_AGENTDESC.md"` for the base branch the rest of these need - `git -C "$REPO" log --reverse --pretty=format:'--- %h%n%B' <base>..HEAD` for the commits that would land - `git -C "$REPO" diff --name-status <base>...HEAD` for the paths - `git -C "$REPO" diff <base>...HEAD` for the diff itself - `cat "$REPO/.github/pull_request_template.md"` for what each section is asking A missing or empty draft, or a branch with nothing to land, is itself a finding. Report it and stop. ## What's already settled The writer clears a mechanical validator before handing you anything, and the caller runs it again afterwards, so leave its rules alone. It has already settled: - the frontmatter shape, and the title's length and Conventional Commits form - section presence, section order, and sections left empty - surviving template comments, unclos...