Skip to main content
Original: Simon Willison · 04/03/2026

Summary

The article discusses common anti-patterns in agentic engineering, emphasizing the importance of reviewing code before submitting pull requests to ensure quality and accountability.

Key Insights

“Don’t file pull requests with code you haven’t reviewed yourself.” — Emphasizes the responsibility of developers to ensure their code is ready for review.
“Your job is to deliver code that works.” — Highlights the primary responsibility of a developer in the coding process.
“It’s rude to expect someone else to read text that you haven’t read and validated yourself.” — Stresses the importance of validating pull request descriptions before submission.

Topics


Full Article

There are some behaviors that are anti-patterns in our weird new world of agentic engineering. Inflicting unreviewed code on collaborators This anti-pattern is common and deeply frustrating. Don’t file pull requests with code you haven’t reviewed yourself. If you open a PR with hundreds (or thousands) of lines of code that an agent produced for you, and you haven’t done the work to ensure that code is functional yourself, you are delegating the actual work to other people. They could have prompted an agent themselves. What value are you even providing? If you put code up for review you need to be confident that it’s ready for other people to spend their time on it. The initial review pass is your responsibility, not something you should farm out to others. A good agentic engineering pull request has the following characteristics: The code works, and you are confident that it works. Your job is to deliver code that works. The change is small enough to be reviewed efficiently without inflicting too much additional cognitive load on the reviewer. Several small PRs beats one big one, and splitting code into separate commits is easy with a coding agent to do the Git finagling for you. The PR includes additional context to help explain the change. What’s the higher level goal that the change serves? Linking to relevant issues or specifications is useful here. Agents write convincing looking pull request descriptions. You need to review these too! It’s rude to expect someone else to read text that you haven’t read and validated yourself. Given how easy it is to dump unreviewed code on other people, I recommend including some form of evidence that you’ve put that extra work in yourself. Notes on how you manually tested it, comments on specific implementation choices or even screenshots and video of the feature working go a long way to demonstrating that a reviewer’s time will not be wasted digging into the details.

Writing code is cheap now - Agentic Engineering Patterns - Simon Willison's Weblog

Simon Willison · explanation · 69% similar

AI should help us produce better code - Agentic Engineering Patterns

Simon Willison · how-to · 66% similar

What is agentic engineering? - Agentic Engineering Patterns

Simon Willison · explanation · 65% similar