pr-review-standards

Evidence-based PR reviews require proof-backed findings with code snippets, test results, or traces rather than assumptions. This standard enforces structured verification, type hints, logging hygiene, and contextual assessment to produce traceable, non-ambiguous review summaries aligned with severity levels.

Verifiable PR reviews flag uncertain findings as needs_verification, require concrete evidence for each claim, review functions with full context, and enforce consistent logging patterns and type hints. This creates auditable trails and prevents ambiguous or assumption-based feedback.

Apply standardized PR review patterns by codifying quality rules for security, performance, tests, and code analysis, then enforce try/except patterns, logging standards, and type hints during review. This ensures disciplined, repeatable assessment across all pull request validation workflows.

Yes, these standards apply when spawning PR review agents or validating code across code-analysis, security, performance, and verification workflows. They satisfy functional requirements for structured validation and traceable evidence collection in both manual and automated review contexts.

Flag uncertain findings as needs_verification rather than making assumptions. Provide evidence requirements—code snippets, test traces, or specific context—so reviewers can complete verification before approving or requesting changes.