[08]

What Proverbs taught me about system design

I read the Bible semi-regularly, mostly Proverbs and the Psalms. Not primarily for religious reasons — though that's part of it.

Proverbs in particular reads, to me, like a codebase that has been refactored by a thousand generations. The redundancy is intentional. The aphorisms that survived are the ones that proved durable across wildly different contexts.

Here's what I've extracted that applies directly to how I think about building software.

"A wise man listens to advice" — on feedback loops

The fool in Proverbs is not stupid. He's closed. He doesn't update on new information. He's already decided.

In system design terms: the most dangerous systems are the ones that can't receive feedback. A service with no monitoring, a codebase with no tests, a product with no user feedback mechanism — these are closed systems. They degrade silently.

Build in the feedback loop first. Observability, error reporting, logging — before you optimise anything, make sure you can hear what the system is telling you.

"Pride goes before destruction" — on over-engineering

Every ambitious developer has a moment where they design something beautiful and complex, ship it, and watch it collapse under conditions they didn't anticipate. I've had several.

The Proverbs pattern: the moment you're most confident in your design is the moment you're most vulnerable to the thing you haven't considered. Confidence in a system's correctness often precedes its most embarrassing failure.

The practice: when you think a design is elegant, spend 10 minutes trying to break it. Ask the stupidest question: what if the network is down? What if the user sends an empty string? What if two requests arrive simultaneously? Pride in a design should trigger adversarial thinking, not celebration.

"A gentle answer turns away wrath" — on error messages

This one is literal. Your error messages are the system speaking to a frustrated user. How they're phrased determines whether the user fixes the problem or gives up.

"An unexpected error occurred" is the software equivalent of a dismissive shrug. "Your file couldn't be uploaded because it exceeds the 10MB limit. Try compressing it first." — that's a gentle answer. It turns away wrath. It keeps the user.

Write error messages like you're writing to a tired person at 11pm who just lost 20 minutes of work. Because you are.

"Iron sharpens iron" — on code review

The full quote is "Iron sharpens iron, and one man sharpens another." It's about friction as a growth mechanism.

Good code review is friction. It slows you down in the moment and makes you faster permanently. The reviewer who asks "why did you choose this approach over X?" is doing you a service, even when it's annoying.

I've learned more from having my code questioned than from any tutorial. The questions expose the assumptions I didn't know I was making.