AI‑generated work is eroding trust in software engineering reviews
Engineers are grappling with a new reality: AI tools can draft code, explanations, and documentation that look polished and often work, even when the author hasn’t fully understood the solution. This shift means the traditional shortcut of trusting a teammate’s output is no longer reliable, forcing reviewers to question whether the submitter actually grasped the change before assessing its…
Key points
- AI can generate seemingly correct code and docs without the author understanding them
- Reviewers now must verify the submitter’s comprehension, adding extra scrutiny
- Adopt practices: read before sending, label unfinished work, and leaders set clear expectations
The article proposes concrete habits to restore confidence. Individual contributors should read and verify their own diffs, trim explanations to what reviewers need, and be transparent about unfinished work. Leaders are urged to redefine “ready for review,” encourage explicit statements about testing and verification, and model the same standards they expect. By making the author’s understanding explicit, teams can keep the speed benefits of AI while preventing a cascade of hidden errors and wasted review time.
The story so far
32 episodes →- AI‑generated work is eroding trust in software engineering reviews this story
AI Is Breaking This Thing We Call Trust
terriblesoftware.org · 10 September 2026
I want you to picture yourself in the early 1900s (in America), real quick. People have been using horses for their entire lives, and they are pros at it. Entire cities are actually built with the premise that horses are how we move from point A to B.
Then this Henry Ford guy shows up and turns the world upside down.
Over the next few years, people had to adapt to cars becoming part of everyday life. Habits built around the transportation they knew had to change.
I think that’s where we are right now. Most of us can see that AI is turning how we work upside down… But, just like in the early 1900s, we have to adapt to it. And it’s painful.
Here’s the thing: most of our habits at work still assume that producing something means you have to understand it. When you send me a PR, I assume you’ve at least read the code yourself, right? Or when you send me a brief, I assume you’ve done your research, etc.
Of course, these assumptions aren’t 100% reliable: engineers are able to copy/paste from Stack Overflow without understanding anything for years. But even in this case, it does take more effort, and reviewers are able to identify the gaps more easily.
AI makes it easy to generate code, explanations, answers to review questions, and entire docs without the author understanding any of it. Everything can look finished. Actually, more often than not, it can even be correct (!) without the author having checked it.
And that is the part that I’ve been struggling with recently, and what most of this post is about… I used to start reviewing work with the assumption that the other person did their homework. Now that may or may not be true, so instead of starting the review with a “is this a good change?” Now I often start with, “does the author understand what they’re sending me?”
All this to say that, at least right now (while we adapt), AI is breaking trust for me. And trust, especially at work, allows you to skip a bunch of steps (and save time!). When I trust a colleague, I can focus on just the parts that need another pair of eyes. I don’t have to repeat their entire investigation to feel comfortable with the output.
Sometimes the phrasing alone (“Yes — and the real unlock is…”) makes me suspicious. Which isn’t necessarily fair. But when I ask a specific question and get another (clearly AI-generated) explanation that doesn’t answer it, I have a reason to worry. The next thing they send me will get more scrutiny, even if they were more careful this time. A shortcut on one task can make working together harder for much longer.
Let me be clear and say that I’ve been that person myself. Yes, I merged an AI-written fix without understanding it. The fix was correct, but I hadn’t done the work to know that.
Maybe part of adapting to these tools is being more explicit about what putting our name on something means? It should mean you understand it and stand behind it. “Claude wrote it” doesn’t tell me what you checked or whether you agree with the result.
If you’re sending an early idea (or a proof of concept) that you want help with, say that! I mean, I can work with uncertainty… but it’s harder for me to work with something that’s not finished, but it’s being presented as such.
And when I ask you a question, I’m asking you a question (I have Claude and ChatGPT too, if I wanted their thoughts, I’d simply ask them). Of course, use whatever tools that might help with the answer, but take the time to decide whether the answer makes sense, or if it’s too long or if there are too many em dashes, before sending it back.
But let’s make this more actionable, with a few suggestions…
If you’re an engineer,
- Read before sending. Review your own diff, read your own doc. Cut the explanation down to what the reviewer needs and nothing else, please! It’s totally fine to spend a bit more time trimming down and editing something so others don’t have to spend their time reading fluff.
- Understand what you’re submitting. Do you really knowwhy the bug happened and why this fix will solve it? If not, go back and understand before asking me to review it.
- Push back when reviewing, too. Asking things like*“Which cases did you test?”* or*“What led you to this recommendation?”* are totally fine (and probably even expected!).
If you’re an engineering leader,
- “Ready for review” should mean it’s ready to be reviewed . Ask authors to explain what they checked and what still needs attention. But keep this proportional, because a risk-free change should not require pages and pages of evidence.
- Make it safe to share unfinished work .“I haven’t verified all this yet” is useful information. A proof of concept can deserve feedback just like finished work, provided that everyone knows what they’re reviewing.
- Apply the same standard to yourself . If you’re sending slop, of course your team will send each other slop. Be the role model!
Long story short, that’s the expectation I want us to keep as the tools change. Your name on the work should still mean I can trust you to understand it and stand behind it, especially before sending it to me.
Otherwise, every time you send me something, I have to do your part as well before I can do mine.
This text was published by terriblesoftware.org . It is reproduced here with attribution so you can read it in full; the rights remain with the publisher. Read it at the source ↗
Coverage and discussion
1 source- Hacker News discussion · 88 points news.ycombinator.com
The headline, key points and digest above were generated by Digest AI's editorial model from the linked sources. Automated summaries can contain errors: the sources are the record. Spotted a mistake? Tell us.
Comments
via GitHub Discussions