Code Refactoring Refactor Clean

What it does

This skill enables an AI agent to refactor messy backend code into clean, efficient, and maintainable structures. It leverages expertise in clean code principles, SOLID design patterns, and modern software engineering best practices. The agent will analyze provided code, propose a refactoring plan, apply changes incrementally, and ensure tests pass throughout the process. This skill focuses on practical improvements to enhance code quality without unnecessary complexity.

When to use it

• Refactoring tangled or hard-to-maintain code.
• Reducing duplication, complexity, or code smells within existing modules.
• Improving testability and design consistency of backend code.
• Preparing modules for the safe addition of new features.

Key capabilities

• Assessment of code smells, dependencies, and risky hotspots.
• Proposal of a refactoring plan with incremental steps.
• Application of changes in small slices to maintain stable behavior.
• Updating tests and verifying regressions after each change.
• Access to detailed patterns and examples via resources/implementation-playbook.md.

Example prompts

• "Can you refactor this code snippet to reduce its complexity?"
• "I have a module that's difficult to maintain; can you suggest a plan for refactoring it?"
• "This code has several duplicated sections. Can you help me clean it up and improve testability?"

Tips & gotchas

• The skill is designed for significant refactoring efforts, not small one-line fixes.
• Refactoring may be restricted if a change freeze is in effect.
• Always ensure tests pass after each step of the refactoring process to avoid regressions.