auto-comments

What problem does it solve?

Code commenting discipline: when to comment, when silence IS the comment, and the specific anti-patterns Claude defaults to. Corrects over-commenting, restating-the-obvious, and missing high-value 'why not' comments. Use when writing new code, reviewing code, or refactoring. Triggers: comment, comments, commenting, docstring, jsdoc, rustdoc, documentation, annotate, explain code, self-documenting.

Core Features & Use Cases

• The litmus test for value: comments must reveal unseen intent or risk; avoid narrating the obvious.
• Comment value hierarchy (highest to lowest) covers Why not, Why, Beware, Context, What, How; relevant across languages.
• Anti-patterns you default to: Narrating the code, Restating the function name, Commenting control flow, and several other noisy patterns to avoid.

Quick Start

Apply these guidelines when you write or review code to ensure comments add value and avoid noise.