notes / index

Notes from the bench

decisions, not tutorials. pick one up — steal what works, skip what doesn't.

Showing 12 of 12 engineering field notes
Principle2 min

YAGNI — you aren't gonna need it

why I refuse to build the feature you'll need next month.

read field note →“you're not a prophet”
Principle2 min

DRY — don't repeat yourself

the third copy-paste is a bug factory, not a shortcut.

read field note →“bug factory”
Principle2 min

KISS — keep it simple

the simplest thing that works, ships first and breaks least.

read field note →“ships first”
Guide5 min

How I scope a freelance project

fixed scope, fixed price, and what I need from you on day one.

read field note →“no hourly guesswork”
Case Study6 min

Designing a slot-booking flow people don't fight

scheduling looks simple until real humans and real calendars show up.

read field note →“the friction is never in the calendar”
Principle3 min

Premature optimization is the root of all evil

optimize when the profiler tells you, not when your ego does.

read field note →“when the profiler tells you”
Guide6 min

Custom tools vs off-the-shelf

when 'build it ourselves' is actually the right call.

read field note →“the workflow IS the business”
Principle2 min

Code is for humans

the machine doesn't care about your variable names.

read field note →“the machine doesn't care”
Guide5 min

Choosing a database — SQL vs NoSQL

the question isn't 'best database'. it's 'what queries will you run?'.

read field note →“what queries will you run”
Guide4 min

Server-side 101: what happens between request and response

the journey of a click — and where it usually goes wrong.

read field note →“the journey of a click”
Guide4 min

Indexes: the 20% that fixes 80% of slow queries

before you cache, before you shard — read the EXPLAIN.

read field note →“read the EXPLAIN”
Guide5 min

Auth without fear: sessions, JWTs and password resets

the feature everyone's afraid of, and why it doesn't need to be scary.

read field note →“boring is exactly what you want”