Manifesto

Engineering principles

These aren't rules. They're convictions earned across years of building (and breaking) systems — always up for revision by the next codebase, or the next mistake.

  1. 01

    Boring technology by default

    Pick the well-worn tool unless there's a real reason not to. Novelty is a tax on every future contributor — including your future self. Reserve excitement for the actual problem.

  2. 02

    Clarity over cleverness

    Code is read ten times more than it's written. A one-line bit of magic is a future bug — write the obvious version, name the variable, leave the type, move on.

  3. 03

    Ship small, ship often

    Big batches hide big bugs. A daily-shipped change is a daily-tested change. Build the pipeline so a one-line fix can be in production before lunch.

  4. 04

    Tests are documentation

    Tests describe how the code is supposed to behave to anyone who reads them. Aim for tests that read like specifications, not assertions about implementation details.

  5. 05

    Delete more code than you write

    Every dead branch, every unused helper, every wrapper that wraps a wrapper — gone. The healthiest pull requests in my history are net-negative on line count.

  6. 06

    Systems are people too

    Every architecture decision shapes how the team works. Choose abstractions that make onboarding fast, ownership clear, and Friday afternoons quiet.

  7. 07

    Observability is a feature

    If you can't see it running, you don't actually own it. Logs, metrics, traces — wired in from day one, not bolted on after the first incident.

  8. 08

    Read the source

    Stack Overflow is a starting point, not a destination. The truth lives in the library's source — and reading it makes you faster at every subsequent problem.

  9. 09

    Curiosity is non-negotiable

    The engineers I admire most can't stop poking at things. Make space — protected, daily — to learn something the project doesn't strictly need.

  10. 10

    Sometimes — break things on purpose

    Pentesting a system you didn't build teaches you more about your own code than any code review will. Adopt the attacker's mindset on Saturdays so the engineer's mindset is sharper on Monday.