DEV Community

Cover image for I told Claude Code to report and stop before building. The feature already existed.
Rapls
Rapls

Posted on

I told Claude Code to report and stop before building. The feature already existed.

I make a WordPress caching plugin. It has a free version and a Pro version.

The Pro version has a setting I'll call "max delay." It holds back jQuery and inline scripts until the visitor's first interaction. On sites I maintain, turning it on raised the PageSpeed Insights mobile score a lot, so I decided to move it into the free version.

I planned the work in a chat with Claude and wrote a handoff document for Claude Code to implement it.

Section 4 of that document was titled "Report this first (stop here)." Claude Code stopped there and sent a report before writing any code.

The first line of the report broke the whole plan. Max delay had been a free feature since version 1.10.38.

What section 4 asked

At the top of the handoff, in the status line, I wrote:

First, do the "current state" report in ยง4 and stop. Implementation starts after I've reviewed it.

Section 4 asked five things:

  1. How is max delay implemented today? Which class and option name? How is it different from the free version's normal delay?
  2. Does Pro have a default exclusion list? If so, what's in it?
  3. How do the current presets treat the free delay and Pro's max delay?
  4. When both free and Pro are active, how do we keep the delay from being applied twice?
  5. What changes in free and in Pro? Which files, and roughly how many new translation strings?

Every question was about how to do the move. None of them asked whether the move was needed.

But you can't answer the first question without reading the current code. And once you read it, you can see which side the feature lives on.

What the report changed

Claude Code's report came down to this:

  • Max delay has been a free feature since 1.10.38. It isn't Pro-only.
  • The free version scored lower because its "Auto" button doesn't turn on delay or max delay.
  • In the free version, turning it on by hand gives the same behavior.

Then I re-read my own measurements. I had compared "free only" with "Pro with max delay on." The real difference was whether the free Auto preset turns max delay on.

The move was cancelled. The new task became: have the free Auto preset turn on max delay, only for themes I've tested.

If it hadn't stopped

If the handoff had just said "move max delay into the free version," Claude Code would have built a second copy of a feature the free version already had. Two option names. Possibly a setting where nobody could tell which one was active. The handoff also asked to prevent double-application when both versions are installed, so there'd have been extra work verifying that too.

You can undo that kind of mistake after implementation. It's much cheaper to catch it in one report, before any code exists.

The person writing the handoff gets things wrong too

This handoff was written by me and Claude in a chat. My first question was "Should I move some Pro features to free?" Both of us carried the assumption that max delay was a Pro feature, all the way into the handoff.

The person writing the handoff doesn't remember every line of the current code. The agent that can read the code does.

So a "report the current state and stop" section is where the writer's assumptions get checked by the one who can actually look.

How I write the stop section now

  • Put "report this section and stop" at the very top of the handoff, not buried in the middle.
  • Ask questions that can only be answered by reading the current code: class names, option names, what it does today.
  • You don't need to ask "is this necessary?" directly. Asking how things work today brings wrong assumptions to the surface.
  • When the report comes back, re-read your own numbers and reasons too.
  • If the premise was wrong, rewrite the handoff. Don't push the original task through.

Does your handoff have a place where the agent stops before it starts building?


Disclaimer: The handoff quotes in this post are translated from my own Japanese document. English isn't my first language, so I use an AI assistant to help draft and edit the writing.

Top comments (0)