---

name: "windsurf-multi-file-editing" description: | Manage multi-file edits with Cascade coordination. Activate when users mention "multi-file edit", "edit multiple files", "cross-file changes", "refactor across files", or "batch modifications". Handles coordinated multi-file operations. Use when working with windsurf multi file editing functionality. Trigger with phrases like "windsurf multi file editing", "windsurf editing", "windsurf". allowed-tools: Read,Write,Edit,Grep,Glob version: 1.0.0 license: MIT author: "Jeremy Longshore jeremy@intentsolutions.io"

Windsurf Multi File Editing

Overview

This skill enables coordinated multi-file editing operations within Windsurf using Cascade AI. It provides atomic changes across multiple files, ensuring consistency when renaming symbols, moving code, or making cross-file refactoring changes. The skill handles dependency tracking, preview generation, and rollback capabilities for safe multi-file operations.

Prerequisites

• Windsurf IDE installed and configured
• Active Cascade AI subscription
• Project workspace initialized with .windsurf/ directory
• Git or version control for rollback safety
• Understanding of project file structure and dependencies

Instructions

1. Scope the Operation
2. Configure Operation Template
3. Generate Preview
4. Execute with Preview
5. Verify Results

See {baseDir}/references/implementation.md for detailed implementation guide.

Output

• Modified files with consistent changes applied
• edit-history.json log with operation details
• Rollback snapshot for recovery if needed
• Validation report with syntax check results

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources

• Windsurf Multi-File Editing Documentation
• Cascade AI Coordination Guide
• Atomic Operations Best Practices