windsurf-refactoring-large
Execute large-scale refactoring with Cascade coordination. Activate when users mention"large refactoring", "codebase migration", "architecture refactor", "major refactoring",or "system-wide changes". Handles complex refactoring operations.
When & Why to Use This Skill
The Windsurf Refactoring Large skill is a high-performance AI agent designed to coordinate and execute complex, large-scale refactoring and codebase migrations. By leveraging Cascade coordination and AI-assisted planning, it enables developers to manage system-wide changes across thousands of files with phased execution, automated verification, and robust rollback capabilities, significantly reducing the risk and manual effort involved in architectural modernization.
Use Cases
- Architecture Migration: Seamlessly transition large-scale applications to new architectural patterns or frameworks with AI-coordinated planning and phased execution.
- System-wide API Upgrades: Automate the process of updating deprecated APIs and method signatures across the entire codebase to maintain compatibility and security.
- Dependency Replacement: Efficiently swap out core libraries or third-party dependencies by identifying and updating all affected code paths simultaneously.
- Codebase Modernization: Execute comprehensive refactoring to eliminate technical debt, improve code quality, and enhance performance in aging enterprise projects.
| name | "windsurf-refactoring-large" |
|---|---|
| description | | |
| allowed-tools | "Read,Write,Edit,Bash(cmd:*),Grep,Glob" |
| version | 1.0.0 |
| license | MIT |
| author | "Jeremy Longshore <jeremy@intentsolutions.io>" |
Windsurf Refactoring Large
Overview
This skill enables large-scale refactoring operations that span hundreds or thousands of files. It provides phased execution with checkpoints, comprehensive rollback capabilities, and AI-assisted planning. Ideal for architecture migrations, API version upgrades, dependency replacements, and codebase modernization efforts that would traditionally take weeks to complete manually.
Prerequisites
- Windsurf IDE with Enterprise or Pro subscription
- Active Cascade AI connection
- Git repository with clean working state
- Comprehensive test suite for validation
- Backup strategy for critical code paths
- Team coordination for multi-developer codebases
Instructions
- Analyze Scope
- Create Plan
- Prepare Environment
- Execute with Cascade
- Verify Completion
See {baseDir}/references/implementation.md for detailed implementation guide.
Output
- Refactored codebase with all patterns migrated
- Phase completion reports with metrics
- Before/after performance comparison
- Updated documentation and API references
- Archived rollback artifacts (kept 30 days)
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.