Permanent Notes
When the Tests Pass and It Still Isn't Ready

There is a strange moment I keep running into. Everything is green. The tests pass. The security check clears. The thing I built does what it's supposed to do, at the accuracy I set out to hit. By every number I was tracking, it's ready.

And it isn't.

The first few times this happened I did what most engineers do — I assumed the numbers weren't good enough yet. So I chased them. A little more accuracy, one more edge case, another point on the benchmark. It felt like progress because it had a shape: a metric, a gap, something to close. But the closer I got, the more I suspected I was solving a problem that was already solved.

Correct was never the finish line

Here is the thing I finally admitted to myself: correctness had stopped being the bottleneck a while ago. I could test it. I could gate it. I could put a number on it and watch the number move. Anything I can measure that cleanly is, almost by definition, no longer the hard part — I've turned it into a knob.

The hard part had quietly relocated. It wasn't "does this work." It was "does anyone actually use it." I had something that passed every check and sat almost entirely untouched. That's not a quality problem. You can't fix an untouched thing by making it more correct. It was already correct. It was just finished, not ready.

Those two words feel like synonyms until you need them to mean different things. Finished is a property of the artifact — it does what the spec says. Ready is a property of the world — someone reaches for it, on purpose, because it solves something they actually have. You can be one hundred percent finished and zero percent ready, and no amount of staring at your test suite will tell you which one you are.

The scarce signal moved

For a long time the scarce, valuable act in building things was verification — knowing, reliably, that the output was right. When generating a solution was expensive, being sure it worked was where the leverage lived. I believed that, and I built around it.

But verification, once you've engineered it well, becomes cheap and automatic. The gate runs on every change. The check is deterministic. And the moment a thing gets cheap, it stops being where the value is. The value slides to whatever is still expensive and still uncertain.

What's expensive and uncertain now is adoption. Not "can it work" but "did it earn a place in someone's actual day." That signal is slow, noisy, and impossible to fake with a benchmark. It doesn't show up in a passing test. It shows up only when a real person, with real friction, chooses your thing over doing nothing. There's no unit test for that. It's the one number you can't manufacture — which is exactly why it's the one that matters now.

Changing the frame is free

The fix, when it came, cost nothing. I didn't collect more data or run another experiment. I changed the question. I stopped asking "how accurate is it" and started asking "how many people have used it." Same project, same day, same facts on the table — one different frame, and the entire decision flipped. What looked like "almost ready, just tune it" became "correct already, go get it used."

This is the part I find genuinely philosophical, and it's easy to miss because it's so cheap. The frame you measure by silently decides what "done" means. Pick correctness as your frame and you'll optimize correctness long past the point it helps, because the frame keeps handing you a gap to close. Pick adoption and the same artifact tells a completely different story. Neither frame is wrong. But only one of them was pointed at the actual bottleneck, and choosing between them was free — it was a question, not a project.

The examined-engineer move isn't to optimize harder. It's to stop, before optimizing, and ask what you're optimizing for — and whether the thing you're measuring is still the thing that's scarce. Most of the time the honest answer is that the bottleneck moved a while ago and you kept polishing the old one because polishing feels like work.


So now, when everything is green and something still feels off, I've learned to distrust the greenness a little. Green means finished. It doesn't mean ready, and it definitely doesn't mean it mattered to anyone. The last question — did a real person reach for this — is the only one my tests can't answer for me.

When was the last time you were sure something was ready, and it turned out you'd just measured the easy thing well?

This is part of my ongoing exploration of what happens when you treat your life as a system worth engineering and a question worth examining.