New series: what assistive tech really hears on your checkout page. Start with part one →
Shipwright
Home
Career Jun 7, 2026 3 min read 371 views

The Code Review Checklist We Stopped Using

Sam Whitfield

Sam Whitfield

Engineering manager and recovering QA lead.…

Share

Our twenty-item checklist slowed reviews down. Here is the three-question version that replaced it. The hardest problems on an engineering team are rarely technical. This post is about the habits and small agreements that let a group of people ship good work without burning out.

Cover illustration for the article The Code Review Checklist We Stopped Using
Figure 1. Our twenty-item checklist slowed reviews down. Here is the three-question version that replaced it.

Why this matters

We changed one thing at a time and wrote down why. That record turned out to be the most useful part, because six months later nobody remembered the original problem.

  • Agree on what code review is for.
  • Write decisions down where people will find them.
  • Automate style arguments away.
  • Pair new people with a named mentor.

What we changed

Reviews got faster once we agreed on what they are for: catching bugs and sharing knowledge. Style debates moved to the linter, and architecture debates moved to a short design note before any code was written.

Program testing can be used to show the presence of bugs, but never to show their absence!

Edsger W. Dijkstra, Notes on Structured Programming, 1970

Quick takeaway

Write it down; future you is a new team member too.

How it went

📝

Written decisions

Context survives when people move on.

🤝

Mentoring

Every new hire has a named buddy.

🧭

Clear reviews

Reviews catch bugs and spread knowledge.

Remote work made all of this more deliberate. Decisions that used to happen in a hallway now happen in writing, which is slower in the moment and much faster for everyone who joins later.

Questions, corrections, and war stories are welcome in the comments. Several of our best follow-up posts started as a reader pointing out something we had missed.

We will revisit this in six months with fresh numbers. If the results change, we will update the post and note what changed at the end.

If you try this on your own project, start with one page or one service rather than the whole codebase. A small experiment gives you real numbers to argue with, and it is easy to roll back if the idea does not fit.

We have been running this approach for several months now. The initial setup took about a day, and the ongoing cost is close to zero once the team knows where to look.

None of this is new, and that is the point. The techniques that last are usually the boring ones that are documented well and supported by the platform itself.

As always, the examples are simplified to fit on a page. The production version has more error handling and logging, but the shape of the code is the same.

Wrapping up

We have been running this approach for several months now. The initial setup took about a day, and the ongoing cost is close to zero once the team knows where to look.

Sam Whitfield

Sam Whitfield

Author

Engineering manager and recovering QA lead. Sam writes about testing, code review, and building teams that ship calmly.

Related Posts

Comments 12

Mara Okafor Member

The part about naming things made me laugh, then made me go rename three functions.

Sam Whitfield Author

Glad it helped!

Mara Okafor Member

Tried it on a side project over the weekend and it worked first time, which never happens.

Kofi Mensah

Great post. Did you measure the impact before and after, or is this mostly from experience?

Fatima Zahra

Would love a follow-up on how you test this in CI.

Hannah Becker

Thanks for including the numbers. So many posts skip the measurement part.

Lena Novak

The part about naming things made me laugh, then made me go rename three functions.

Kofi Mensah

Came for the snippet, stayed for the explanation.

June Park Member

Thanks for including the numbers. So many posts skip the measurement part.

Oskar Nilsson

We run this in production at a fairly large scale and can confirm the caveats are real.

Yuki Tanaka

Great post. Did you measure the impact before and after, or is this mostly from experience?

Oskar Nilsson

Tried it on a side project over the weekend and it worked first time, which never happens.

Leave a comment

Your email will not be published. Sign in for a faster experience.

Supports **bold**, *italic*, and `code`.