Portfolio ↗

Digs

Searching X architecture returns material written to be found by that query, which means tutorials and vendor pages. The material worth having was written by an engineer explaining a real system to their peers, and it uses different words. A dig is what comes back from going after that layer on one topic: the architecture reconstructed across real systems, the decisions and the conditions that flip them, what actually broke, and numbers you can plan against. Every claim is graded, linked and dated.

90 field guides 2433 graded sources 419 postmortems 8 categories
All AI & LLM Systems8 Data Platforms12 Distributed Systems10 Platform & Infrastructure24 Integration & APIs11 Security & Identity8 Reliability & Operations11 Cost & Efficiency6

Compute, orchestration, networking, developer platforms, build and release.

Platform & Infrastructure 28 Sep 2026

The parts that outlived the product: ten years of Docker, read from its own repositories

A decade of one company's architecture told through the sequence every platform team eventually faces: bundle to win the workflow, extract components to cut the blast radius of your own releases, specify the b…

What surprised meThe 2018 authorization fix that shipped in Engine 18.09.1 is not an ancestor of v19.03, v20.10, v23.0 or v27.1.0; the commit first appears in a tagge…
38 sources · 9 organisations · 5 postmortems 35 min read
containerscontainerdruncopen-sourceplatform-strategy
Platform & Infrastructure 27 Sep 2026

Boundaries without a network hop: ten years of Shopify, read from its own artefacts

Reconstructs a decade of one company's architecture from artefacts rather than announcements: repository archive notices, release notes of the language it forks, design documents inside the reference implement…

What surprised meHaving got YJIT into CRuby, declared stable on the strength of a year in production, and enabled by default in Rails, Shopify started over: Ruby 4.0.…
30 sources · 8 organisations · 2 postmortems 31 min read
monolithwebassemblyrubystatic-analysissandboxing
Platform & Infrastructure 25 Sep 2026

Your singletons choose where you fail: ten years of GitLab's architecture

A decade of one company's platform evolution, reconstructed entirely from primary artefacts it publishes in Git repositories: 207 design documents, two rejected routing proposals, a closed merge request that d…

What surprised meThe horizontal-scalability programme rewrote its own goal: Cells opened in 2022 as a platform re-architecture and its current iteration describes its…
28 sources · 2 organisations · 5 postmortems 29 min read
multi-tenancyshardingmonolithpostgresqlgit-storage
Platform & Infrastructure 21 Sep 2026

When the internal fork wins: ten years of Netflix retiring its published platform libraries

Netflix published the reference implementation of the fat client library, then dismantled it in public over ten years, one dated commit at a time. This guide gives an architect the six-stage lifecycle every on…

What surprised meThe remediation published for a Critical server-side request forgery advisory was to move the vulnerable component to a different GitHub organisation…
22 sources · 6 organisations · 7 postmortems 32 min read
open-sourcedependenciesdeprecationmicroservicesgovernance
Platform & Infrastructure 17 Sep 2026

Emulate, then own: ten years of Microsoft leaving its own compatibility layers

Three unrelated parts of Microsoft's developer platform ran the same experiment in public and ended the same way: ship a clever layer that imitates another system, operate it at scale, then replace it with the…

What surprised meNone of the three replacements removed the cost; each moved it to a narrower boundary and made it measurable, and in two cases Microsoft still recomm…
31 sources · 5 organisations · 8 postmortems 34 min read
compatibilitymonorepovirtualizationmigrationgit
Platform & Infrastructure 16 Sep 2026

Maintenance mode: a decade of Netflix retiring code that runs in other people's processes

Reconstructs a decade of Netflix platform retirement from package-registry timestamps, README status blocks, archive banners, unmerged pull requests and security advisories. A reader leaves with a way to predi…

What surprised meSurvival tracks what a component does, not how old or popular it is: every Netflix library that held policy an application had to configure is frozen…
29 sources · 6 organisations · 4 postmortems 35 min read
open-sourcedeprecationclient-librariesservice-discoverydependency-risk
Platform & Infrastructure 14 Sep 2026

Deciding what to stop building: ten years of Spotify, read from its own archive notices

Reconstructs a decade of platform decisions at Spotify from 289 public repositories and the dated notices attached to them, the package registries that record when software actually stopped shipping, and the 6…

What surprised meArchiving a repository at Spotify is a publishing decision rather than a retirement decision: the Styx scheduler's repository was discontinued in Jul…
36 sources · 10 organisations · 5 postmortems 35 min read
developer-platformopen-sourcedeprecationbackstagebuild-vs-buy
Platform & Infrastructure 13 Sep 2026

Ten years of changing a runtime you are not allowed to break

A hosted runtime cannot ask its tenants to upgrade, so Cloudflare pins semantics to a date per deployment and releases the runtime every day. This guide reads the contract out of the one file where it is writt…

What surprised meThe flag namespace is accelerating rather than converging: 4 flags took a default date in 2021 and 26 have taken one in the first nine months of 2026…
24 sources · 5 organisations · 2 postmortems 30 min read
cloudflareworkersbackwards-compatibilityjavascript-runtimeplatform-evolution
Platform & Infrastructure 12 Sep 2026

The update that expires: ten years of Datadog on machines it does not own

A decade of one observability company read through the only part of it that runs on other people's computers, reconstructed from commit history, systemd unit templates, CI budget files, closed pull requests an…

What surprised meThe commit rate on the abandoned Agent 5 repository went back up after 2022, and the work is certificate-authority rotation runbooks written for bash…
28 sources · 4 organisations · 3 postmortems 32 min read
fleet-managementrelease-engineeringagentssystemdremote-configuration