Skip to content

pr-review: Pull Request & Branch Review (Standard v1.5.0)

Use pr-review when auditing a pull request, branch diff, or CI run in the active repository. It is a Task Spec skill that enforces the Agy-Squad PR Review Standard v1.5.0 and pairs with swarm-governance when run across a /swarm team.

When to use pr-review

  • Reviewing a PR, branch comparison (base..head), or CI run against the repository's contracts and tests.
  • Re-verifying remediations on an existing PR review ledger before recommending approval.
  • For broad non-diff evidence bundles or Direction decisions, use full-review; for cold Day-1 external launch audits, use day-one-review.

Core invariants

  1. Architecture before runtime: Trace design thesis -> decision -> contract -> implementation -> verification against the target repository's architecture docs or ADRs (when present) before trusting passing tests. Never rewrite contracts to match defective code.
  2. Eleven mandatory categories (ARCH–DEP, SEC): Map every changed artifact to one primary category across ARCH, DOC, SKILL, MCP, RUN, SVC, DB, SCRIPT, TEST, DEP, and SEC (security, trust boundaries, and vulnerabilities) without double-counting. Exploitable security defects own primary category SEC and cross-reference affected layers.
  3. Strict content vs. integrity gate: Separate Content Verdict: PASS | FAIL | BLOCKED from the independent flat Integrity Auditor's Target Squad, Evidence Digest: <64-hex>, and Integrity Verdict: CLEAN | INTEGRITY VIOLATION.
  4. 1 ID = 1 Row durability: Assign one atomic ID per defect (P0–P2 10-field records; P3 compact table rows) and route post-remediation residuals, deferred items, and by-design observations exclusively to Section 8.

Workflow

  1. Pre-flight intake (Operator / Review Lead): Ask neutrally when topology (Flat vs. Layered vs. Single-Agent Audit), workspace isolation, evidence retention, or model is unspecified, and confirm the flat Integrity Auditor gate (audit-<id> / integrity_auditor[:<id>]).
  2. Pin provenance: Record repository, PR URL, base/head SHAs, uncommitted dirty delta, CI run SHAs, append-only Session Provenance table, file inventory, and evidence limits.
  3. Architecture trace & 11-category review: Trace contracts before runtime checks, evaluate all eleven categories (ARCH–DEP, SEC), and coordinate /swarm specialists via swarm-governance if multi-agent execution is selected.
  4. Independent integrity audit: When a cohort ran or integrity verification is enabled, run a flat Integrity Auditor (audit-<id>) to verify tool traces and SHA-256 digests before issuing a final recommendation.
  5. Verdict, re-verification & delivery: Recommend Approve only when material categories are covered, blockers are closed and re-checked at the fixed commit, and audit status is CLEAN. Deliver the structured v1.5.0 report in chat or an Antigravity artifact by default, or save to docs/reviews/<review-slug>.md when the repository already maintains docs/reviews/ or the user explicitly requests it.