Browse docs
Craft & Systems
Design, code, and the disciplines that make work last. Built slowly, on purpose.
Small Sharp Tools That Compose
The most durable idea in software is also the simplest: build small things that do one job well, and make them work together. Fifty years on, it still beats the monolith.
Delete More Than You Add
Removing is a first-class act of craft, not cleanup. Complexity is the enemy and simplicity is something you cut toward — so the best change you can make is often a deletion.
Source Priority: Where Good Decisions Come From
When you are deciding how to build something, not all sources are equal. The quality of your work tracks the quality of what you trust — so trust in a deliberate order.
Conventions Are a System
A convention is a small decision you make once so you never have to make it again. Settle the boring choices and you free your attention for the work that is actually yours — consistency is calm execution made structural.
Make It Inevitable, Not Impressive
The goal of craft is not to dazzle. It is to refine something until it feels inevitable — as if it could not have been any other way. That feeling is earned slowly, by subtraction.
Prefer Boring, Proven Parts
You get a small budget of novelty. Spend it on the one problem only you have, and choose boring, proven parts for everything else — because boring's failure modes are already understood.
Feedback Loops: How Systems Improve Themselves
A system that can see its own output and adjust gets better over time; one that can't, drifts. The difference is whether the loop is closed — and how fast it closes.