The lone developer problem

, posted

In short: in my experience, if a single programmer builds something, it’s often hard for others to maintain later. There are several possible reasons why. Even great programmers fall into this trap!

This post is anecdotal from my own experience, so it might not be right or apply to you. But here goes:

A lot of software is built by one person. It might be an entire product built by a lone developer or a significant piece of a system.

When this happens, I’ve observed that code written by a single developer is usually hard for others to work with. This code must’ve made sense to the author, who I think is very smart, but it doesn’t make any sense to me!

I’m not an amazing programmer but I see this happen to myself all the time. I look at code I wrote a year ago and often find it confusing. What was I thinking when I wrote this?

I’ve started calling this the “lone developer problem”.

Why does this happen?

I don’t know, but I suspect this happens for a few reasons:

There are probably other reasons, and these are all just guesses.


The obvious mitigation strategy: bring in another developer. Have them review your code or pair with you.

If you can’t do that, open-sourcing your code might pressure you to avoid some of these traps.

I’ll add that you may not really want to solve this problem. You don’t always need to write good code! For example, you probably shouldn’t prioritize code quality during a hackathon. (Of course, you probably want good code sooner than you think.)

Again, this post is entirely from my own perspective, and is not based on hard evidence. Your experience might be totally different! But maybe you’ve also run into the lone developer problem.