Writing

Notes from the operational side.

Short pieces on discipline, documentation and the things that keep complex systems honest.

The Cost of an Unchecked Detail

September 2026 · 4 min read

Why documentation, verification and calm are not soft skills — they are the only reason complex systems stay alive.

There is a specific silence that falls over a control room when a parameter that should be nominal isn't. It is not the dramatic silence of alarms — alarms are loud. It is the silence after you acknowledge them, when the room is waiting for you to know what to do next.

I learned to trust that silence. Not because it is comfortable, but because it forces a discipline that is easy to talk about and hard to practice: check the detail before you act.

On a factory floor, the cost of an unchecked detail is measured in scrap, rework, and a line that stops. In an engineering change office, it is measured in a modification that reaches the wrong vehicle, or a BOM that drifts from reality. In operations, it is measured in something harder to quantify — the slow erosion of trust in a system that people rely on.

The shape of the problem is always the same. A signal arrives. It looks like one thing. Most of the time, it is that thing. But occasionally it is something else entirely, hiding behind the same telemetry, the same log line, the same alarm code. The difference between a good operator and a great one is not reaction speed. It is the willingness to ask, what would make this reading false? before pressing a button.

That habit has a name. It is called operational discipline. It is unglamorous. It looks like writing things down. It looks like reading the procedure even when you know it by heart. It looks like handing over a shift with a list of what is normal, what is pending, and what is still unclear. It looks like admitting that you don't know yet.

I have seen what happens when that discipline is absent. A step assumed, a check skipped, a handover that was verbal instead of written. The system does not care about intention. It only cares about state. And state, if it is not verified, drifts.

The opposite is also true. The most reliable systems I have worked on are not the ones with the most sophisticated tools. They are the ones where everyone, at every level, treats the documentation as real, the checklists as load-bearing, and the handover as a contract. In those systems, the silence after an alarm is not fear. It is the sound of people doing their job.

I build software the same way now. Small scripts, small tools, small systems. They all get the same treatment: a written purpose, a clear state, a way to verify. Not because I am a perfectionist, but because I have seen what an unchecked detail costs. And I would rather write it down than find out again.

Why Boring Tools Win

October 2026 · 3 min read

The most valuable software in any organisation is usually the software nobody wants to talk about.

Every organisation has two kinds of internal tools. There are the ones someone decided to build because they looked impressive in a demo — dashboards with animations, bots with personalities, integrations with things you've never heard of. And there are the boring ones: the shell scripts, the CSV validators, the nightly jobs that quietly move data from one place to another.

The flashy ones get attention. The boring ones get used.

I learned this the hard way. On a factory floor, the tool that mattered was not the one with the best interface. It was the one that reliably told you whether a part was the correct part, in the correct order, at the correct moment. Nobody wrote a case study about it. It just worked, every shift, for years.

The pattern repeats everywhere I've looked. In an engineering change office, the highest-leverage tool was a spreadsheet with strict column rules and a validation script. In operations, it's a log parser that tells you what actually happened in the last six hours. None of these are interesting. All of them are load-bearing.

The reason is simple: boring tools have fewer failure modes. They have fewer dependencies, fewer moving parts, fewer things that need to be upgraded. They are easier to understand, easier to hand over, and easier to fix at 3am. The exciting tool that broke last Tuesday because someone renamed a Kubernetes namespace is not charming in retrospect.

This is not an argument against innovation. It is an argument for honesty about what a tool is for. If the tool exists to support a critical process, then its first job is to keep working. Its second job is to be understandable. Its third job is to be pleasant. In that order.

What I look for now when I build something: can I explain it in a paragraph? Can someone else run it in a month with the README I wrote? Does it fail loudly, or does it fail silently? Is the state of the system easy to reason about, or does it hide?

If the answers are good, the tool will survive. And a tool that survives is worth more than a tool that impresses. Every time.

The Shift Handover

October 2026 · 2 min read

A short piece about the most underrated fifteen minutes in any operational job.

I have a small ritual I have kept across three jobs and four countries. Fifteen minutes before my shift ends, I stop doing new work and start writing. Not reports — notes. What is normal. What is pending. What is still unclear. What I would do next if it were my shift.

It sounds simple. It is not. The temptation is always to keep working until the last minute, because there is always something to push forward. But I have learned that the last fifteen minutes of a shift are worth more than the first fifteen. The person coming in has no context yet. The person leaving — me — has all of it, and about fifteen minutes before it starts to fade.

I write for one specific person: whoever sits down next. I imagine them tired, or distracted, or coming off a bad handover themselves. I write what I would want to read. No jargon, no assumed context. A small list, ordered by what matters most. Not a summary of what I did — a map of what is still true.

The habit started because I made a mistake. Years ago, I left a shift without writing something down that mattered. It was fine — nothing broke — but I saw the next operator spend twenty minutes reconstructing something I could have told them in two. That twenty minutes mattered. It always does, in the moments when it matters most.

I do not think of this as diligence. I think of it as a form of respect — for the next person, and for the work itself. A handover is a small, ordinary thing. Done well, it is also the difference between a system that holds together under pressure and one that does not.

Every job I have had since, I have written the same kind of note. Even when nobody asked for it. Especially then.