The code is disposable. The specification is permanent
recursiveai.net·18h·
Discuss: Hacker News
👨‍💻Software development practices
Preview
Report Post

We treat code like it’s precious.

We version it. We review it. We refactor it. We optimize it. We document it. We build entire careers around maintaining it.

But what if we’ve been wrong about what matters?

The Sacred Cow

For decades, code has been the source of truth. The specification might say one thing, but the code is what actually runs. Over time, the code diverges from the spec. The spec becomes outdated. Eventually, nobody trusts the documentation—they read the code to understand what the system does.

This makes sense when building is expensive. If it takes months to write code, you better take care of it. You can’t afford to throw it away and start over.

So we built an entire industry around code preservation:

  • Version control systems to track every chang…

Similar Posts

Loading similar posts...