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.
- Source specification:
.agents/skills/pr-review/SKILL.md - Normative standard:
pr-review-standard.md(v1.5.0) - Canonical role map & closure gate: Roles, skill workflows, and runtime closure
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, useday-one-review.
Core invariants¶
- Architecture before runtime: Trace
design thesis -> decision -> contract -> implementation -> verificationagainst the target repository's architecture docs or ADRs (when present) before trusting passing tests. Never rewrite contracts to match defective code. - Eleven mandatory categories (
ARCH–DEP,SEC): Map every changed artifact to one primary category acrossARCH,DOC,SKILL,MCP,RUN,SVC,DB,SCRIPT,TEST,DEP, andSEC(security, trust boundaries, and vulnerabilities) without double-counting. Exploitable security defects own primary categorySECand cross-reference affected layers. - Strict content vs. integrity gate: Separate
Content Verdict: PASS | FAIL | BLOCKEDfrom the independent flat Integrity Auditor'sTarget Squad,Evidence Digest: <64-hex>, andIntegrity Verdict: CLEAN | INTEGRITY VIOLATION. 1 ID = 1 Rowdurability: Assign one atomic ID per defect (P0–P210-field records;P3compact table rows) and route post-remediation residuals, deferred items, and by-design observations exclusively to Section 8.
Workflow¶
- Pre-flight intake (
Operator / Review Lead): Ask neutrally when topology (Flatvs.Layeredvs.Single-Agent Audit), workspace isolation, evidence retention, or model is unspecified, and confirm the flat Integrity Auditor gate (audit-<id>/integrity_auditor[:<id>]). - Pin provenance: Record repository, PR URL, base/head SHAs, uncommitted dirty delta, CI run SHAs, append-only
Session Provenancetable, file inventory, and evidence limits. - Architecture trace & 11-category review: Trace contracts before runtime checks, evaluate all eleven categories (
ARCH–DEP,SEC), and coordinate/swarmspecialists viaswarm-governanceif multi-agent execution is selected. - 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. - Verdict, re-verification & delivery: Recommend
Approveonly when material categories are covered, blockers are closed and re-checked at the fixed commit, and audit status isCLEAN. Deliver the structuredv1.5.0report in chat or an Antigravity artifact by default, or save todocs/reviews/<review-slug>.mdwhen the repository already maintainsdocs/reviews/or the user explicitly requests it.