Writing 5 min read

Metadata Is the Real Infrastructure Behind Trustworthy Healthcare AI

Why I build the data catalog before the model, and the architecture I would use to make healthcare AI you can actually trust.

Metadata Is the Real Infrastructure Behind Trustworthy Healthcare AI

Photo by Brett Sayles on Pexels

The short answer

The short version, in my experience: trustworthy healthcare AI is a metadata problem before it is a modeling problem. If you cannot describe, version, and trace every field a model touches, you are training on sand. Build the data catalog first, and the model work gets easier.

I have watched more AI projects stall on data than on models. The demo works on a clean extract, then the thing meets real feeds and falls apart. After a decade building products on healthcare data, my take is blunt. The model is the easy part. The hard part is the metadata layer underneath it, the boring plumbing that records what every field means, where it came from, and whether it changed last week. Truveta made that concrete when it published how its platform works. It normalizes more than 140 million patient records from over 50 source types, and the thing holding it together is not a clever model. It is a versioned catalog, more than 5,500 schema elements and 13,000 versioned transforms, treated as the system of record.

140M
patient records normalized in one platform
50+
distinct source data types reconciled
5,500+
schema elements under version control
13,000+
versioned transforms tracked in the catalog

Metadata is the infrastructure, not the paperwork

Metadata is not documentation you write after the fact. It is the load-bearing wall of an AI system, and in healthcare it is a patient-safety control.

Here is how I explain it to teams. Your model is a tenant. The data catalog is the building. If the building has no blueprints, no record of which walls are structural, and no log of the last renovation, you do not put an operating room on the top floor. You do not know what will hold. A field that quietly changed meaning after a payer updated a code can move a risk score, and nobody notices until it reaches a patient.

So the flow I want in every serious build is easy to say and hard to do. Raw feeds land. Every field gets described and versioned in a schema catalog. Transforms run as tracked, reviewable objects. A lineage graph keeps the thread back to the source row. Only then do models see the data. Skip any step and you are guessing.

From raw feeds to AI-ready data, with metadata as the spine

50+ source feeds
Claims, EHR, labs, devices
Schema catalog
Every field described and versioned
Versioned transforms
Rules tracked, not buried in code
Lineage graph
Trace any value to its origin
AI-ready tables
Models train on trusted inputs

The architecture I would build

A trustworthy healthcare data platform has five parts, and the catalog sits at the center of all of them. Tap any node below to see what it does.

The pattern is not exotic. What makes it work is that the metadata is not a side table, it is the spine. Truveta's own writeup names the exact failure modes I see everywhere: schema drift, transforms scattered across scripts, broken lineage, and slow onboarding of new sources. Every one of those is a metadata failure, not a modeling failure. You do not fix them with a better algorithm. You fix them with a catalog.

Who owns the pipeline

Metadata discipline dies when no one owns it, so I make ownership explicit before anyone writes a transform. Data engineering, machine learning, and governance each hold a lane in every phase. The common mistake is treating the catalog as data engineering's private chore. It is not. ML has to request and validate the fields it trains on. Governance has to approve definitions and audit drift, because in healthcare a definition change can be a compliance event. When all three lanes touch the same catalog, the metadata stays honest.

Onboard
Define
Transform
Serve
Data eng
Register feed
Map to schema
Version transforms
Publish tables
ML
Request fields
Validate inputs
Train on lineage
Governance
Set contract
Approve definitions
Audit drift
Sign off

Where I would start on Monday

If you are staring at a pile of feeds and no catalog, here is where I would start, in order. None of it is glamorous, and all of it pays off.

01

Inventory your sources

List every feed, its owner, and how often it changes. You cannot catalog what you have not named.

02

Describe and version the schema

Give every field a definition, a type, and a version. Freeze the meaning so drift becomes visible.

03

Move transforms into the catalog

Pull logic out of scattered scripts into tracked, reviewable objects you can diff.

04

Wire lineage end to end

Make every served value traceable to its source row before a model ever trains on it.

Build the catalog, or buy the platform

You do not have to build all of this yourself, and most teams should not. The FAIR principles, published in Scientific Data back in 2016, said it plainly. Data should be findable, accessible, interoperable, and reusable, and rich metadata is what makes all four possible. You can honor FAIR by building your own catalog or by buying a platform that already does it. My rule of thumb is short. If your data is narrow and stable, build a light catalog and move on. If your data is broad, messy, and always moving, which is most of healthcare, buy the platform and spend your team's time on models and clinical judgment, not on reinventing lineage.

QuestionBuild the catalogBuy a platform
Source varietyFine for a handful of stable feedsWins once you cross dozens of source types
Lineage depthYou own it, and you maintain it foreverComes with the platform, less to staff
Time to first modelMonths of plumbing firstWeeks, if your data fits the model
Control and lock-inFull control, full burdenFaster, with a vendor dependency
Best whenData is narrow and rarely changesData is broad, messy, and always moving

Either way, the order matters more than the tool. Catalog first, models second. I have never regretted spending the first month on metadata. I have regretted skipping it every single time.

Key takeaways
  • Trustworthy healthcare AI is a metadata problem before it is a modeling problem.
  • A versioned schema catalog, tracked transforms, and a lineage graph are the load-bearing walls, not the paperwork.
  • Truveta runs 140M+ records from 50+ source types on a catalog of 5,500+ schema elements and 13,000+ versioned transforms treated as the system of record.
  • Schema drift, scattered transforms, broken lineage, and slow onboarding are metadata failures, not model failures.
  • Make ownership explicit across data engineering, ML, and governance before anyone writes a transform.
  • Build a light catalog when data is narrow and stable, buy a platform when it is broad and always moving.

Frequently asked

What is metadata-driven data architecture?

It is an approach where the description of your data, its schema, definitions, versions, and lineage, is the system of record, and pipelines and models are built around that catalog rather than around ad hoc scripts.

Why does metadata matter for healthcare AI specifically?

Because a silent change in what a field means can move a clinical risk score. Versioned definitions and lineage let you catch that drift before it reaches a patient.

What are the FAIR principles?

Findable, Accessible, Interoperable, and Reusable. Published in Scientific Data in 2016, they make rich metadata the requirement that lets both people and machines trust and reuse data.

Should I build a data catalog or buy a platform?

Build a light one if your sources are few and stable. Buy a platform once you cross dozens of source types and need deep lineage, so your team spends time on models, not plumbing.

What are the most common failure modes?

Schema drift, transforms scattered across scripts, broken lineage, and slow onboarding of new sources. All four are metadata failures, not modeling failures.

Sources

Naveen Kumar

Naveen Kumar

Healthcare engineering and product executive in Pittsburgh. 15+ years building AI-first patient access, a decade at Treatspace.

Read next