code-quality-standards

Code quality standards enforce minimalism, clarity, and correctness by checking that every line is justified, abstractions are necessary, and comments explain purpose. Apply this during reviews to catch unnecessary complexity, vague comments, and violation of principles like "Correctness First, Optimization Later."

Minimal code removes unnecessary abstractions, "just in case" features, and redundant logic while preserving functionality. Clean code ensures every line serves a purpose, comments are concise and explain the "why," and interfaces are explicit, reducing technical debt and improving readability.

Refactoring for quality removes hard-to-read patterns, inconsistent standards, and unjustified complexity. This Skill guides refactoring by identifying code that violates minimalism and clarity principles, helping you systematically eliminate debt and improve maintainability across your codebase.

Apply code quality standards when writing new code, performing peer reviews, refactoring existing functions, optimizing for clarity, or whenever you mention code quality, clean code, or comments. This ensures consistent adherence to minimalism and correctness-first validation throughout development.

Comments should be professional, concise, and explain purpose and intent rather than restating what the code does. This Skill enforces comment clarity by ensuring each comment justifies its existence and adds genuine understanding, eliminating redundant or vague annotations.

Unnecessary abstractions are patterns, layers, or generalizations added "just in case" rather than solving an immediate problem. Code quality standards review your code to flag over-engineered structures and guide removal of abstractions that don't justify their complexity, simplifying your design.