This website uses cookies

Read our Privacy policy and Terms of use for more information.

Cheaper, faster AI execution moved developer workload from writing code to reviewing it, rather than eliminating it. Faros AI's telemetry found median code review time up 441.5% even as raw task throughput rose 33.7%, adding roughly 11.4 extra hours a week per developer. Harness's 2026 State of Engineering Excellence report backs that up: 81% of developers now spend more time in review since their teams adopted AI, and 28% report review time up 30% or more. The fix is a five-part prompt contract that tells an agent what to run, what success looks like, and when to stop.

Why Cheaper AI Didn't Cut the Work

The promise of AI agents was a magic button: tell the model what to do, then walk away. The reality for solo creators and small teams running real workflows looks nothing like that. You stop doing manual data entry or routine coding, but you pick up something heavier: writing detailed operational specs, reviewing every output, and hunting for edge cases the agent missed. The effort doesn't disappear. It shifts from production to supervision.

That shift has a name. Newsletter writer Nate Substack calls it agent fatigue, and the math behind it is simple: an agent can generate code or draft copy far faster than a human can read it. When you write something yourself, you catch your own logical errors as you go, because you're in the weeds the whole time. When an agent writes it, the generation is invisible. You're just handed a finished product that looks confident, which means your brain has to work twice as hard to hunt down the subtle mistakes hiding inside plausible-looking output. Harness's researchers found the same pattern at scale: AI code "reads like it was written by a careful senior developer," so the errors that slip through are harder to catch than the ones people used to write themselves. The review is harder, not just longer.

The Five Supervisory Prompt Patterns

Before an agent touches a single file, five parameters need to be explicit rather than assumed:

  1. What to run. A complete, repeatable workflow instead of a one-off question, ideally triggered by a webhook or cron rather than a manual prompt.

  2. What "good" looks like. Hard-coded success criteria. A language model is a token prediction engine, so without an explicit target, it keeps generating until it guesses it's done rather than actually confirming it.

  3. What the agent may touch. Explicit read and write boundaries, permissions that allow safe actions and deny anything destructive, like deletes.

  4. How the result is checked. An automated validation step, not a human eyeballing the output cold. A web-builder agent, for example, should take its own screenshots and check DevTools for errors before presenting a first draft.

  5. What changes on repeated errors. A mechanism for logging gotchas into a file like claude.md or a custom skill so the agent stops repeating the same mistake.

Claude.md and Plan Mode: Guardrails Before the Agent Starts

A claude.md file works like a README written for the AI instead of a human: project context, ground rules, and folder structure, dropped directly into the project so every session starts with the same boundaries. Keep it to 150-200 lines and point to external files for anything heavier, so it doesn't eat the context window on its own.

The single most effective rule to put inside it is plan mode: the agent is forbidden from writing or executing anything until it submits a written plan and gets explicit human approval first. Two minutes spent reviewing a bulleted plan is cheaper than the hours it takes to untangle code built on a wrong assumption.

Breaking the Single-Agent Bottleneck

Plan-mode approval solves one problem and creates another: if a single person has to approve every plan and review every output, that person becomes the bottleneck, and the whole system is gated by their attention span. The fix is structural, not procedural: multi-agent teams instead of one generalist doing everything.

Platforms like Paperclip work as an orchestrator, a virtual office manager that routes tasks between specialized agents. Instead of one agent writing code and being trusted to check its own work, a builder agent writes it and a separate QA sub-agent, whose entire job is trying to break the builder's output, checks it before it ever reaches a human. The person reviewing the final result is reviewing pre-audited work, not a first draft.

Mission Control Replaces the Chat Box

Managing multiple agents from a chat window hides failures and makes it impossible to track spend. Frameworks like Hermes solve this by pulling agent activity into a dashboard: columns for active workflows, error logs, and real-time token budgets, all visible in one place instead of scattered across chat threads. Solo creators aren't chatting with a bot anymore. They're monitoring a telemetry system for their own business, which turns a tinkerer into something closer to a systems architect.

The Reaction Getting Louder Online

The clearest signal of this shift showing up outside research reports is a r/ClaudeCode thread with 138 upvotes and 45 comments, titled "being a senior engg just means reviewing everyone else's AI code." The engineering lead who posted it described the exact dynamic: "some people on the team are shipping way more PRs with agents, but they couldn't care less about reviewing it - all that verification work gets pushed onto the senior engineers (aka me) - we've started using auto reviewers (macroscope) for the obvious stuff and low risk PRs, which helps a lot." Agents lowered the cost of generating code, not the cost of trusting it, and the gap lands on whoever signs off.

Even the automated fix is becoming its own overhead. On GitHub, review bots like codeant-ai[bot] and chatgpt-codex-connector[bot] now post status comments directly on pull requests, but one sampled comment was the bot itself reporting it had hit its usage limit for code reviews. Automating review to fight review fatigue is now something teams have to manage capacity for in its own right.

On the prompt side, the framing that's winning isn't cleverer wording, it's treating instructions like workspace governance. A TikTok from @techtiff puts it directly: "Now AI works with your files, tools, and accounts. So it needs operating instructions for your workspace. Define the job, limit what it has access to, and set rules for which actions require your approval... keep those instructions inside the project with an AGENTS.md, CLAUDE.md, or similar instruction file." A separate r/ClaudeCode thread comparing Claude Code to Cursor found the same theme repeating across 104 comments: planning, agentic implementation, worktrees, MCPs, and rules files all multiplying at once, meaning every new capability is also a new thing a human has to check.

Frequently Asked Questions

Why did AI agents increase code review time instead of reducing it?
Because AI-generated code reads like it was written by a careful, experienced developer, so the mistakes hiding inside it are subtler than the mistakes a person would normally write and catch themselves. Faros AI measured median review time up 441.5% even as raw output rose 33.7%, and Harness found 81% of developers spending more time in review since adopting AI tools.

What are the five supervisory prompt patterns?
What to run, what "good" looks like, what the agent may touch, how the result is checked, and what changes after repeated errors. Together they turn a vague instruction into a contract the agent can be held to, rather than a task it has to guess when to stop on.

What does a claude.md or AGENTS.md file actually do?
It works as an onboarding document for the AI rather than a human: project context, ground rules, folder structure, and access boundaries, read at the start of every session so the agent doesn't have to be re-briefed each time.

Do multi-agent teams actually reduce the review burden on one person?
Yes, when they're structured with a dedicated QA sub-agent whose only job is checking the builder agent's work before a human ever sees it. The human then reviews pre-audited output instead of a first draft, which is a meaningfully smaller job than catching every mistake cold.

Watch the full breakdown:

Want more of this? Join the free newsletter for daily breakdowns of what's actually working in AI agents, coding tools, and automation.

Reply

Avatar

or to participate