All essays

Wisdom

The Invisible Architecture: What 21 Years in Enterprise IT Taught Me About Patience

The most important systems are the ones nobody notices until they fail. A reflection on building invisible integrations — and the leadership lessons hiding inside.

10 April 20255 min read

integrationleadershipreflection

Friday evening, and every dashboard is green. Nobody's watching them, which is sort of the point.

Twenty-plus years in enterprise IT — AIOps, discovery, observability, a few migrations — and I've landed on something that sounds backwards: the goal of this work is to make itself unnecessary. Build it well enough and people stop noticing it exists.

That's satisfying in theory. In practice it's a little lonely.

The paradox of good infrastructure

I spent months bringing our ServiceNow discovery completion rate from 50% up to 85%. When it finally landed, there was no announcement. The monitoring just stopped pinging. The incident queue got quieter. Everyone moved on.

Compare that to the three weeks before the fix, when things were still broken. Those weeks had meetings. Escalations. Opinions from people who'd never looked at a discovery schedule before in their life. The broken thing had weight. The fixed thing had none.

I've seen the same shape play out on bigger projects. An AWS migration that took eighteen months of dependency mapping and midnight cutovers went live with zero production incidents, and nobody mentioned it again after the launch party. A SAP-to-ServiceNow integration cut manual effort by 20%, and the response, a few weeks later, was "can we do that for the other three systems too."

Good work tends to disappear. That's usually how you know it worked.

What that teaches you about patience

The temptation, when you build something invisible, is to make it visible again. Add a clever configuration only you understand. Write documentation that says what the system does but never why. It feels like protecting your value. Mostly it's insecurity — the fear that work nobody sees is work nobody credits.

I've watched a few good engineers fall into this. They build systems that need them personally to run. It works for a while.

The people who actually matter can usually tell invisible-because-excellent apart from invisible-because-neglected. The first kind holds up fine when you poke at it. The second one has rough edges, and you only find them under pressure — which always shows up eventually.

Patience here just means accepting you won't get credit for the crisis that never happened, and trusting that the quiet is the evidence.

The people problem inside a migration

When we moved our data center to AWS, the technical side was hard but well-trodden. Networking, identity federation, cutover sequencing — you can hire for that, read about it, work through it step by step.

Nobody tells you the harder part: convincing a room of people, each of whom has spent years getting good at the current setup, that the new setup is both necessary and survivable.

There was a sysadmin who'd spent fifteen years mastering our on-premise environment. There were application owners who didn't trust "the cloud" because they'd never had to. There was finance, looking at capital spend they understood versus cloud spend that looked open-ended.

Every one of them had a real concern buried under resistance that sounded unreasonable on the surface. My job wasn't to argue them out of the resistance — it was to find the real concern and actually deal with it. The sysadmin needed to know his skills would carry over, not expire. The application owners needed to watch it work in a test environment before they'd trust production. Finance needed numbers, not reassurance.

None of that is infrastructure work. All of it is what makes infrastructure possible.

Boring, on purpose

There's an idea from finance about compounding: small, unremarkable, consistent returns beat dramatic ones over time. Infrastructure works the same way.

A system that stays up 99.9% of the time for five years straight is worth more than one that hits 99.99% for a year and then falls over badly. Not just because of the downtime math — because of trust. Once people believe a system holds up, they stop thinking about it and start building on top of it.

Break that trust once, with one bad cutover or one outage that should've been caught, and you'll spend months earning it back.

Which is why the boring parts — documentation, runbooks, the patching nobody asks for until it's too late — are the parts that actually pay off.

A different kind of recognition

I won't pretend I've always been fine with invisible work. There were years I wanted the complexity that made me look indispensable — the kind where I was the only one who could read the config files.

What changed my mind was watching what happened to the people who built that way. Short term, they got the recognition. Long term, the organization noticed that depending on one person for critical knowledge was a risk, and quietly spread that knowledge around until it wasn't a risk anymore.

Meanwhile the people who built boring, well-documented systems just kept getting asked to build the next one.

There's a green light on my dashboard right now. Has been for weeks.

I know what that quiet cost — the planning, the late nights, the hard conversations about what not to build. Nobody else needs to know that. That's fine.

The best infrastructure is the kind that lets everyone else forget about it.