Writing

Writing about software architecture and engineering.

Articles about backend systems, AI, entrepreneurship, and engineering teams.

Filter by

The Architecture Rules a Linter Can't Check

I checked Cal.com's own documented architecture rules against their code, then pointed the same tool at a problem no linter can see: code that means two different things.

Read post

Bit Rot Is Not a Metaphor

You can write a perfect ADR and in 18 months nobody follows it. The question is not how to document better. It is what you do with the documentation after it is written.

Read post

The Coupling Rate Problem

GitClear's data shows code cloning is up while refactoring is down. That matters because duplicated code creates coupling, and refactoring is the work that forces teams to reconcile it.

Read post