Ask HN: Have you ever seen a perfect codebase?

#1

Post by mcdow » Wed, Nov 19, 2025, 6:30 PM UTC

In my experience even the best software projects have a few skeletons in their closet, blemishes on an otherwise well-built project.

At the end of the day, we all have to build things that simply work and provide business value. Striving for perfect code is not the goal. But it does make me wonder: does perfect software even exist? If not, what's the gold standard?

Re: Ask HN: Have you ever seen a perfect codebase?

#2

Post by PaulHoule » Wed, Nov 19, 2025, 6:32 PM UTC

See https://en.wikipedia.org/wiki/Knuth_reward_check

Re: Ask HN: Have you ever seen a perfect codebase?

#3

Post by taylodl » Wed, Nov 19, 2025, 6:44 PM UTC

The gold standard for a codebase isn’t perfection - it’s impact. Financially, the closest analogy is ROI minus Operating Costs: as long as that number is positive, you’re technically in good shape. But the real goal is to maximize that difference. For internal systems, that means pairing high ROI with high Business Impact Value.

The hidden danger? ‘Skeletons in the closet’ - technical debt, brittle architecture, poor documentation - inflate Operating Costs over time. They erode ROI silently, turning what looked like a strong investment into a liability. A truly great codebase isn’t just functional; it’s engineered to minimize those skeletons.

Re: Ask HN: Have you ever seen a perfect codebase?

#4

Post by nis0s » Wed, Nov 19, 2025, 7:17 PM UTC

I personally like uv

Re: Ask HN: Have you ever seen a perfect codebase?

#5

Post by JohnFen » Wed, Nov 19, 2025, 7:30 PM UTC

I've never seen a perfect anything.

Re: Ask HN: Have you ever seen a perfect codebase?

#6

Post by harryquach » Wed, Nov 19, 2025, 9:27 PM UTC

I don't think its possible to define what a perfect codebase would look like let alone write one. Programming is enough of an art form that quantitative analysis will always fall short. This also happens to be one of the reasons I love to write software.

Re: Ask HN: Have you ever seen a perfect codebase?

#7

Post by Fizzadar » Wed, Nov 19, 2025, 9:59 PM UTC

I don’t think it exists. An empty folder perhaps. Guaranteed bug free.

Re: Ask HN: Have you ever seen a perfect codebase?

#8

Post by shoo » Thu, Nov 20, 2025, 1:08 AM UTC

Fizzadar wrote: post #7

I don’t think it exists. An empty folder perhaps. Guaranteed bug free.

Provided your set of functional requirements is the empty set. If there are any requirements then an empty folder is going to have some serious functional defects.

Re: Ask HN: Have you ever seen a perfect codebase?

#9

Post by l___l » Thu, Nov 20, 2025, 9:34 AM UTC

I've seen a perfect codebase. It models the problem well, is easy to understand, and has tests for all inputs.

Re: Ask HN: Have you ever seen a perfect codebase?

#10

Post by senfiaj » Thu, Nov 20, 2025, 2:24 PM UTC

Practically I haven't seen. Either they were sloppy or there was a lot of legacy stuff (especially in big projects). If by perfect you mean 100% bug free and perfectly readable/maintainable, I don't think they exist. Even NASA's code isn't 100% bug free (~0.04 defects per KLOC vs average 15–50 defects in the industry). Exceptions might be some very small codebases. But reasonably polished / tested / maintainable codebases exist.