Back to prompts
Coding & DevelopmentPremiumadvanced
4.7

Legacy Code Refactoring Roadmap

Create a safe, step-by-step refactoring plan for messy legacy code without breaking production.

Copy & Paste this prompt
You are a principal engineer specializing in legacy system modernization. You've safely refactored codebases at scale without downtime.

Analyze this code and create a refactoring roadmap:

[PASTE YOUR CODE HERE]

Language/Framework: [LANGUAGE]
Context: [WHAT THIS CODE DOES, WHY IT NEEDS REFACTORING]
Constraints: [UPTIME REQUIREMENTS, TEAM SIZE, TIMELINE]

Deliver a phased roadmap:

**Phase 0: Safety Net (do first)**
- What tests to write before touching anything
- How to measure "nothing broke"

**Phase 1: Quick Wins (low risk, high impact)**
- Rename unclear variables/functions
- Extract obvious helper functions
- Remove dead code

**Phase 2: Structural Improvements**
- Design pattern recommendations
- Dependency injection opportunities
- Interface extraction

**Phase 3: Architecture Changes**
- Module boundary recommendations
- Data flow improvements
- Performance optimizations

For each change:
- Risk level (🟢 safe / 🟡 moderate / 🔴 risky)
- Estimated effort
- Before/after code example
- How to verify it works

Prioritize by: risk (lowest first) × impact (highest first)
#refactoring#legacy-code#code-quality#architecture

Works with

chatgptclaudegemini

💡 Pro Tips

  • •Never refactor and add features in the same PR
  • •Run the full test suite after every phase
  • •Keep a refactoring journal — document why you changed things for future developers

🧠 Why This Works

Refactoring legacy code without a plan leads to broken features and missed deadlines. This prompt creates a safe, incremental roadmap using proven refactoring patterns—strangler fig, feature toggles, and parallel implementations—so you improve code without breaking production.

📅 When to Use This Prompt

Use when inheriting a legacy codebase that needs modernization, when technical debt is slowing your team down, or when you need to refactor a critical system while keeping it running in production.

🎯 What You'll Get

You'll receive a phased refactoring plan with specific steps, risk assessments for each change, rollback strategies, testing requirements at each phase, and dependency mapping showing what to tackle first.

🔗 Related Prompts

Coding & Development

Senior Engineer Code Review

Get a thorough code review as if a senior engineer is looking at your PR — bugs, patterns, performance, and suggestions.

code-reviewbest-practicessecurity
★4.9
intermediate
Coding & DevelopmentPremium

Complete Test Suite Generator

Generate comprehensive unit, integration, and edge case tests for your code — with 90%+ coverage.

testingunit-teststdd
★4.8
intermediate