NDepend Blog

Improve your .NET code quality with NDepend

The Myth of the Software Rewrite

September 17, 2015 5 minutes read

“We can’t go on like this.  We need to rewrite this thing from scratch.”

The Writing is on the Wall

These words infuriate CIOs and terrify managers and directors of software engineering.  They’re uttered haltingly, reluctantly, by architects and team leads.  The developers working on the projects on a day to day basis, however, often make these statements emphatically and heatedly.

All of these positions are understandable.  The CIO views a standing code base as an asset with sunk cost, much the way that you’d view a car that you’ve paid off.  It’s not pretty, but it gets the job done.  So you don’t want to hear a mechanic telling you that it’s totaled and that you need to spend a lot of money on a new one.  Managers reporting to these CIOs are afraid of being that mechanic and delivering the bad news.

Those are folks whose lives are meetings, power points, and spreadsheets, though.  If you’re a developer, you live the day to day reality of your code base.  And, to soldier on with the metaphor a bit, it’s pretty awful if your day to day reality is driving around a clunker that leaves car parts on the road after every pothole.   You don’t just start to daydream about how nice it would be to ride around in a reliable, new car.  You become justifiably convinced that doing anything less is a hazard to your well being.

And so it comes to pass that hordes of developers storm the castle with torches and pitchforks, demanding a rewrite.  What do we want?  A rewrite!  When do we want it?  Now!

At first, management tries to ignore them, but after a while that’s not possible.  The next step is usually bribery — bringing in ping pong tables or having a bunch of morale-building company lunches.  If the carrot doesn’t work, sometimes the stick is trotted out and developers are ordered to stop complaining about the code.  But, sooner or later, as milestones slip further and further and the defect count starts to mount, management gives in.  If the problem doesn’t go away on its own, and neither carrots nor sticks seem to work, there’s no choice, right?  And, after all, aren’t you just trusting the experts and shouldn’t you, maybe, have been doing that all along?

There’s just one nagging problem.  Is there any reason to think the rewrite will turn out better than the current system?

Would the Software Rewrite Go Well?

Let’s do a dispassionate play by play of the situation.  A software group starts writing a piece of software and they’re productive at it.  Over the course of time, as they hustle to get features out the door, they make a mess, always vowing to clean it up later when they have the time.  But, they never have the time because with every delivery cycle, they’re able to ship fewer things because of all the problems that have developed in the code.  Eventually, features slow to a crawl, developers are increasingly miserable, and the group suffers attrition as people start heading to other groups or companies for greener (field) pastures.  Things are in a downward spiral and something must be done.  The developers want that something to be a total rewrite.  “This time,” they say, “we know so many things we didn’t know when we started the current system, so this time we’ll get it right.”




Sure, they know things now that they didn’t know when they started on this code 3 years ago.  But won’t the same thing be true in 3 years?  Won’t the developers then be looking at the code and saying, “this is a mess — if only we knew in 2015 what we now know in 2018!”  And, beyond that, what makes you think that giving the same group of people the same marching orders won’t result in the same kind of code?

The “big rewrite from scratch because this is a mess” is a losing strategy.

Don’t get me wrong.  There are certainly times when old software needs to be phased out in favor of more modern stuff.  If you have code specific to hardware that is no longer manufactured, you’re better served building new software than scrounging E-Bay for resellers of the old server model.  If you have a line of business application written in a defunct language that no one knows anymore, you’ll probably need to bite the bullet and commission something modern.  But you don’t need to rewrite software because developers made a mess of it while hurrying to meet deadlines.

It’s a long road back from a mess, but the road exists.  You can use automated tooling to identify and start working to improve the most dangerous parts of the code.  Automated tests are your friend — characterize the system’s current behavior with lots of automated tests and then work on refactoring.  Bring in coaches or developers that are used to legacy rescues.  Shift the team’s priorities and help the business understand that it’s time to pay the piper on the accumulated technical debt.  They’re going to have to deal with a slowdown in the short term to go faster, sustainably over the long term.  And they’re in no position to complain — that’s exactly what a software rewrite would mean too.  It’s just that this approach is an actual game changer and not just more of the same.

When everyone on the project is at wits’ end and people are finally past the shock of the notion of a write-off, the rewrite is tempting.  It’s like making peace with having a car payment and starting to get excited about the newfangled dashboard computer and leather seats of the luxury thing you’re going to buy next.  But software isn’t a car.  The software is a mess because the group made it a mess, and it’ll only get and stay clean if the group cleans it.



Please check out the follow-up post: Software Rewrite: The Chase


    1. Interesting tidbit about the Einstein quote. I always look quotes up to get them verbatim, and I forget where I looked this one up. Probably one of those quotes websites.

      But if Einstein never said that or anything like it, the folks I really pity with their misattributions are all of the companies that have this pithy quote painted above a sign for a conference room. I’ve seen that in more than one place.

  1. Dan Olsen says:

    Ever heard of Netscape? Oh, not recently? They bought the farm thanks to siren’s song of a clean re-write. http://www.joelonsoftware.com/articles/fog0000000069.html

    It’s the biggest mistake you can make (right after the mistake of accumulating technical debt until your codebase is in an “upside down” mortgage).

  2. Kaveh Shahbazian says:

    Couldn’t agree more except for times I don’t. Especially when you inherit a pile of holy mess that no one dares to touch. And you are forgetting one important thing: You HAVE to know what the hell you are doing! In other words, encountering such a situation needs above average developers that you trust. You can not make things right just by those whom made it wrong.

    I prefer a subsystem by subsystem, API by API phasing out. But first there is a need for breaking the current monolithic hell to some sane subsystems.

    And yes; people use phrases like “time to market” & “Agile” like they know what they are doing – the first ever requirement.

  3. Erik Dietrich says:

    Thanks for the feedback and for the kind words!

Comments are closed.