Comment by bornfreddy
25 days ago
My main grief with AI-generated docs is that they (unless the instructions were very clear on this) by default describe the path to the current code and how it is an improvement over what was before, instead of just explaining its purpose. I see this all the time when reviewing other people's code... Fortunately it is easy to add a generic instruction to project-wide CLAUDE.md to avoid this problem, but it would be nice if this skill came out of the box.
Just put in your config prompt that you want comments explaining why something was done and how it works
Of course - but I would like others to do it too. :-)