Simple Made Easy

by Rich Hickey · 4 ideas

  1. Simple vs Easy

    Simple means made of parts that are not tangled together, which is a fact about the thing. Easy means familiar or close at hand, which depends on you. Do not mistake what is familiar for what is simple.

  2. Complecting

    To complect is to braid separate things together, so you cannot think about or change one without the other. Most complexity comes from this tangling, not from the number of parts. Keep independent concerns apart.

  3. Judge the Result

    Choosing the familiar tool feels fast at the start, but a tangled result slows you down for years. What matters is the thing you build, not how pleasant it was to make. Judge choices by what they leave you to live with.

  4. Guardrails Don't Steer

    Tests and safety checks catch mistakes, but they do not make a tangled system easy to understand. You cannot drive somewhere by bumping into guardrails. Make the design simple first, then add checks.

More on design