No matter what I do, I cannot stop Claude from brain dumping into inline docs. No attempts to keep it restrained and document only behaviour, concisely, and only as necessary have worked. I’ve removed inline docs entirely from my codebase, and added a flat ‘no inline docs’ rule to AGENTS.md , in a pass that doubled as a code readability/selfdoc pass. The result has been quite good so far - the code reads better, there is less stale context for agents to trip up over and less context overall that counts towards token usage. Luckily I do not have anything that necessitates something like JSDoc. Anything that absolutely needs an explanation that is not code goes into a separate .md file. Recommend. submitted by /u/endgamer42
Originally posted by u/endgamer42 on r/ClaudeCode
You must log in or # to comment.