PR Lens Guides
PR Lens is the best way to reduce the cognitive load of reviewing AI-generated pull requests. These are its guides on reviewing pull requests written by coding agents.
The problem
- Reviewing AI-generated pull requests: the complete guideA working order for reviewing a pull request an agent wrote: read the shape, check CI, hunt duplicated code, trace one path, test the boundaries, then read lines.10 min read
- Cognitive load in code review: what it is and why agents make it worseCognitive load in code review is the working memory a reviewer spends holding a change in their head. Agent pull requests raise the part of it that carries no information.7 min read
- Your mental model of the codebase is one week oldAgents change code faster than a team can read it. The shelf life of what you know about your own repository has dropped from months to about a week, and reading every diff will not fix it.7 min read
- Five red flags in agent pull requests, and where each shows up in a diagramGitHub named five things to watch for in agent-written pull requests. Four of them have a visible shape once the change is drawn against the system around it. One does not.7 min read
- Vibe coding review: how to check code nobody read while it was writtenVibe-coded changes reach review having never been read by a person. That makes the review a first read, and a first read should start from the shape of the change.7 min read
- We drew ten landmark pull requests. Here is what they look likeReact Hooks, Node's fetch, Kubernetes Ingress and seven more, run through the PR Lens renderer. 269 changed files and 31,386 added lines came out as 37 lanes and 74 components.8 min read
- Agent pull requests lose the narrativeAn agent writes a pull request in one pass across backend, config, tests and UI, with none of the ordering a human author would have left behind. That missing order is why they are hard to read.7 min read
- Six in ten agent pull requests are never reviewed by a humanA 2026 study of 33,596 agent-authored pull requests found 61.38% had no recorded human review, and most of the review comments that existed were written by other agents.7 min read
- Ten times the pull requests, one reviewer: the arithmetic of the agent eraAgents raised how much code a team produces and left review capacity where it was. Four levers exist, three of them are already spent, and the fourth is cost per review.7 min read
- Why AI-generated pull requests wait 4.6 times longer for reviewLinearB measured 8.1 million pull requests and found AI-generated ones wait 4.6 times longer for pickup. The delay is comprehension cost, and it lands before review starts.7 min read
Playbooks
- How to review a 400-line pull request in ten minutesFour passes on a clock: the shape of the change, its edges, one traced path, then evidence. A method for reviewing large agent-written pull requests without reading every line.9 min read
- A code review checklist for agent-authored codeA copy-pasteable checklist for reviewing code an agent wrote, and the reason each line is on it. Shape first, CI second, duplication third, one traced path, then evidence.7 min read
- How to review pull requests from autonomous agents (Devin, Jules, OpenHands)Nobody watched this change being written and there is no session left to ask. A review method for pull requests that have to answer for themselves.9 min read
- How to review Claude Code pull requestsWhat a Claude Code pull request contains, the CI trap to check first, how to get a diagram out of the session that wrote it, and where Claude Code Review stops being enough.7 min read
- How to review Cursor background agent pull requestsCursor's cloud agents work in a sandbox VM you never see and hand you a branch. What to check first, what the attached artifacts prove, and where Bugbot's findings stop.7 min read
- AI pull request summaries vs diagrams: why a summary does not cut review timeA summary is more prose to read, written by the thing you are checking. A diagram is the shape of the change. The same pull request, done both ways.8 min read
- How to review OpenAI Codex pull requestsCodex writes the diff and the summary of the diff. Review the environment, the AGENTS.md, the shape of the change and one traced path, in that order.9 min read
- How to review GitHub Copilot coding agent pull requestsCopilot opens the pull request and Copilot reviews it. Here is how to review one yourself: the session log, the workflow approval, the shape of the change, one traced path.8 min read
- How to explain a pull request without walking someone through the diffOne sentence, then the shape, then a walk through it. A method for handing a code change to a reviewer, a teammate in another time zone, or someone who does not read code.7 min read
- How to review a pull request you didn't write, in a codebase you don't fully knowYou cannot hold an unfamiliar codebase in your head, and you do not have to. Review the boundary of the change and the assumptions it makes about everything around it.7 min read
Diagrams
- How to visualise a pull request as a diagram: five ways, rankedFive ways to turn a pull request into a diagram, ranked by how much of the diff each one saves you from reading: hand-drawn, Mermaid, your coding agent, a diff-to-diagram tool, PR Lens.10 min read
- Diagram the change before you open the pull requestDraw your change locally, look at it, fix what looks wrong, then open the pull request. Two commands with the CLI, or none if a coding agent is already open.7 min read
- What a good pull request walkthrough looks like (and why it is not a video)A walkthrough is a few steps, each pointing at one part of one diagram and saying one line about it. Here are the four steps of a real one, and why a screen recording cannot do the same job.8 min read
- One renderer, three sizes: a one-file fix, a feature, a monorepo refactorThe same renderer draws a one-line change and a thirty-seven component monorepo refactor. Here is what changes between those two pictures, and what deliberately does not.7 min read
- Why Mermaid is the wrong tool for code reviewMermaid is excellent at what it was built for: keeping documentation current. A pull request needs the opposite, and five properties of Mermaid work against it.8 min read
- Animated SVG in GitHub comments: what survives, what gets stripped, and why SMILAn animated SVG plays inside a GitHub comment if it arrives as an image and moves declaratively. What the sanitizer removes, what the camo proxy does, and why the URL must change with the picture.9 min read
- Blast radius diagrams: what a change touches, drawn against the systemThe blast radius of a change is everything it can reach, not everything it edited. Here is how to draw one, why unchanged components belong in the picture, and how to read it.7 min read
- Why the model should describe the graph and never draw itAn LLM asked for a picture gives you a picture that moves every time you ask. Have it write a typed graph document instead, and let a deterministic renderer draw it.7 min read
- How to generate an architecture diagram from a git diffYou can generate an architecture diagram from a diff, but not from the diff alone. Two working routes, with the real commands: your coding agent, or the PR Lens CLI with your own model key.8 min read
- Architecture, sequence or data-flow diagram: which one explains a code change?Architecture diagrams answer what a change can break. Sequence diagrams answer what happens in what order. A classic data-flow diagram answers neither, and most tools using that name draw a sequence.8 min read
Comparisons
- AI code review tools in 2026, grouped by what they actually doThere is no single best AI code review tool. There are four groups doing four different jobs: finders, commenters, workflow tools and explainers. Here is who is in each.9 min read
- Free and open source AI code review tools for maintainersWhich AI code review tools are actually free for public repositories in September 2026, which make you apply, which are open source you can self-host, and which are not free at all.8 min read
- PR Lens vs Claude Code ReviewClaude Code Review runs a fleet of agents over a pull request and comments on the lines it doubts. PR Lens draws the change. How they differ, and why teams run both.8 min read
- PR Lens vs writing a Mermaid diagram in the PR description yourselfMermaid in a pull request description is free, native to GitHub and better than nothing. Here is what it costs you, what the PR description skills fix, and where a generated render goes further.7 min read
- PR Lens vs Cursor BugbotBugbot reads a pull request diff for bugs and comments on the lines it doubts. PR Lens draws the change against the system around it. What each one is for, and why both fit in one PR.8 min read
- PR Lens vs GreptileGreptile and PR Lens both index your whole repository and then do opposite things with it. One hunts for bugs across the system. The other draws the change against it.7 min read
- PR Lens vs ToDiagram and other diff-to-diagram toolsToDiagram turns structured data into diagrams you can explore, and its skill will draw a pull request too. Here is where that differs from a render posted inside the pull request itself.8 min read
- PR Lens vs CodeRabbitCodeRabbit reviews the lines and draws a Mermaid sequence diagram of the new path. PR Lens draws what the pull request did to the system. Most teams run both.8 min read
- PR Lens vs GitHub Copilot code reviewCopilot code review comments on your lines in under 30 seconds and charges AI credits for it. PR Lens draws the change and is free for open source. They sit in the same pull request.7 min read
- PR Lens vs GraphiteGraphite makes pull requests smaller and merges them in order. PR Lens draws whatever pull request arrives. They solve opposite halves of the same problem and work together.7 min read
Reference
- What is PR Lens?PR Lens is the best way to reduce the cognitive load of reviewing AI-generated pull requests: animated architecture and data-flow diagrams, posted inside the pull request. Open source, MIT.8 min read
- What PR Lens does with your code: models, storage, retentionWhere your code goes when PR Lens draws a pull request: the sandbox, the model, what lands in R2 and Redis, what gets deleted, and which retention claims the code does not support.9 min read
- Configuring PR Lens with .github/pr-lens.ymlEvery option in .github/pr-lens.yml: lenses, branding, the four map corrections, and github.comment.collapsed. What the hosted App reads, and what only the CLI reads.8 min read
- How PR Lens keeps exactly one comment per pull requestA hidden marker, an author check, a Redis lease around creation and a reconcile pass. How a bot updates one comment in place instead of leaving five behind.8 min read
- The PR Lens CLI: diagram a change before you open the pull requestRun PR Lens locally with @coldtea/pr-lens-cli: analyze a diff, render the SVGs, compose the comment, validate a document, push a canvas. Your key, your machine.8 min read
- PR Lens glossary: lens, lane, delta, blast radius, walkthrough, canvasPlain definitions for every term PR Lens uses: lens, lane, node, edge, delta, blast radius, flow, view, walkthrough, canvas, baseline, atlas and the rest.9 min read
- The PR Lens graph document explainedThe JSON document PR Lens draws from: lanes, nodes, edges, flows, drill-down views and a walkthrough, with the field limits and the six rules only the parser can check.9 min read
- Installing the PR Lens GitHub App: what it reads, what it posts, what it never seesHow to install the PR Lens GitHub App, which events wake it, what it reads from your repository, and the two things it is allowed to write back.9 min read
- PR Lens as an agent skill: draw a change from inside Claude Code, Cursor or OpenCodeInstall the PR Lens skill with npx skills add coldteadotai/pr-lens and your coding agent draws the change it just made, using the model it already runs. No key to set up.7 min read
- The PR Lens GitHub Action: bring your own keyRun PR Lens from your own CI on your own model key: one workflow file, one repository secret, and the same diagrams the hosted App posts.7 min read