If We Started Again Today
The most honest section. What we would keep, drop, and redesign — and what turned out to matter more than we thought.
Hindsight is the cheapest form of wisdom, so this section tries to earn it honestly. If ichi were rebuilt from nothing today, knowing what we now know:
Keep
- Plain text as the source of truth. Everything good downstream traces back to this one decision. Nothing would change it.
- The human gate. The single most important design choice, and the one we would make first, not last.
- The static site. Fast, safe, cheap, durable. No regrets.
- Documenting reasoning, not just results. This handbook is the proof — the why has outlived several hows already.
Remove
- Anything that ran without being able to report its own health. We would forbid it from day one, rather than learning the lesson through a silent outage.
- Premature moving parts. Several services were added before they earned their keep. Fewer, later, would have been better.
Redesign
- Monitoring, from the start, as “prove you’re alive,” not “ping a port.” We inherited the port-check habit and paid for it.
- The editorial pipeline as first-class, sooner. Good thinking went uncaptured for too long before there was a place to put it.
Unexpected discoveries
- Version control quietly replaced a database — and did the job better than the database would have.
- The human bottleneck made speed safe. We expected the gate to slow us down. It let us go faster, because it made aggressive automation reversible.
- Writing for strangers sharpened the private thinking more than any internal review ever did.
Biggest mistakes
- Trusting “green” that could not go red. A monitoring lie cost real days.
- Assuming completeness instead of checking it. Assets that existed on paper but could not act — the most expensive kind of nothing.
What became more valuable than expected
- Boring technology. Its dullness is exactly its value: it fails predictably, and predictable failure is cheap.
- A single accent of restraint — less, but better — applied to features, prose, and design alike. Almost every improvement, in the end, came from taking something away.
If there is one thing to carry out of this handbook, it is that: the system is good not because of what was added to it, but because of what it was disciplined enough to leave out.