Skip to content

5.6 PR reviewability

5. Workflow / PL5-pr-reviewability

5.6 PR reviewability

agent-generated PRs include test evidence, screenshots, decision rationale, and rejected alternatives so a human can glance in <5 min. Branch is current with target when review is requested


Levels

Level 0

Code diff only

Level 1

Some PRs include evidence; branches are sometimes out-of-sync when review is requested

Level 2

Every PR is self-explanatory: tests, screenshots, reasoning, alternatives considered. Branch is current with target when review is requested โ€” reviewers don't receive stale diffs

Level 3

PRs with high glance-rejection rates analysed; agent prompts updated to address recurring weaknesses; review time (Glance Threshold) trends down over time. PR freshness maintained across the review lifecycle โ€” the diff a reviewer sees is the diff that actually merges


Recipes that advance this criterion

No recipes yet.