Global Commenting

概要

Global Commenting empowers developers to maintain clean, professional codebases by emphasizing self-documenting architecture over excessive annotation. It provides strategic guidance on when to add comments for complex business logic, how to refactor for clarity through intentional naming and organization, and how to prune outdated comments to prevent documentation rot. By focusing on evergreen explanations and non-obvious implementation details, this skill ensures that code remains accessible and maintainable without becoming cluttered by redundant text.

主な機能

• Identification and removal of redundant or outdated comments
• Guidance on capturing non-obvious business logic and design decisions
• Prioritization of self-documenting code through clear naming and organization
• Strategic documentation of large logic sections and complex implementation details
• Standardization of minimal, high-value commenting practices across all files
• 0 GitHub stars

ユースケース

• Standardizing a codebase's documentation style to focus on maintainability
• Refactoring legacy code to improve clarity and remove documentation technical debt
• Writing new features with complex logic that requires high-level explanation