Tag
Notes tagged “software-design”
Every note filed under software-design, newest first.
A filtered view of the notes.
2026
- Utils Is Where Modularity Goes to Die
Module boundaries should follow the dependency graph, not your folder intuitions — and "optimal" can be defined precisely.
- Designing an API That Outlives You
I wrote watchdog in 2010. Fifteen years and three maintainers later it still ships the same public API I designed — here's what made it last.
2025
- Everything Is an Action
The architecture of Firebase Genkit rests on one primitive — a self-describing, observable, callable function — and the whole SDK is layers of specializations of it.
- Reading a Codebase
A method for taking real software apart at the source level — find the one type everything hangs from, extract the algebra, and learn what the designers refused to allow.