Global Commenting

Write minimal, evergreen code comments that explain complex logic sections while prioritizing self-documenting code through clear naming and structure. Use this skill when writing or reviewing code comments in any programming language. Apply when adding comments to explain large sections of complex logic, algorithm implementations, or non-obvious code behavior. Use when ensuring code is self-documenting through clear variable names, function names, and code structure. Apply when removing or avoiding comments that describe temporary changes, recent fixes, or time-sensitive information that will become outdated. Use when refactoring code to be more self-explanatory and reducing the need for explanatory comments. Apply when writing comments that provide lasting value and context for future developers, focusing on the "why" behind complex decisions rather than the "what" of obvious code.