Global Commenting

Write self-documenting code with minimal, evergreen comments that explain why, not what. Use this skill when deciding whether to add comments or when reviewing existing comments. When writing docstrings, inline comments, or documentation blocks. When avoiding comments that describe recent changes, temporary fixes, or obvious code behavior.