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.

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026

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"
version1.0.0
licenseMIT
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

  1. Analyze Scope
  2. Create Plan
  3. Prepare Environment
  4. Execute with Cascade
  5. 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.

Resources