PaPoo
cover

The part of Claude Code nobody wants to talk about

What jumped out at me here is that the real bottleneck isn’t “prompting” in the shiny, influencer-ish sense. It’s alignment: getting the agent to share your mental model closely enough that you don’t spend your afternoon playing prompt ping-pong. That’s much less glamorous, but it’s the actual tax you pay once agents get good enough to produce plausible wrongness at speed.

I also think the author is most convincing when he talks about asking the model to confirm your understanding back to you. That’s not a revelation, but it’s a practical pattern, and I can see why it helps. It forces the model to expose the hidden assumptions before you’ve already burned time on implementation. If you’ve used Claude Code on a medium-sized task, you know the failure mode: the agent seems confident, you assume the plan is shared, and then three rounds later you discover you were never talking about the same thing.

The weaker part of the piece is the confidence around “more context is usually simply better.” Sometimes yes. Sometimes you just hand the model a bigger pile of noise and make the mismatch harder to spot. I’m not convinced length is the right metric here. Relevance and structure matter more than raw volume, and the article seems a little too happy to treat context stuffing as an unqualified win.

The most interesting bit, though, is the author’s own admission that he’s using a separate agent to help prepare prompts. That feels like the honest endpoint of this whole workflow: once the agent is doing enough of the thinking, you start chaining agents together to manage the ambiguity. Maybe that’s efficient. Maybe it’s just adding another layer of automation around the same human coordination problem. I’m not sure yet.

What I would actually try, reading this, is less “write longer prompts” and more “build a habit of forcing a crisp restatement before any real work starts.” Not every task needs plan mode, and I agree with that. But the ask-me-back pattern seems like the one thing here that could save you from a lot of wasted iterations without turning every change into a ceremony.


Reference: How to Effectively Align Your Intent with Claude Code | Towards Data Science

同じ著者の記事