clean-code

Key clean code principles include SRP, DRY, KISS, YAGNI, and the Boy Scout Rule. These coding standards ensure software is concise, direct, and maintainable by enforcing clear naming conventions, small single-responsibility functions, and flat code structure to avoid unnecessary complexity.

Refactor code by applying pragmatic coding standards: use guard clauses, ensure flat nesting, and design small functions with minimal arguments. This refactoring process removes over-engineering, enforces single responsibility, and produces code that is easy to understand, test, and extend.

Yes, these clean code standards are designed to guide AI coding agents. The guidelines direct AI agents on how to interact with users for feature requests and bug fixes, ensuring the AI generates maintainable code with clear naming and proper function design.

Yes, Python is a required dependency. The skill includes verification scripts that execute to check code quality and correctness, and it mandates self-checks to ensure the generated code adheres to the established pragmatic coding standards.

The best way to enforce coding standards for AI-generated code is to apply mandatory self-checks and script execution. This verification process ensures the AI follows pragmatic principles like DRY and KISS, resulting in concise, direct, and maintainable code without over-engineering.

Avoid over-engineering during bug fixes by adhering to the YAGNI principle and keeping functions small with minimal arguments. The clean code standards enforce conciseness and directness, ensuring you only implement necessary complexity for maintainable and testable results.