Roman Lutz / writing Back to miscellaneous

Lutz’s Law.

The bigger the pull request, the further away the merge.

In open source, as the size of a pull request grows, its probability of being merged tends toward zero.

Originally about human review in open source. Internal PRs and AI change the picture.

One large pull requestStill in review
Small, reviewable changesMerged in steps
One change stuck in a review loop. Smaller changes landing along the way. An illustration, not measured data.

Lutz’s Second Law.

Less waiting, even in sequence.

One large pull request can take far longer to land than a series of smaller ones, even when the smaller changes add up to more code.

The first law is about whether a change lands. The second is about how long it takes to get there.

Every extra idea in a pull request gives a reviewer more to understand, more interactions to consider, and more reasons to ask for another revision. Smaller, coherent changes let the team make progress without first agreeing on everything.

These are rules of thumb born of open-source experience, not measured probabilities or guarantees. Some changes really do belong together. The point is to make the unit of review understandable.

One long review. Three smaller ones.

One large pull request

Review + rework Merged

Several smaller pull requests

PR 1 PR 2 PR 3 Merged
The smaller PRs are reviewed and merged one after another, not in parallel. Together, they can land sooner even when they add up to more code. Bar lengths are illustrative, not measured timings.

The internal reversal.

Sometimes, the biggest PR gets the least review.

Inside a company, I've also seen the opposite pattern: the larger a PR gets, the less likely it is to receive a proper review, and the more likely it is to be rubber-stamped.

In that setting, one enormous PR can merge much faster than the same work split across several smaller ones. Each small PR gets real scrutiny; the giant one gets an approval.

That is not an argument for enormous PRs. It is a warning about review quality: a fast merge is not the same as a proper review.

Faster approval. Less scrutiny.

One large PR, rubber-stamped

Approval Merged

Smaller PRs, each properly reviewed

PR 1 PR 2 PR 3 Merged
The large PR lands sooner because it gets less scrutiny, not because it is easier to review. The smaller PRs receive proper review one after another. Bar lengths are illustrative, not measured timings.

AI changes the bottleneck.

More review capacity. Still a need for judgment.

With AI doing much of the review work, the original laws apply less strongly. Large PRs can now receive detailed automated review rather than simply overwhelming the available human attention. Size alone becomes a less reliable predictor of whether a PR will merge or how long that will take.

That does not make every large PR a good idea. Reviewers may still push back, for good reason. Scope, architectural context, and whether the whole change can be understood and safely landed still matter.

AI review + human judgment.

AI reviewThe changeHuman judgment
AI can give a large PR detailed review; people still judge scope, architecture, and whether the change should land.

Put it into practice.

Small enough to understand. Complete enough to merge.

Split by idea, not by file count. Each change should tell one reviewable story. A small PR that cannot be understood without three unmerged siblings has not necessarily made the review smaller.

Keep the tests with the behavior. Smaller changes still need to be correct, useful, and safe to merge. Moving their tests into a later PR is not the shortcut.

Find the piece that unblocks someone else. A self-contained foundation can land while the rest of the feature is still being worked out.

One idea and its tests, at each step.

PR 1 + testsPR 2 + testsPR 3 + tests
Each small PR carries its own tests. Land the foundation first so someone else can build on it.

The receipts

Read the original October 21, 2021 tweet thread.


For the broader habit behind the law, read Ship in small, frequent slices in the field guide.