refactor-project

What problem does it solve?

Large codebases often suffer from drift and divergence as teams push features, leading to duplication, inconsistent patterns, and brittle architectures. This Skill orchestrates project-wide refactoring to restore consistency, reduce duplication, and modernize structure with minimal manual effort.

Core Features & Use Cases

• Scope discovery: analyzes all source files across the project, excluding common build and dependency folders, to identify candidate refactors.
• Cross-file consolidation: detects duplicate utilities and patterns and consolidates them into shared modules.
• Automated refactoring: applies language-appropriate transformations via the refactor:code-simplifier agent, preserving functionality.
• Best-practices integration: loads refactor:best-practices guidance to enforce consistency, naming, and error-handling standards.
• Rollback & reporting: provides a project-wide summary and git rollback commands to revert changes if needed.

Quick Start

Use the refactor-project skill to perform a project-wide refactor. The agent will load best practices, analyze the codebase, apply cross-file optimizations, and emit a project-wide summary with rollback guidance.