Writing is the highest-leverage skill in engineering

Every engineering org has someone who writes the document that everyone else ends up quoting. They are rarely the loudest person in the room and almost never the one with the most years on the team. But the words they put in a doc become the words the org uses to think about the problem, and from there everything else follows — the design, the staffing, the priorities, the post-mortem framing.

I used to think this was a quirk of culture. I now think it's mechanical.

Why writing dominates

A meeting reaches the people in the meeting. A Slack message reaches the people scrolling at that moment. A document, once written, keeps recruiting allies while you sleep. It's read by the VP who wasn't in the room, the new hire onboarding next month, the partner team that's blocked by your decision. Every reader is a free advocate if the writing is good and a silent skeptic if it isn't.

The skill compounds in a way that few other engineering skills do. A great library lasts until the next refactor. A great memo lasts as long as the company.

What "good" actually looks like

The good engineering writing I've seen isn't beautiful. It's operational. It does three things:

1. States the problem before the solution. Most drafts skip this and lose the reader in paragraph two.
2. Names the tradeoff out loud. Every interesting decision has one. Writing that pretends otherwise reads as marketing.
3. Ends with a recommendation, not a menu. A doc that lists four options without picking one is asking the reader to do your job.

None of this requires you to be a stylist. It requires you to decide what you think before you start typing, which is harder than it sounds and is most of the work.

The unfair advantage

Here's the part no one will tell you in a performance review: most engineers are bad at this. Not because they can't be good, but because they treat writing as overhead — something you do after the work, to report on the work. The engineers who treat writing as the work end up steering the room.

If you're early in your career and trying to decide what to get better at next, this is the cheapest, highest-leverage bet on the board. It compounds for forty years and almost no one is competing for it.