Code Comment Guidelines

Enforce industry best practices for code comments based on principles from Robert C. Martin (Clean Code), Martin Fowler (Refactoring), and other software engineering experts.

Core Principle

"JSDoc for public APIs only, no redundant comments"

• Comments are a last resort, not a first choice
• Code should be self-explanatory through good naming and structure
• Comments explain WHY, never WHAT or HOW
• Prefer refactoring over commenting

When to Use This Skill

Invoke this skill when: