I want it be positive, but it’s a bit hard with this one. Do you expect the client to sit down and explain every detail? If they know how to do that, they wouldn’t be having messy code base as the one the post is describing.

And let’s say you’ve been hired, what happens after that? You think Claude.md file is sufficient to progress from that point?

The problem is real, but the solution is a fantasy.

We do the initial code review by ourselves, we try to run test, run the project etc. We compose a list of what we have in the codebase and what we think it does. We also preapre a list of what functionalites we would change.

Example would be removing service implementation that is bash code handling manually PID files, and replacing it with pm2 tool, that has quite different workflow.

So the client must approve such decisions.