Skip to content
windsurf-refactoring-large logo

Windsurf Refactoring Large

windsurf-refactoring-large

Manage 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. Use when working with windsurf refactoring large functio...

SKILL.md

Full skill instructions

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