AIToday
Zenn AI/MLPublished: Nov 3, 2026, 06:00 JST

Shift review from code to design when AI writes the code

Send on LINE
Shift review from code to design when AI writes the code

3 Key Points

  1. What happened

    A toB SaaS development department head describes his team's process: people review the AI's plan before implementation, then AI reviews the resulting code, leaving humans to check only for unrequested additions.

  2. Why it matters

    Catching a design mistake in code review can mean rewriting much of the code, while fixing the plan before any code exists is far lighter, and it narrows where people must read.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, every morning.

Context & Analysis

It positions itself against the current "merge without reading" debate, which mostly argues over which parts of code review people should read and which to hand to automated checks or AI review. The author instead moves the question one step earlier, to the plan the AI writes before any code exists. In his team's vocabulary, the plan is the document the AI produces before implementation, the design is what that plan decides (what to touch, the shape of data and APIs), and the instruction document is what implementation is handed once a person has checked the plan.

His case for the shift rests on volume and cost. More work delegated to AI means more pull requests in front of people, and reading all AI-written code is described as impractical on volume alone. Design errors also get more expensive the later they are found; if the shape of the data is wrong, much of the written code has to be redone. A plan is shorter than code and states intent directly, so it is faster to read than hundreds of lines of diff and easier to spot mistakes in, and because nothing has been written yet, a fix costs only the plan.

Implementation then follows the approved plan. The implementing AI is not allowed to make design judgments, and AI review checks whether the code matches the instructions, with a light review run on each implementation and a heavier review run in parallel before the PR is created. The author concedes that design review adds human effort, but says it is worth it, and he also mentions his personal macOS app tanacode, which he says is not an official Anthropic product, as a way to inspect changes before opening a PR.

FAQ
Does this mean nobody reads the AI-written code at all?
No. The author says he does not believe in reading none of it. People still check code review for anything added outside the requirements, because design review cannot catch what happens beyond the scope it set.
Who is allowed to make design decisions?
The AI drafts the plan, and a person checks that plan. What is not delegated is letting the implementing AI change the design while it writes.
What tool does the author mention for checking changes before a PR?
He personally builds a macOS app called tanacode, which he notes is not an official Anthropic product. It lists Claude Code sessions and lets him review branch changes and have Claude walk through its own code.
Send on LINE

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Next articleGPT-5.6 Sol, GPT-5.5 reward-hack to score, Deeb paper finds