Refine, never distort
In one day I rewrote most of this site with Claude: four essays, the home page, and the about page. Two principles came out of that work. They apply to far more than websites, so I’m writing them down.
Refine, never distort
When you improve something, the goal is a better version of the same truth. Not a prettier lie, and not a shorter half-truth.
Every refinement makes three moves:
- Keep. Before changing anything, list what is true in it. Every true thing survives, or its removal is a decision you can defend.
- Cut. Remove what is false, repeated, or noise.
- Infer. Say what the original implied but never said. Inference is welcome when it is honest and makes things better.
What that looked like on this site:
- Ideas worth carrying went from fifteen ideas to ten. Repeats were merged; no idea was dropped.
- The Neurochemical Illusion lost a confident claim about serotonin that had nothing behind it, kept its thesis, and gained real evidence.
- Why Caylent lost two client-specific figures and kept the true achievement behind them.
- On my about page, a casual word in one of my own goals turned out to be hiding gratitude. The refined sentence says it out loud.
The test: could the original author recognize themselves in the result, and sign it?
Rules are compressed purposes
A guideline is a purpose compressed into a rule. “Keep posts under 1,000 words” compresses “respect the reader’s time.” Compression is useful: you don’t re-derive the purpose every time. But compression loses information, and sometimes following the rule defeats the purpose it came from.
How I deployed martinme.dev is about 2,800 words. It breaks my own guideline on purpose. It’s a step-by-step reference, and a reference with missing steps wastes far more of a reader’s time than a long one.
Breaking a rule well takes four steps:
- Name the purpose behind the rule.
- Show that, here, following the rule would defeat it.
- Break it in the open, with the reason written down.
- Keep the exception local. The rule stays the default.
Skip any step and “it’s worth it” becomes a rationalization. The easiest person to fool is yourself.
The common root
Both principles make the same move: stay loyal to the purpose, not the surface. Truth over tidy wording. The reader over a word count.
They work on people too. Refining yourself means keeping every true thing about who you are, cutting what was never true, and saying out loud what you had only implied. And the rules you live by are compressed purposes as well. Know them well enough to know when one should bend.