Why We Hate Legacy Code (and How to Work With It Anyway)
Watch Episode
In this episode of Fundamentals of Software Engineering, Nate and I dig into the love hate relationship every developer has with the inherited code base. We unpack what actually makes code 'legacy', why working with it feels so painful, and the strategies that turn it from a burden into something you can confidently change. From Mike Feathers' definition ('legacy code is code without tests') to the realization that your code today will be someone else's legacy code tomorrow, we cover the full spectrum of why this stuff trips up even seasoned developers and what actually moves the needle.
We get into the rewrite trap (and why YOLO big bang rewrites usually backfire), the strangler fig pattern that has saved countless modernizations, and how AI is finally turning the years long mainframe migration into something realistic. We also talk about scout rule refactoring, the fresh perspective new joiners bring (and why managers should actually listen), the soft skills side that nobody warned us about, and what empathy for past developers looks like in practice. If you have ever opened a code base, thought 'what idiot wrote this?', and then realized it was you, this one is for you.
Key Highlights
🔍 What Counts as Legacy: Mike Feathers' definition is code without tests, but functionally it's anything you didn't write within the last couple of hours. Even your code becomes legacy faster than you think.
🛠️ The Rewrite Trap: Big bang cutovers are stressful, risky, and usually reintroduce edge cases that took years to fix. The strangler fig pattern lets you replace systems thin slice by thin slice with continuous demoable progress.
🤖 AI as a Modernization Force Multiplier: AI lowers the cost and risk of mainframe migrations and makes interrogating commit history at scale realistic. Use it to summarize code intent, surface edge cases, and answer the questions human patience won't.
🧠 The Missing Context Problem: The original developers retired, the why is gone, and only the what remains. Tribal knowledge walks out the door. That's the real challenge, not the syntax.
📋 The Edge Case Iceberg: Happy path is easy. The real complexity lives in last day of the month, mid year changes, timezone quirks, and the goofy combinations of dates and times. If those are not tested or documented, the rewrite will reintroduce them.
🌱 Fresh Perspective Is a Superpower: New joiners can challenge 'that's how we've always done it' assumptions that seasoned engineers no longer notice. Dan shares a real story of parallelizing an overnight batch job by simply asking 'does it have to be sequential?'
🧹 Scout Rule Refactoring: Always leave the code better than you found it. Better variable names, smaller methods, dead code removal, missing documentation. Small daily improvements compound into a maintainable system.
📈 Your Code Today Is Tomorrow's Legacy: Write the tests. Document the edge cases. Leave the breadcrumbs. The future maintainer might be you, and you will not remember why you made any of those decisions.
Resources & Next Steps
📘 Fundamentals of Software Engineering (book), now in Portuguese and Korean translation
🌐 fundamentalsofswe.com (book + podcast hub)
👥 Mike Feathers, Working Effectively With Legacy Code (definition source)
📐 Strangler Fig Pattern, Martin Fowler
🎧 Subscribe to Fundamentals of Software Engineering on Apple Podcasts
Chapter Timestamps
00:00 Cold Open, When the Idiot Code Turns Out to Be Yours
00:54 Welcome to Episode 7
02:33 Fundamentals of SE Now in Portuguese and Korean
04:05 What Counts as Legacy Code
06:48 Why Greenfield Feels So Good
09:11 Legacy Doesn't Mean Bad
10:41 App Modernization as a Career
11:51 Getting Off the Mainframe in the AI Era
15:25 Missing Context (the Why Is Gone)
17:36 Fear of Breaking What You Don't Understand
18:17 Mike Feathers and Why Tests Slow You Down Less Than You Think
22:08 Getting Maintenance Time Approved
25:01 Outdated Dependencies and the 1962 Car Analogy
28:06 Tribal Knowledge Walks Out the Door
32:14 The Rewrite Trap and YOLO Big Bang Cutovers
39:48 The Strangler Fig Pattern
42:00 Working in Unfamiliar Code
47:00 Fresh Perspective as a Superpower
50:23 The Scout Rule (Leave It Better Than You Found It)
52:24 Comments, Refactoring, and Naming
53:29 Empathy for Past Developers
55:03 Your Code Today Is Tomorrow's Legacy
59:08 Closing Thoughts (and a Dad Joke)
We get into the rewrite trap (and why YOLO big bang rewrites usually backfire), the strangler fig pattern that has saved countless modernizations, and how AI is finally turning the years long mainframe migration into something realistic. We also talk about scout rule refactoring, the fresh perspective new joiners bring (and why managers should actually listen), the soft skills side that nobody warned us about, and what empathy for past developers looks like in practice. If you have ever opened a code base, thought 'what idiot wrote this?', and then realized it was you, this one is for you.
Key Highlights
🔍 What Counts as Legacy: Mike Feathers' definition is code without tests, but functionally it's anything you didn't write within the last couple of hours. Even your code becomes legacy faster than you think.
🛠️ The Rewrite Trap: Big bang cutovers are stressful, risky, and usually reintroduce edge cases that took years to fix. The strangler fig pattern lets you replace systems thin slice by thin slice with continuous demoable progress.
🤖 AI as a Modernization Force Multiplier: AI lowers the cost and risk of mainframe migrations and makes interrogating commit history at scale realistic. Use it to summarize code intent, surface edge cases, and answer the questions human patience won't.
🧠 The Missing Context Problem: The original developers retired, the why is gone, and only the what remains. Tribal knowledge walks out the door. That's the real challenge, not the syntax.
📋 The Edge Case Iceberg: Happy path is easy. The real complexity lives in last day of the month, mid year changes, timezone quirks, and the goofy combinations of dates and times. If those are not tested or documented, the rewrite will reintroduce them.
🌱 Fresh Perspective Is a Superpower: New joiners can challenge 'that's how we've always done it' assumptions that seasoned engineers no longer notice. Dan shares a real story of parallelizing an overnight batch job by simply asking 'does it have to be sequential?'
🧹 Scout Rule Refactoring: Always leave the code better than you found it. Better variable names, smaller methods, dead code removal, missing documentation. Small daily improvements compound into a maintainable system.
📈 Your Code Today Is Tomorrow's Legacy: Write the tests. Document the edge cases. Leave the breadcrumbs. The future maintainer might be you, and you will not remember why you made any of those decisions.
Resources & Next Steps
📘 Fundamentals of Software Engineering (book), now in Portuguese and Korean translation
🌐 fundamentalsofswe.com (book + podcast hub)
👥 Mike Feathers, Working Effectively With Legacy Code (definition source)
📐 Strangler Fig Pattern, Martin Fowler
🎧 Subscribe to Fundamentals of Software Engineering on Apple Podcasts
Chapter Timestamps
00:00 Cold Open, When the Idiot Code Turns Out to Be Yours
00:54 Welcome to Episode 7
02:33 Fundamentals of SE Now in Portuguese and Korean
04:05 What Counts as Legacy Code
06:48 Why Greenfield Feels So Good
09:11 Legacy Doesn't Mean Bad
10:41 App Modernization as a Career
11:51 Getting Off the Mainframe in the AI Era
15:25 Missing Context (the Why Is Gone)
17:36 Fear of Breaking What You Don't Understand
18:17 Mike Feathers and Why Tests Slow You Down Less Than You Think
22:08 Getting Maintenance Time Approved
25:01 Outdated Dependencies and the 1962 Car Analogy
28:06 Tribal Knowledge Walks Out the Door
32:14 The Rewrite Trap and YOLO Big Bang Cutovers
39:48 The Strangler Fig Pattern
42:00 Working in Unfamiliar Code
47:00 Fresh Perspective as a Superpower
50:23 The Scout Rule (Leave It Better Than You Found It)
52:24 Comments, Refactoring, and Naming
53:29 Empathy for Past Developers
55:03 Your Code Today Is Tomorrow's Legacy
59:08 Closing Thoughts (and a Dad Joke)