Comment by wongarsu

A small mention in your user-wide Claude.md (or Agents.md or whatever you use) about the desired types of comments goes a long way. The typical "why, not what", clarifying larger-picture stuff, and everything else you find in every book on code quality