lsp-refactoring

LSP Refactoring

Refactoring workflow that combines language server capabilities with code search and test-driven verification for safe, precise code transformations.

When to Use This Skill

• Renaming symbols across an entire workspace
• Extracting functions, classes, or modules
• Moving code between files with automatic reference updates
• Large-scale pattern-based code transformations
• Any refactoring where manual find-replace is error-prone

What This Skill Does

Phase 1: Analysis — Understand Before Changing

1. Scope assessment: Find all usages of the target symbol using grep or IDE references
2. Dependency graph: Trace where the symbol is defined and what depends on it
3. Impact analysis: Identify all files that will be affected
4. Pattern discovery: Search for similar patterns that should be refactored consistently

# Find all usages of a function
grep -rn "getUserData" src/ --include="*.ts"

# Find pattern across codebase with AST-aware tools (if available)
# e.g., ast-grep, semgrep, or comby
ast-grep --pattern 'console.log($MSG)' --lang typescript

Phase 2: Plan — Design the Transformation

1. Pre-flight check: Run the type checker / linter to capture baseline errors
2. Rename validation: Verify the symbol can be safely renamed (no conflicts)
3. Transformation plan: List each change with file, line, before/after
4. Test identification: Find tests covering the code being refactored

Phase 3: Execute — Apply Changes Safely

For renames (use IDE/editor capabilities when available):

# Using sed for simple renames
find src/ -name "*.ts" -exec sed -i '' 's/getUserData/fetchUserProfile/g' {} +

# Or use language-specific tools
# TypeScript: ts-morph, jscodeshift
# Python: rope, bowler
# Go: gorename

For pattern-based transformations:

# Using ast-grep (if installed)
ast-grep --pattern 'console.log($MSG)' --rewrite 'logger.info($MSG)' --lang typescript

# Using comby
comby 'console.log(:[msg])' 'logger.info(:[msg])' .ts