all writing
11 · 2025·6 min readProcess

Why I write commit messages like haiku.

A pattern I stole from a teammate at Linear that I now can't stop using.

› essay.03e8a3f1 refactor cursor focus model77c0b2 reduce paint bursts in scroll1a40d9 ship deploy console v1.29d3fa1 name the keystroke handler5b228c rm dead path in routerc2e801 measure first, optimise later
essay

My teammate Karri at Linear had a habit of writing commit messages that read like haiku. Subject, verb, consequence — three short lines, no more.

I thought it was a joke for the first month. Then I caught myself reading old commits and understanding them in a single glance, which had never happened to me before with any codebase.

The rule, as best I can reconstruct it: the first line is what changed in the world (not the code). The second line is the smallest reason. The third line is what the reader needs to know to read the diff.

It is slower to write and faster to read. The trade is good.

— Fardan, written in Jakarta
/ keep reading

Up next.

all writing
› essay.04
09 · 202510 min

I have changed my mind about monorepos.

I spent four years preaching them and the last six months unpicking one.