Articles
How we build, and what we have learned doing it.
Primitives That Do Not Drift
Identifiers, timestamps and errors are the three things every service touches and almost nobody specifies. Getting them wrong is cheap on day one and expensive forever after.
One Contract, Many Clients
A hand-written API client passes review because it works today. It has no link to the route it mirrors, so the next schema change leaves it quietly wrong.
The Gate Is One Command
A check that exists only in a workflow file is a check nobody can reproduce. One command decides whether a change is done, and CI runs exactly that command.
Start Any Platform From Scratch
A new engineer should reach a running system with one command, on any of our projects, without reading a wiki page that went stale eight months ago.
Documentation as JSON
Markdown is a fine thing to read and a poor thing to maintain once there is structure worth keeping consistent. So we stopped writing it by hand.
Declarative Production
A repository should state how it runs in one file a machine can read. Otherwise every consumer of that fact re-derives it, and one of them is wrong.
Every Hour Accounted For
A bare number on a timesheet is unauditable — it cannot be questioned, verified, or connected to a deliverable. So we do not ship bare numbers.
Receipts That Satisfy the Law
A fiscal receipt is valid or it is not. There is no partial credit, and the device — not your software — is the authority.