Refactoring

What it does

This skill enables an AI agent to automatically refactor backend code, improving its readability, maintainability, and performance without altering external behavior. It utilizes GoodVibes precision tools to systematically restructure existing code, making future development faster and reducing the likelihood of bugs. The process involves analyzing the current codebase, identifying areas for improvement, and then extracting or reorganizing components.

When to use it

This skill is helpful in the following situations:

• Code duplication needs to be eliminated.
• Functions or components have grown too large.
• Type safety needs improvement.
• Conditional logic has become complex and hard to follow.
• File and folder structure requires reorganization.
• Dependencies are tightly coupled and need inversion.
• Database schema or queries require optimization.
• "Code smells" are slowing down development.

Key capabilities

• Code Smell Detection: Identifies common code smells like large files, duplicated patterns, type safety issues (usage of any), and complex conditionals using discover.
• Dependency Mapping: Uses precision_grep to map how code is used across the codebase.
• Test Existence Verification: Ensures tests exist before refactoring; requires writing tests if they are missing.
• Function/Component Extraction: Identifies and extracts large functions or components into reusable pieces.

Example prompts

Here are some example prompts you can use with an AI agent equipped with this skill:

• "Refactor this code."
• "Reduce duplication in the src directory."
• "Extract function from this block of code."
• "Simplify conditionals in app.tsx."
• "Improve types in user.ts."

Tips & gotchas

• Test Coverage is Crucial: Always ensure tests exist and pass before refactoring, and rerun them afterward to validate behavior preservation. If tests are missing, write them first.
• Understand Dependencies: Be aware that refactoring often requires updating call sites of modified code.
• Gradual Refactoring: The skill focuses on systematic restructuring; large-scale changes should be approached incrementally.