Comment Guidelines

These guidelines should be automatically applied whenever writing or modifying code.

Core Principles

1. Self-documenting code first - Use clear naming and structure; comments are last resort
2. WHY over WHAT - Comments explain intent and reasoning, not mechanics
3. Reduce cognitive load - Make non-obvious knowledge explicit
4. Zero redundancy - Never duplicate what code already expresses

When to Add Comments