Model cards and system cards for your own systems, written so an outsider could act on them
The short answer
Two cards, two jobs
A model card documents the trained model, its capabilities, training, and measured performance. A system card documents the deployed system, the model plus the application layer of prompts, retrieval, filters, and human review. If you deployed anything, you owe both, because the gap between what a model can do and what a system actually does is where the real risk lives.
What you will be able to do
- Write a model card for a model you built, using the structure introduced by Mitchell and colleagues (2019), covering model details, intended use, out-of-scope use, factors, metrics, evaluation and training data, disaggregated results, ethical considerations, and caveats.
- Write a system card for a deployed system, covering the components, data flows, human oversight points, system-level evaluation, red-team findings, deployment boundaries, monitoring, and the update process, so the application layer is documented, not just the model.
- Distinguish a model card from a system card and explain why the gap between what a model can do and what a deployed system actually does is where most real-world failures live.
- Apply the outsider test to any card: name the specific outside reader, name the decision they must make, and check that the card lets them make it without you present.
- Connect your cards to the obligations that now demand them, including EU AI Act Article 53 documentation for general-purpose AI model providers (Annex XI and Annex XII), the NIST AI Risk Management Framework Map and Measure functions, and ISO/IEC 42001, without overclaiming what any one document satisfies.
- Explain why a card is a living document that must be versioned and dated, using the behavior-drift evidence, and design a card so that staleness is visible rather than hidden.
- Assemble a card from evidence you already produced (your "how my model fails" explanation, your evaluation report, your data provenance file, your incident log) rather than writing fresh prose, and hand the finished cards to your evidence annex.
- Distinguish real oversight from nominal oversight in a system card, and document a human review step only after testing whether the human can actually see and act before harm occurs.
- Split ownership correctly when you did not train the model: write a system card for your deployment, treat a vendor's model card as a cited dependency, write a fresh model card when you fine-tune, and record any documentation gap as a named supplier risk.
The lesson
In the summer of 2023, a research team from Stanford and Berkeley set out to measure how foundation models perform over time. They ran a highly specific test. They asked GPT-4 to identify prime numbers.
This chart plots the results. In March, the model answered correctly roughly 84. Because systems drift, regulators are shifting AI documentation from an optional courtesy to a strict legal requirement.
The European Parliament, pictured here, is enforcing this through the EU AI Act, which now mandates structured technical documentation for AI models. Meeting these mandates requires a discipline called evidence engineering, building proof into the system before an audit or an incident response demands it. The first principle of evidence engineering is simple.
Two cards, two jobs. The first is the documents the raw, trained model in isolation, detailing its capabilities, its training data, and its baseline metrics. The second is the system card.
This documents the deployed application. It covers the system prompts, retrieval pipelines, outfilters, and human oversight. A capable model can become dangerous depending on how it is prompted and filtered.
Documenting only the raw model ignores the reality of the deployment. This diagram breaks down the division of labor. On the left, the model card contains the neural network's weights, its training datasets, and its core architecture.
On the right, the system card captures the environment built around that model, the API gateways, prompt instructions, content filters, and human review steps. Writing these cards correctly relies on a second principle. The outsider test is the only standard.
Every sentence in your documentation must serve a specific outside reader. That reader might be a downstream integrator, a regulatory auditor, or an incident responder trying to contain a failure. The test is strict.
That outsider must be able to read the card and make a correct go or no-go decision without the author in the room to explain it. Subjective language fails this test. Promotional phrases like highly accurate or advanced AI give an auditor nothing to measure.
You must strike them from the document entirely. This brings us to the third principle. Honesty is load-bearing.
The most vital sections of documentation are the out-of-scope uses and the known failure modes. There is a massive legal distinction between discovering your own system's failure and having a regulator or an injured user discover it for you. A caveat that you write down in a model card serves as concrete evidence of your operational diligence.
The exact same failure, discovered later by an auditor, is treated as evidence of concealment. To find those failures, you must follow the fourth principle, disaggregate or mislead. Consider a model that scores 90% overall accuracy, represented by this solid chart.
That 90% average can easily conceal a 60% failure rate for a specific demographic group or environmental condition. Deploying the model based on an aggregate average is a compliance violation in many jurisdictions. For example, New York City Hall passed Local Law 144, which explicitly forces employers to publish disaggregated audit results on automated hiring tools.
If your team does not break down its metrics and document these demographic gaps privately, the state will eventually do it for you publicly. Because performance degrades over time, we reach the fifth principle. A card must be living.
An undated, unversioned card describing a system that has updated underneath it is an act of liability that carries your authority. This document header shows the mandatory metadata, a strict as-of date, a precise version number, and a defined trigger list. If a vendor updates the base model, or if a retrieval index changes, that trigger fires, the card version bumps, and the team must re-evaluate the system.
When you update that card, apply the sixth principle, assemble, do not invent. Engineers frequently fall into the trap of writing fresh, persuasive prose to describe a system's capabilities. Instead, your documentation should be a mechanical assembly of existing artifacts.
Pull your claims directly from data provenance logs, incident records, and formal evaluation reports. Relying exclusively on tested numbers prevents your team from generating hallucinatory compliance filler. When you maintain a strict evidence-based card set, you are building a shared evidence layer that satisfies multiple global regulators at once.
This diagram maps a single card set directly to the EU AI Acts Article 53 Obligations for General Purpose AI. That exact same card set also provides the documentation required for the NIST AI Risk Management Framework and ISO 42001 standards. However, teams often sabotage this compliance bridge.
The most common mistake is relying entirely on a vendor's base model card. If your vendor provides thin documentation, you cannot skip writing your own system card. You must explicitly record their missing documentation as a named supplier risk.
Another major trap is listing human review as an automatic safeguard in your system card. You must differentiate between nominal and real oversight. Ask one question, can the human reviewer realistically see the output and intervene before the harm occurs? Documenting an oversight mechanism that cannot actually fire in time is legally worse than admitting you have a security gap.
Your immediate action is to gather your existing evaluation reports and system logs. Draft your model card, ensuring every performance claim maps directly back to those tested numbers. Next, draft your system card.
Track and lock down the version number of every prompt, filter, and base model in your pipeline. Finally, execute a red team attack on your own drafts. Read them as a hostile auditor, aggressively hunting for the gap between what the document claims and what the system actually does.
Finding and documenting your own gaps is the ultimate defensive maneuver. In AI governance, legibility is the foundation of trust.
The ideas, one by one
The outsider test is the only standard
A card earns its existence only if a named outside reader can make a real decision from it without you in the room. Name the reader, name the decision, and strike every sentence that does not serve it. This one test kills marketing language, vagueness, and hidden failure modes at once.
Honesty is load-bearing
The most valuable content in any card is the honest bad news: out-of-scope uses, failure modes, and the groups or conditions where performance drops. A caveat you wrote is evidence of diligence; the identical fact discovered by an auditor is evidence of concealment. Authorship is the whole difference.
Disaggregate or mislead
A single overall accuracy number is exactly the failure model cards were invented to fix. Report performance broken down across the factors you named, because a model strong on average can be dangerously weak for one group or one condition.
A card must be living
Dated, versioned, and carrying a changelog and review triggers. The behavior-drift study shows what an un-versioned system costs: a product changed under its users and no document recorded it. An undated card is worse than no card, because it carries your authority while telling a stale lie.
Assemble, do not invent
A good card is built from evidence you already produced: your failure explanation, your provenance file, your evaluation report, your incident log. If you are writing a claim with no artifact behind it, you have found either an unsupported claim or a hole in your evidence work.
One artifact, several regimes
Written well, your cards do real work against the EU AI Act's general-purpose AI model documentation duties (Article 53, Annex XI and XII), high-risk documentation (Articles 11 and 13), the NIST AI RMF Map and Measure functions, and ISO/IEC 42001. Do not overclaim: no single card makes you compliant, but one maintained card set beats a drawer of contradictory compliance PDFs.
A missing vendor card is a finding
If you build around someone else's model and cannot get honest documentation of its capabilities and limitations, that gap belongs in your system card as a named supplier risk, not hidden. The EU AI Act now gives you standing to demand it.
A card is a summary, not a report
The evaluation report substantiates; the card communicates. A good card fits on a page or two and points to the underlying artifacts for the detail. Its value is not length but the speed with which an outsider can reach the right decision. If your card is a thirty-page document, you have written a report and mislabeled it.
Document oversight honestly, not aspirationally
A human review step listed as a control is worthless if the human cannot see or act before harm occurs. Distinguish real oversight from nominal oversight in the system card, and write the nominal ones down as gaps. An oversight control that cannot fire in time is not protection, it is the appearance of protection.
The card is a rehearsal for the audit
The self-attack you run on your own cards is the same read a hostile board or examiner will run in Module 13. The better your cards survive your own worst reading now, the fewer surprises the real adversary finds later, and the more the auditor trusts everything behind them.
A narrow claim you can prove beats a wide one you cannot
Broad intended-use statements sound capable and collapse under audit. Narrow the intended use until it is testable, then defend it. The reader does not need your system to sound impressive; they need to know exactly where your evidence holds and where it stops.
Ownership splits, responsibility does not
When you integrate a vendor model you still owe a system card, when you fine-tune you owe a fresh model card, and a missing vendor document is your finding to record, not your excuse to skip. You can cite a dependency, but you cannot outsource the description of the system you built and serve.
You read it. Now prove it.
Explain this lesson in your own words, the way you would to a colleague, without looking back at it. It is graded against the lesson itself, by the same grader our learners face. One free try a day, no account needed.
The conversation
The same lesson, talked through at length by two hosts: the full transcript of the audio deep dive.
Listen to it as episode 78 of the podcast.
Read the full conversation
So, in the summer of 2023, thousands of businesses just woke up to find that the smartest AI model in the world had suddenly, inexplicably, forgotten how to do basic math. Yeah, it was an absolute crisis for anyone relying on that infrastructure. I mean, we're talking about medical triage bots, automated legal assistants, enterprise customer service pipelines all running smoothly on a Friday, and then fundamentally breaking by Monday.
Right. And the scariest part for the developers managing those systems, the vendor providing the AI model never sent a memo. Nothing.
No warning at all. Exactly. No scaffolding, no release notes.
There was just zero warning that the digital ground beneath their feet was about to shift. And that forced thousands of downstream integrators to just, you know, reverse engineer a system, collapse in real time on their own production environments. Which is terrifying.
And this brings us to a really landmark study from researchers at Stanford and UC Berkeley, Lingjie Chen, Matei Zaharia, and James Zhu. Right. The CHAT-GPT Drift paper.
Yes. They published this paper on Rxiv titled, How is CHAT-GPT's behavior changing over time? And their methodology was incredibly straightforward, but the results just sent shockwaves through the tech industry. Because they took the exact same set of test questions, right? Yes.
The exact same questions ran them past the exact same paid API endpoint. They tested the March 2023 version of GPT-4, and then they tested the June 2023 version. Which is key for you, the listener, to understand.
You are paying the same price for the same brand name, hitting the exact same server endpoint. But the machine answering the call had completely changed. I mean, let's look at the specific figures here, because they are just jarring.
They really are. The researchers gave the model a very narrow objective test, which was just identifying whether a given number was prime. And the March version of GPT-4 answered that crime number identification correctly about 84% of the time.
But just three months later, the June version of that exact same system answered correctly only about 51% of the time. I mean, that is a massive sudden degradation and a highly specific capability. Huge drop.
Yeah. And we should provide the full context of the discourse that followed this, because this paper sparked a fierce debate among machine learning researchers. Oh, absolutely.
You had experts like Arvin Narayan and Sayash Kapoor, who analyzed the findings, and they pointed out that we weren't necessarily witnessing a pure collapse in the underlying neural network's reasoning capabilities. Right. They argued it was largely a formatting shift, wasn't it? Precisely.
The June model had been tweaked to respond differently. So instead of just outputting the binary answer that the automated evaluation scripts were looking for, it started adding conversational filler. Like, sure, I can help with that.
Exactly. Or it changed its syntax. So the evaluation scripts just couldn't parse the new format.
It looked like the model was failing the math, when in reality the format of the output had just shifted beneath the parser. But, you know, if you are a listener who manages a product right now, like, you are a busy professional who has wired this model into your company's workflow that academic distinction doesn't matter at all. It doesn't matter one bit.
Right. Because whether the model lost its ability to reason or it just changed its formatting so your API parser broke, the end result is exactly the same. Your system failed in production.
And that is the ultimate governance lesson here. Systems change. Always.
And when a vendor updates a model without providing a rigorous living document that travels with it, a document explicitly stating what the model does, where it fails, and exactly what changed since the last version, you are basically flying blind. Which is so dangerous. The 2023 Anchor case proves that raw capability is meaningless if the downstream user cannot predict its behavior.
So if you are that professional, whether you are prepping for a high stakes deployment meeting or auditing a third party vendor, or just trying to manage the risk of an AI feature you are building internally, you cannot afford to fly blind. No, you need an executive level audit ready evidence layer. Yes, and we are not talking about a glossy marketing brochure here or a PR slide deck.
We are talking about actionable proof. So today, in this deep dive, we are going to explore exactly how to rigorously document your AI models and your deployed systems so that a complete stranger can make the right high stakes decision about your technology without you even being in the room. And to build that evidence layer, I mean we first have to understand the boundaries of what we are actually documenting.
Okay, let's set the boundaries. Because the biggest mistake professionals make is confusing the underlying model with a deployed system. We really need to define the application layer.
Let's unpack that. I've heard the term application layer thrown around in engineering meetings constantly, but what is the exact definition when we are talking about AI governance? So the application layer encompasses everything that is wrapped around a raw base model when it is actually deployed into a production environment. Because you have to remember that a raw model, the artifact produced by pre-training, is just a massive matrix of weights and probabilities.
It just predicts the next token. No end user ever interacts with a raw model, they interact with the system. That makes sense.
So what specifically makes up that system? Well, the application layer is the architecture built around that statistical engine. So it includes your system prompts. The hidden instructions.
Exactly. The instructions that tell the model how to behave before the user even types a word. It also includes your retrieval layer, which is often called RAG, or Retrieval Augmented Generation.
Which dictates which specific databases the model is actually allowed to search for answers. Right. And it includes the input filters that catch toxic or out-of-bounds user queries, and the output filters that block dangerous responses.
So it's all the safeguards too. Yes. Plus your rate limits, your user interface, and critically, your human-in-the-loop review steps.
Let me try to ground this with an analogy, because I really want to make sure I'm separating these two things perfectly for the listener. Go for it. If we look at automotive engineering, the raw model is basically the internal combustion engine.
Right. It has a specific displacement, a baseline horsepower, a raw capability to generate force. The weights and parameters are basically the combustion physics.
That's a really strong starting point. Yes. But the application layer is everything else that turns that raw force into a drivable vehicle.
So the system prompt is the engine control unit, like the governor limiting the RPM so it doesn't redline. I like that. And the retrieval layer, the RG database, is the GPS dictating exactly which roads the car is allowed to drive on.
And the input and output filters are the brakes, the airbags, and the steering chassis. Exactly. And the crucial takeaway for the listener here is the gap between a model's raw capabilities, the horsepower of the engine, and a deployed system's actual behavior is where almost all real-world harm lives.
But wait, let me just push back on this on behalf of every corporate integrator listening right now. Sure. Because if I am a procurement officer or an engineering lead, and I decide to buy access to a state-of-the-art frontier model from a massive, highly-capitalized vendor, let's say OpenAI, Anthropic, or Google, isn't the safety inherently built into their engine? That assumption is so pervasive.
Right. Because if they spent millions red-teaming and fine-tuning their model to make it safe, and I just plug my app into it, aren't I legally and functionally protected? That is arguably the single most dangerous trap in AI adoption today. Really? Let me break down exactly why that is false.
The risk profile is determined by your deployment decisions, not just the vendor's model. Okay, give me an example. Let's look at a concrete scenario.
You buy a highly-capable, general-purpose frontier language model from a top-tier vendor. It's a spectacular engine. Okay.
Now you wrap that model in a broad permissive system prompt, you apply zero output filters, you give it access to the open internet instead of a verified database, and you deploy it as a public-facing medical triage chatbot on your hospital's website. Oh wow, that sounds like a massive liability lawsuit waiting to happen. It is entirely dangerous.
The model, just trying to be helpful, might confidently hallucinate a dosage recommendation or misdiagnose a critical symptom. The raw capability of the model is neutral, but your specific application layer decisions turned it into a hazard. Because I basically built a car with a 900-horsepower engine and forgot to install the brakes.
Precisely. Now let's take that exact same raw model from the vendor, literally the exact same engine, but this time your application layer is entirely different. Okay, how so? You wrap it in a narrow, highly-restrictive system prompt that's strictly forbidden from offering diagnoses.
You apply a strict output filter that flags and blocks medical terminology. Smart. You restrict its retrieval layer exclusively to your hospital's internal, peer-reviewed knowledge base.
And you mandate that any query flagged as high-urgency is immediately routed to a human triage nurse, bypassing the AI entirely. So in that context, the exact same base model is now the core of a highly-safe, tightly-bounded assistant. Yes.
A mediocre model can be made safe by a rigorous application layer, and a highly-safe model can be made incredibly dangerous by a reckless application layer. That makes total sense. Because the model and the deployed system are two entirely different entities, right? Yeah.
With fundamentally different risk profiles, you just cannot document them in a single generic spec sheet. Which means we need a highly-specific framework to document this duality. Exactly.
And the overarching theme of our outline today, the absolute spine of this methodology, is built on five core principles. And the first of those principles is two cards, two jobs. Two cards, two jobs.
This is the bedrock of modern evidence engineering. Okay. Because if you try to mash these two concepts together, you will fail every audit you face.
You need a model card, and you need a system card. They serve entirely distinct functions. Okay.
Let's establish the model card first to find the mechanics of it for us. A model card is a structured, concise document that travels with a trained machine learning model. Its specific job is to state in plain, objective, non-promotional language what the model is, its intended uses, the factors its performance varies across, the specific metrics used to evaluate it, and its known caveats.
And this concept isn't entirely new, right? No, not at all. To give our listeners the academic context, this traces back to a highly influential 2019 paper by Margaret Mitchell and a team of researchers titled Model Cards for Model Reporting. And the landscape of machine learning back in 2019 really illustrates why they had to invent this in the first place.
Because back then, developers were deploying models onto platforms like GitHub with virtually no documentation other than, like, a single aggregate accuracy number. You would just see a headline metric like, our computer vision model achieves 95% accuracy. But that single number is practically useless in the real world.
It is dangerously incomplete. The motivation behind Mitchell's paper was to highlight that a model scoring 95% overall might be achieving 99% accuracy in ideal lighting conditions for a majority demographic, while failing catastrophically, say, 40% accuracy in low light conditions, or for specific minority groups. So the model card was conceived as a forcing function to make developers report those crucial nuances.
It's the exact same logic behind the famous Data Sheets for Datasets paper, right? The one published a year earlier in 2018 by Tim McGebru and her colleagues. Exactly the same logic. That paper argued that training data needs a standardized nutritional label explaining where it came from, how it was captured, and what its inherent flaws are.
Yes. It creates an unbroken chain of documentation. Your training data gets a datasheet.
Your raw trained model gets a model card. Okay, so what actually populates a model card? I assume you can adapt the headings, but there must be a specific set of rigorous details you have to cover. There are.
While you can adapt the headings to your organization, you must cover a specific set of non-negotiable sections. Walk us through those non-negotiable sections. First you must have model details.
This is the basic metadata. Who built it? What is the exact version number? What is the release date? What is the architecture type? And under what license is it distributed? Very foundational stuff. Right.
But if you don't have a strict version number and date, you don't have a card. You have a rumor. You don't have a card.
You have a rumor. That is a great line. What's next? Second is intended use.
What is the primary function of this model? Who is the intended user? And most critically, what are the explicit out-of-scope uses? Things it absolutely should not do. Right. Third, you detail the factors.
What are the demographic groups, environmental conditions, hardware variations, or linguistic differences that might alter the model's performance? So basically mapping the variables that change the math. Yes. Fourth, the metrics.
What specific statistical measures are you using to define success or error? And what is your internal threshold for acceptable performance? Got it. Fifth is evaluation and training data. What specific data sets did the model learn from? And what data sets did you use to test it? And finally, the quantitative analyses.
This is the hard, disaggregated data showing exactly where the model succeeds and where it fails. Okay. So that is the model card.
That is the spec sheet for the engine. Now, how does the system card differ? Because this is the spec sheet for the car, the application layer we just discussed. Right.
The system card documents the deployed system as a whole. It encompasses the raw model plus the entire application layer. And we are actually seeing industry leaders standardize this practice.
When OpenAI released GPT-4 in March 2023, they didn't just release a model card. They published a massive, highly detailed system card. Anthropic does the same for their Claude models.
And if you read the system cards, which every listener absolutely should, what stands out is that they don't read like marketing material at all. Not even a little bit. They document their red team findings.
They detail the adversarial testing they performed, the mitigations they built into the application layer, and critically, the residual risks. Yes. Residual risks being the dangerous behaviors the system might still exhibit even after all the safeguards and filters have been applied.
Right. A system card that only lists successes tells a downstream integrator absolutely nothing they can act on. So what are the required sections for a system card? A robust system card must cover the system purpose and context.
You are not describing what the base model can do. You are defining what the system's specific job is in the real world. Next, you must map the components.
This is a literal inventory of your application layer, including the exact version numbers of your input filters, output classifiers, and retrieval databases. So you have to list every part you bolted onto the engine. Exactly.
Then, you document the data flows. When a user types a prompt, where does that data travel? Does it hit a third-party server? Is it logged for future training? That's huge for privacy audits. Absolutely.
You must also document human oversight. At what exact points in the workflow can a human intervene, and what authority do they have? Finally, you provide system-level evaluation testing the car as a whole, not just the engine, and define the deployment boundaries. Okay, I have a practical question regarding the split in ownership here.
Let's say I'm an engineering manager at a mid-sized logistics company. I don't have the compute or the capital to train a frontier model from scratch. I am just buying API access to a vendor's base model, and I'm wrapping it in my own system prompts and connecting it to my logistics database.
Pretty standard setup. Right. So, what is my exact documentation burden in that case? Do I write a model card? The rule of ownership is absolute.
If you build from scratch, or if you fine-tune a model, meaning you're computationally altering the underlying weights and probabilities, you owe a model card. Okay. But in your scenario, you are merely deploying a system around an untouched base model.
Therefore, you owe a system card for your specific deployment. So I just ignore the model card entirely? No. The vendor who built the base model owes you the model card.
You take their model card, and you treat it as a cited foundational dependency within your system card. Your documentation rests on theirs. Got it.
Two cards, two jobs. But knowing the headers of the document is only the structural foundation. The much harder problem is knowing what words actually belong underneath those headers.
That is where most companies fail. Because it is incredibly easy for a product manager to look at those sections, hand it over to the marketing team, and suddenly your system card reads like a press release. So how do we prevent this from becoming a glossy brochure? That requires a brutal, uncompromising filter applied to every single sentence you write.
Which brings us to the second core principle of our spine. The outsider test is the only standard. The outsider test.
Break down the mechanics of this test for us. When you are drafting either of these cards, every single sentence must pass a three-part test. First, you must be able to name the specific outside reader you are writing for.
Second, you must name the specific high-stakes decision they have to make. And third, you must objectively verify that the sentence you just wrote allows them to make that decision without you in the room to explain it. So if a sentence doesn't actively help a stranger make a concrete decision, it is deleted, period.
It gets struck from the record. It is useless decoration. Who exactly are these hypothetical outsiders? Let's map the audience so the listener knows who they're writing for.
There are five specific external personas you must design these cards for. First is the downstream integrator. This is an engineer or product manager at another company who wants to wire your model into their own product.
Their primary decision is determining whether their specific use case falls safely within your validated conditions. They are reading your out-of-scope section like a legal contract. Who is the second outsider? The auditor or regulator.
Their decision is compliance-based. They are trying to decide if your system meets legal or internal risk standards. So they don't care about the marketing pitch? Not at all.
They don't care about your product vision. They are scrutinizing your metrics and your disaggregated results to see if your evidence holds up to mathematical scrutiny. Now the third one is my favorite because I think it creates the best mental image for why marketing language fails so badly here.
The third outsider is the incident responder. It is 3.am on a Sunday. The deployed system has just exhibited a catastrophic failure.
Maybe it exposed personally identifiable information or generated a highly toxic output. A total nightmare scenario. Exactly.
And the incident responder is staring at a stack trace, trying to decide how to contain the damage and whether they need to pull the plug on the entire system. And at 3am during a system outage, they do not want to read a paragraph about how your AI is seamlessly revolutionizing workflow synergy. Exactly.
They need to read your known failure modes and your architectural component map. Who is the fourth? The fourth outsider is the buyer or procurement officer. Their decision is adoption-based.
They are evaluating your overall risk maturity to decide if doing business with you is a liability. And finally, the fifth outsider is the future maintainer. Which ironically might just be you.
It is often literally you 18 months from now. You have moved on to a new project. You've forgotten all the unwritten nuances of the original system.
And suddenly you have to decide which dependencies need to be updated. You are an outsider to your past self. I can hear the pushback from our listeners who work in product management right now.
They might be thinking, hold on, we already have a standard product spec sheet for our software. It tells the buyer what the product does. Why reinvent the wheel here? Because traditional product specs fail the outsider test almost universally.
The outsider test is specifically designed to assassinate three bad habits that product documentation relies on. What's the first habit? The first habit is marketing language. Words like advanced, robust, seamless, or revolutionary do not help an incident responder or an auditor make a decision.
There are subjective adjectives, not objective evidence. What's the second habit? Vagueness. A product spec might say, the model performs well on multilingual language tasks.
That is entirely unactionable. What does performs well mean? A 70% accuracy rate, 90%. Which specific languages? You need hard metrics and precise boundaries.
And the third habit is the most dangerous one, hidden failure modes. Product specs are designed to sell, which means they systematically omit the conditions under which the product breaks. And that third habit, hiding failure modes, leads us to the most uncomfortable, yet undeniably the most vital part of this entire discipline, which introduces the third core principle of our spine.
Honesty is load-bearing. Honesty is load-bearing. This cannot be overstated.
An AI card is not a brochure. Its value to an outsider is inversely proportional to how much it flatters you. So true.
The highest value real estate on either a model card or a system card is the honest bad news. You are talking specifically about the out-of-scope section. Yes.
The out-of-scope section is where you explicitly detail the contexts, the populations, the environments, and the specific inputs where your system is unvalidated, unsafe, and should not be used under any circumstances. Now from a governance perspective, that makes total sense. But let's be real about corporate dynamics here.
I am putting myself in the shoes of a governance lead at a tech company. I draft a system card that says, our model degrades heavily when processing regional dialects and it frequently hallucinates when queried about recent financial data. I take that draft to my legal team and my PR department.
They are going to lose their minds. Oh, they will absolutely panic. They will say, you can't publish that.
You are writing a public indictment of our own engineering. Why is that instinct wrong? It is wrong because it fundamentally misunderstands the legal and regulatory mechanics of the technology sector. We have to examine the concept of diligence versus concealment.
Walk us through the legal mechanics of that. Diligence versus concealment. If your engineering team knows that the system fails under specific conditions, say, it struggles with non-standard dialects, and you choose to hide that fact to appease your PR department, one of two things will inevitably happen.
Okay. Scenario one. Scenario one.
This system is deployed, it causes tangible harm to a user, and a lawsuit is filed. During the legal discovery process, the plaintiff's attorneys will subpoena your internal Slack messages, your JIRA tickets, and your valuation logs. And they'll see you knew about it.
They will prove that you knew about the flaw and chose to stay silent. That is evidence of concealment, and it is legally devastating. It applies negligence or fraud.
And scenario two. Scenario two. An independent auditor, a regulator, or a tech journalist runs adversarial tests on your system and discovers the flaw themselves.
Once an external party finds a hidden failure mode that you failed to document, they immediately assume that every other claim in your documentation is a lie. Your institutional credibility drops to zero. But what if I managed to push past my PR department and write the flaw down in the system card myself? Then the legal and perceptual narrative completely flips.
A caveat or failure mode that you explicitly document is evidence of diligence. Wow. Okay.
It proves to an auditor that you tested your system rigorously, understood its boundaries, and warned your users. The exact same flaw, discovered by someone else, is evidence of concealment. The words describing the failure are identical.
Authorship is everything. This goes beyond corporate liability, though. There is a fundamental mechanism of contestability that relies on this honesty.
The source material references a fascinating case regarding a welfare risk-scoring algorithm in France. And this perfectly illustrates why documenting harms is a structural necessity. Yes.
The French welfare algorithm case, often referred to involving the CAF, the Castellication Familiale, they deployed an algorithmic risk-scoring system to detect welfare fraud. Right. And the system was disproportionately flagging low-income individuals, single mothers, and disabled citizens for aggressive audits.
And for a long time, the citizens couldn't fight back because the system was a black box. Exactly. When advocacy groups finally got access to the source code and the underlying logic, they realized the model was explicitly using data points like receiving disability benefits as a risk factor for fraud.
Which is awful. It is. The point here is objective technical contestability.
A system's harms must be examinable for the system to be contestable. So if the government had published a rigorously honest system card up front that stated this model heavily weights low-income indicators, the public could have contested the logic before lives were ruined by false audits. Precisely.
A card that honestly documents who the system is likely to misclassify, and under what conditions, is the baseline mechanism that allows affected populations to advocate for themselves. It gives them the map to the algorithm's blind spots. Let me hit you with one more piece of corporate pushback on this honesty principle.
What about the competition? Well, this comes up all the time. Right, because doesn't listing every single failure mode on a public document just hand-free ammunition to our rivals? Aren't we basically writing their negative ad campaigns for them? It is a very common executive fear, but it is a complete strategic illusion. Competitors do not need your system card to find out where your product failed.
They don't. No. They have engineering teams and budgets.
They will simply buy a license to your API, run massive automated adversarial testing suites against it, and map your weaknesses themselves within a week. So the competitors already know. Yes, but you know who doesn't have the time to run endless adversarial tests, but does have the power to shut your business down? Regulators, independent auditors, and the courts.
They will take your documentation at face value, and if they find out that your internal engineering reality doesn't match your external documentation, they will penalize you heavily. You are trading a hypothetical marketing annoyance with a competitor for a guaranteed legal disaster with a regulator. Okay.
So we've established that we have to be honest about our failure modes, but being honest isn't just about listing broad, qualitative caveats. You can't just say systems sometimes struggles with diverse populations. You have to prove it mathematically, which leads us to the fourth core principle of our spine, disaggregate or mislead.
Disaggregate or mislead. This principle goes all the way back to the foundational reason Mitchell and her team invented the model card in 2019. Aggregate numbers in machine learning are inherently deceptive.
Explain the mechanics of that for us to find disaggregated results. Disaggregation is the process of taking your top-line overall performance metric, let's say your overall accuracy score, and breaking it down across specific named factors. You calculate and report the performance independently by demographic group, by spoken language, by geographic region, by capture condition, or by whatever variables are relevant to your specific deployment context.
And what is the mathematical danger of just reporting the aggregate average? The trap of the aggregate average is that it is weighted by the size of the groups in your testing data. Therefore, it mathematically hides catastrophic minority failures. Break down the math on that.
Let's look at the math. Imagine you have a facial recognition system. You test it on 10,000 images.
9,000 of those images are of lighter-skinned individuals, and the model achieves 99% accuracy on them. Great score. But only 1,000 of the images are of darker-skinned individuals, and the model fails miserably, achieving only 50% accuracy on that subset.
So half the time, it's failing for that smaller group. Right. But if you calculate the overall aggregate average across all 10,000 images, your top-line accuracy is 94%.
You publish a model card claiming 94% overall accuracy, which sounds phenomenal. It does. But that aggregate number completely conceals the fact that your system is functionally broken for a specific subpopulation.
I love to use the hospital waiting room analogy to explain this to executives. Oh, that's a good one. Imagine a hospital puts up a giant billboard on the highway that says, Our average ER wait time is only 20 minutes.
It sounds incredibly efficient. But when you dig into their disaggregated data, you realize that patients who come in with minor paper cuts wait exactly 2 minutes, but patients who come in with complex, life-threatening injuries wait 10 hours. Wow.
Because the hospital sees a massive volume of paper cuts, the math averages out to 20 minutes. That is a perfect structural analogy. The 20-minute average is mathematically true, but it is functionally a lie.
It is dangerously misleading to the person who needs the system the most. And regulators are no longer falling for the billboard average. They understand the math, and they are writing laws to force disaggregation.
Exactly. Look at how New York City implemented Local Law 144, which regulates automated employment decision tools, basically, AI used in hiring and promotion. It went into effect in January 2023, and the city began strict enforcement in July of that year.
Walk us through the mechanics of that law. How did it force the issue? The law mandates that any employer using AI to screen candidates in New York City must subject that tool to an independent bias audit, and the results of that audit must be publicly posted on the employer's website. Publicly posted? Wow.
But the crucial mechanism of the law is how the audit must be conducted. The city didn't just ask for an overall fairness score, they mandated forced disaggregated disclosure. So they demanded the breakdown.
Yes. Auditors have to calculate the impact ratio, which is the selection rate of a protected group divided by the selection rate of the most favored group. And they have to publish that ratio broken down explicitly by specific sex categories and specific race and ethnicity categories.
I remember when this law took effect, it caused an absolute panic in HR departments and among vendor platforms. It was a reckoning. Employers who had already adopted the rigorous discipline of disaggregating their own data internally were well prepared.
The public audit merely confirmed what they already knew and had documented in their internal system cards. Right. But companies that had blindly trusted a vendor's glossy 95% fair aggregate metric saw their group level numbers exposed for the very first time on a public website.
They found out they were rejecting minority candidates at vastly disproportionate rates and they found out in public. It was incredibly damaging to their reputations. Disaggregate or mislead, if you do not break the numbers down, you do not actually know how your system works.
Okay. I want to pause and synthesize this because I am putting myself in the shoes of the listener right now. Okay.
I am hearing that I need to establish two distinct cards. I need to apply a brutal outsider test to delete all my marketing pros. I need to confess all my failure modes in public to appease discovery laws.
And I need to mathematically disaggregate all my metrics. That is the mandate, yes. But practically speaking, that sounds like an overwhelming monumental amount of new writing, testing, and creative drafting.
Where does an engineering team find the time to author all this new material? They don't. And that leads us to the efficiency secret of evidence engineering, which is our fifth core principle, assemble, do not invent. Assemble, do not invent.
How does that change the workflow? A rigorous audit-ready card is never written as fresh prose. You do not sit down with a blank word processor, stare at the blinking cursor, and start creatively typing out a narrative about how your system works. No.
If you are doing that, you are doing it wrong. And where did the words come from? You build the card strictly by extracting and assembling evidence you have already produced during the standard development and testing lifecycle. Ah, I see.
You pull the training details directly from your data provenance file. You pull the performance metrics directly from your evaluation lab reports. You pull the failure modes directly from your incident logs and red teaming spreadsheets.
You are merely assembling factual bullet points from technical artifacts that already exist in your repository. Let me clarify one of those terms for the listener. When you say data provenance file, what exactly are we talking about? A data provenance file is essentially a comprehensive nutritional label for the data sets you use to train or fine-tune the model.
It details the origin of the data, the licensing rights, how it was collected, what time period it covers, and known biases in the collection method. So if you claim your model is safe for a certain demographic, you just link to the data provenance file that proves you trained it on that demographic. Exactly.
The card is the index. The underlying artifacts are the proof. But let me argue from the perspective of a technical writer or a product marketer for a second.
Sure. Assembling bullet points from technical logs sounds incredibly dry and robotic. Wouldn't fresh polished, well-crafted prose read better to a procurement buyer? Don't we want to tell a compelling story about our technology? I had to shoot that down with extreme prejudice.
Wow. You absolutely do not want to tell a story. Fresh promotional prose actively hides gaps in your governance.
When you try to write a compelling narrative, human nature kicks in and you start smoothing over the rough edges. You start using those forbidden words like seamlessly and robustly. Precisely.
The assembly methodology acts as a diagnostic tool. If you are drafting a system card and you find yourself typing a claim, for instance, the system maintains high accuracy across diverse linguistic populations. But you realize you have no disaggregated evaluation report to cite as the source of that sentence.
You have to stop typing immediately. Because you can't assemble what you don't have. Exactly.
You haven't written a better card. You have either fabricated a claim out of thin air or you have just discovered a massive hole in your testing pipeline. The card's job is solely to communicate the evidence.
The evaluation report's job is to substantiate it. If there is no lab report, you cannot put the claim on the card. If there's no lab report, you can't put the nutrition label on the box.
That is a brilliant rule. And I imagine the assembly method also prevents these documents from becoming massive, unreadable encyclopedias. Yes.
It prevents the dreaded 30-page card. If your model card or system card is 30 pages long, you have failed the assignment. Too long.
You didn't write a card. You wrote a white paper. You must optimize the document for the two-minute decision.
Think back to our incident responder at 3 a.m. They need to scan this document in 120 seconds, understand the dependencies, see the failure modes, and know exactly what to do, bullet points, bold headers, tables, and links to the deeper artifacts. All right. So let's say a team follows this process perfectly.
They extract the artifacts. They assemble a concise, honest, disaggregated card. They deploy the system into production, and they attach the card to the release.
Three months pass. The system is out in the wild, processing real user data. Is their perfect card still accurate? Not if they ignore the final fundamental rule of our spine.
Which brings us to the sixth principle. A card must be living. A card must be living.
Because if it is a static PDF, it is a liability. If it is static, it is dangerous. AI systems are not static software.
They are dynamic, non-deterministic entities operating in environments that constantly shift. Your documentation must mirror that reality. What are the actual mechanical components that make a document living? What do I need to implement in my CICD pipeline? Four mandatory components.
First, an as-of-date, placed prominently at the very top of the document. Not the date it was originally published, the date the evidence was last verified. Second, a strict semantic version number, like V2.1.4. Third, a detailed changelog that explains exactly what underlying components or metrics were altered since the last version.
And fourth, a predefined list of review triggers. Review triggers, you mean specific events that force the governance team to update the card. Exactly.
You don't just update the card when you feel like it. You define triggers in advance. For example, if we retrain the model weights, we trigger a card review.
If our third-party API vendor updates their base model, we trigger a review. Makes sense. If a new data privacy regulation passes in our jurisdiction, we trigger a review.
If our incident monitoring detects a new, unexpected failure mode in production, we trigger a review. When a trigger hits, the evaluations are rerun, the numbers are updated, and the version is bumped. This reminds me of the classic copy-and-paste trap that I see engineering teams fall into all the time.
Oh yeah, it happens constantly. They roll out an update to their retrieval database, or they tweak the system prompt, they call it version 2.0. And then they just copy the system card from version 1.0, paste it into the new repository, change the date at the top to today, and call the documentation done. That is one of the fastest ways for a professional to publish a confident, mathematically provable lie.
Really? When you merely change the date without rerunning the evaluations and updating the disaggregated metrics, you are backdating a safety claim that you haven't actually rechecked. The new version of your system might have entirely different failure modes or a completely altered impact ratio. Which brings us in a perfect circle right back to our anchor hook, the summer 2023 GPT-4 behavior drift case.
Let's apply this principle to that exact historical moment. Okay, let's do it. If the vendor had shipped that June model update with a simple living changelog on their model card that stated, you know, version 2.0, conversational formatting altered, prime number arithmetic logic modified, see updated evaluation metrics below what would have happened.
The outcome for the industry would have been completely different. Every downstream integrator would have received a clear, actionable signal. The developer running the medical triage bot would have read that changelog and known immediately.
The underlying engine's logic has changed. I need to pause production and retest my system prompts. The disruption would still exist, yes, but it would have been managed and anticipated.
Because there was no changelog and no living card, it turned into a chaotic forensic investigation for everyone downstream. It makes you realize that an undated static card is actually worse than having no documentation at all. It is absolutely worse.
If a vendor gives you an undocumented model, you know you are flying blind. You know you have to test it yourself. You proceed with extreme caution.
But an undated, unversioned card carries the weight of institutional authority. It confidently tells the user a stale lie, giving them a false sense of security while they walk right off a cliff. And what triggers a card update more often than anything else, in a modern deployed system, it's almost always a change in the human workflows or the third-party models that make up your application layer.
Absolutely. Which moves us to the specific complexities of documenting the system card. Let's talk about the human element.
Human oversight is a massive part of the application layer. It is. And unfortunately, human oversight is one of the most falsely documented safeguards on system cards today.
We have to draw a hard line between nominal oversight and real oversight. Define the difference. What does nominal oversight look like? Nominal oversight is when you list a human as a safeguard on paper, but the mechanics of the workflow make it impossible for them to actually prevent harm.
Okay, give me an example. Let's say you list human review as a mitigation on your system card for an automated loan approval system. But in reality, the human only reviews a random sample of the decisions after the automated system has already executed the rejection and sent the email to the customer.
So the harm has already occurred. The human is just doing an autopsy. Exactly.
Or, let's say you have a human reviewer in the loop before the action is taken. But that human is a content moderator who is required to review a massive, complex document every five seconds to meet their daily quota. They're just clicking approve in a blur.
Right. If the human cannot realistically comprehend the context and intervene in time, that control cannot fire. It is nominal.
It exists on paper, but not in reality. What's its rule? The rule is this. If you have nominal oversight, you cannot list it as a mitigation or a safeguard on your system card.
You must mark it as a gap in your defenses. Documenting a safeguard that wouldn't actually protect anyone is worse than admitting the gap. Okay, what about vendor dependencies? Let's go back to our medical triage bot scenario.
I'm building this bot, and I'm using a vendor's general purpose API model. I go to the vendor and ask for their detailed model card, including their disaggregated failure mode, so I can cite it in my system card. And the vendor says, no, we can't give you that.
It exposes our proprietary trade secrets. We aren't legally obligated to tell you how our model works. A very common response.
So from a corporate perspective, if the vendor refuses to tell us, aren't we off the hook? Can't we just write vendor model used and wash our hands of the liability? Absolutely not. You can never outsource your accountability. If you deploy a system to the public, you are responsible for the system.
But I don't have access to their training data. I don't know the weights. How can I document what they refuse to share? You don't need to know their weights.
This is where the trade secret defense completely falls apart under scrutiny. Trade secrets legally protect internal mechanisms, the literal neural network weights, the proprietary training algorithms, the exact mixture of the training data. But trade secrets do not cover capabilities, limitations, and out-of-scope uses.
Give me an analogy for that. Think of a restaurant. A chef's signature sauce recipe is a trade secret.
They do not have to publish the exact ratios of the ingredients or their cooking techniques, but they are legally obligated to publish the allergen list on the menu. A customer doesn't need to know how to cook the sauce, but they absolutely need to know if it contains peanuts so they don't go into anaphylactic shock. That is a phenomenal way to put it.
The trade secret is the recipe. The model card is the allergen list. Exactly.
The vendor owes you the allergen list. So what do I actually write in my system card if the vendor stonewalls me and refuses to provide the allergen list? The vendor's model card is a critical dependency for your application layer. If it is missing, you must record that exact documentation gap in your own system card as a named explicit supplier risk.
Wrong, exactly. You're right. Base model documentation from the supplier is incomplete.
Capabilities, limitations, and out-of-scope uses are known only at the minimal level publicly disclosed by the vendor. This represents an open, unmitigated supplier risk. You name the gap in ink.
Wow. You just put the vendor on blast right there in the documentation. You have to, to protect your own organization.
And the reality is, this isn't just a best practice debate or an academic exercise anymore. The global legal framework is rapidly catching up to this exact dynamic. Which brings us to the regulatory bridge.
Because doing this card discipline right doesn't just make you a better engineer, it saves you from a massive bureaucratic and legal nightmare later. Let's talk about the European Union AI Act. This is the elephant in the room for anyone operating globally.
The EU AI Act is reshaping global governance. Specifically, we need to look at Article 53, which begins applying in full force from August 2, 2025. This article specifically regulates the providers of general purpose AI models, the massive foundation models.
What exactly does Article 53 mandate regarding documentation? It creates two massive obligations. First, the providers of these base models are legally required to maintain extensive internal technical documentation, which is detailed in Annex A of the Act. But much more importantly for our listeners, they must provide downstream integrators with comprehensive documentation of the model's capabilities and limitations.
That requirement is detailed in Annex 12. So if a vendor tries to give me the trade secret excuse and refuses to give me a model card, the EU AI Act literally gives me the legal backing to demand it. Exactly.
Annex 12 is, in substance, a legally mandated model card. Regulators realize that downstream providers, the companies building the application layer, cannot possibly be held accountable for system safety if they were supplied with undocumented, opaque engines. The law enforces the flow of information down the supply chain.
And it is not just the EU. This entire methodology maps directly onto the frameworks being adopted in the United States and globally. Let's look at the NIST AI Risk Management Framework.
The NIST AI RMF is the gold standard for U.S. governance right now. It is built around core functions, two of which are map and measure. Map is the process of establishing the context, the dependencies, and the boundaries of your system.
Measure is the process of rigorously assessing its performance, trustworthiness, and biases. And the cards we are building are the physical output of those functions. Yes.
Your system card is the map function made concrete. Your disaggregated metrics within the card are the measure function made concrete. The cards also align perfectly with ISO AES 42001, which is the international standard for AI management systems.
And that requires documentation too. That ISO standard explicitly expects organizations to maintain documented information across the entire AI lifecycle. So let me ask the golden question for any compliance officer listening right now.
If I build these two cards perfectly and I maintain them as leading documents, am I fully covered? Does this make my system compliant with the EU, NIST, and ISO? I have to issue a massive caveat there. You should never ever claim that a single card makes you compliant. A card is not a get-out-of-jail-free certificate.
Compliance is a holistic organizational state. It involves continuous risk management, data governance, conformity assessments, and legal review. So if the card isn't a compliance certificate, what is it, legally speaking? It is a shared evidence layer.
It is the human readable spine that all of these different compliance obligations draw from. By maintaining one rigorous, honest, disaggregated card set, you save your engineering team from having to maintain four separate contradictory compliance PDFs in a drawer somewhere. Right.
That sounds much better. When the auditor comes knocking, whether they're from the EU, a federal agency, or an internal risk committee, one accurate version card set is your front door. Okay, we have covered an incredible amount of theory, legal frameworks, and structural mechanics today.
I want to ground everything we've talked about. Let's look at exactly what this looks like in the real world for a professional trying to navigate these rules on a tight deadline. Let's walk through a comprehensive scenario.
Let's introduce Elizabeth. Elizabeth is the AI governance lead at a fictional mid-sized insurance company called Northwind Mutual. She is responsible for overseeing a newly deployed claims triage assistant.
Let's map Elizabeth's application layer so we know exactly what we're dealing with. She is using a top-tier vendor's general purpose language model as her engine. She takes that raw model and wraps it in Northwind's internal retrieval system, a RAG database filled with Northwind's proprietary claims manuals and historical policy data.
She adds a strict system prompt instructing the model on how to categorize claims. Sounds like a solid setup. It is.
She adds an output filter to catch any hallucinated policy terms. And critically, she establishes a human adjuster workflow where any claim the AI flags as complex is routed to a human expert. So it's a robust system.
And here's the inciting incident. A major reinsurer, a downstream business partner whose financial backing Northwind relies on, comes to Elizabeth and says, we want to integrate our systems with your claims triage output. But before we sign the contract, our compliance team needs to see your model card and your system card to assess your risk maturity.
So Elizabeth is on a tight deadline to secure the deal. She opens her internal repository and pulls up a two-page spec sheet that her engineering team wrote six months ago when they initially got internal sign-off for the project. She begins to apply the outsider test.
Let's look at the actual text here. She reads the very first sentence of the old spec sheet. It says, the Northwind claims assistant uses advanced AI to accurately triage inbound customer claims.
And Elizabeth immediately strikes a red line right through it. Why? I mean, it sounds good. Because it completely fails the outsider test.
The reinsurer's compliance officer is the outsider. What decision does the word advanced help them make? None, really. Nothing.
It is subjective marketing fluff. What does accurately mean? Is it 70% accurate? 99%. Across what demographics? It lacks a hard metric, it lacks a date, and it lacks disaggregated boundaries.
It is a useless sentence. So how does she rewrite it to pass the test? She rewrites the intended use to be brutally precise and testable. Instead of accurately triages claims, she writes, the system is designed exclusively for classifying inbound property claim descriptions into two categories, routine and complex.
It is designed for use by internal Northwind adjusters operating solely on English language test inputs. And then she explicitly adds the out-of-scope uses, the honest bad news. Yes.
She writes, out-of-scope, the system is not validated for medical or liability claims. It is not validated for non-English claims. The system is strictly prohibited from executing automated claim denials without human review.
Now the reinsurer knows exactly where the boundaries of the technology are, but as Elizabeth is assembling the component section of the system card, she catches a massive, terrifying gap. Right. She is mapping the dependencies, and she checks the API logs for the vendor model they are using as the engine.
She realizes that the vendor silently updated the base model to a new version five weeks ago. Oh, wow. And Northwind's engineering team hasn't rerun their internal system evaluations since that update happened.
Which means Northwind's entire deployed system is currently running on a different mathematical engine than the one they initially tested and validated. The ground shifted and they didn't map it. So what does Elizabeth do here? She needs this contract signed.
The pressure from her sales team is intense. Does she just omit the date of the vendor update, hand over the card, and hope the reinsurer doesn't ask too many technical questions? This is the critical move. This is the moment that separates a professional evidence engineer from a marketer trying to cover their tracks.
Elizabeth chooses diligence over concealment. Right. Instead of hiding it, she writes the gap directly into the system card, under the monitoring and evaluation section.
What does she write exactly? She writes, dependency alert. The underlying vendor base model was updated by the supplier five weeks ago. Northwind's system level evaluation predates this vendor update.
Until the scheduled reevaluation cycle completes next week, the triage output for complex claim detection should be treated as unvalidated against the current model version, and human review protocols must remain in full effect. I can vividly imagine her sales director reading over her shoulder and absolutely panicking, like, Elizabeth, you are tanking the deal. You are making us look incompetent.
The reinsurer is going to walk away if they see the word unvalidated. And Elizabeth's realization of the defense she gives to her sales director is the core philosophy of this entire discipline. She tells him, a broad, confident claim that we cannot back up with hard evidence is the very first thing an auditor breaks.
Absolutely true. If they find out we lied by omission, they will never trust our data again. But a narrow, documented claim that we can definitively prove is worth infinitely more.
It proves our governance actually works. And what happens when she sends the card to the reinsurer? The reinsurer's compliance officer receives the card. They see the brutally honest intended ORSH boundaries, they see the disaggregated metrics, and they see the caveat about the untested vendor update.
And they immediately trust Northwind Mutual. They trust them because Northwind told them the honest bad news before they had to discover it themselves. Exactly.
The compliance officer replies, your governance maturity is exceptional. We appreciate the transparency regarding the vendor drift. We will proceed with the contract integration as soon as your internal re-evaluation metrics land.
That level of rigorous, uncomfortable honesty is what builds unshakable institutional trust. It is the razor-thin difference between demonstrating diligence and executing a cover-up. The technical facts were identical.
The words describing the vendor update were the same. But authorship is everything. Let's synthesize the journey we've taken today.
Because this has been a profound shift in how we approach the administration of AI. We started by drawing a hard line between the raw model and the deployed system, separating the engine from the car, because the application layer is where the real-world harm is introduced and mitigated. We established that you need two distinct documents to track this duality.
We ruthlessly applied the outsider test, stripping away marketing fluff and demanding actionable precision. We learned the hard truth that honesty is load-bearing, and that hiding failure modes is a guaranteed path to legal and regulatory disaster. We explored the mechanics of averages, proving that you must mathematically disaggregate your data to reveal minority failures, or you are actively misleading your users.
We changed our writing workflow, assembling our cards from hard, existing technical artifacts rather than inventing fresh prose. And finally, we ensured that these documents stay alive with version numbers, dates, and strict review triggers so they don't rot into confident lies. It fundamentally changes documentation from an administrative afterthought into the operational front door of your entire risk and evidence architecture.
On this show, we always leave you with an actionable, immediate step. The Monday morning move. Based on everything we have covered, what is the single most valuable action our listeners should take when they log in to work on Monday? First thing Monday morning, before you answer an email or look at a dashboard, pull up the internal documentation for the single most critical AI system your team relies on.
The one that keeps you up at night. Right. I want you to apply the outsider test to just the very first paragraph of that document.
Just the first paragraph. Identify specifically who is reading it, an incident responder, an auditor, a downstream engineer, and ask yourself what concrete, high-stakes decision that paragraph allows them to make without you in the room. If you find that the paragraph is just subjective marketing fluff, if it uses words like seamless or advanced, strike a red line right through it.
And replace it by writing down one specific thing the system cannot do, find your boundaries and state them plainly in ink. That is a phenomenal clarifying exercise. As we wrap up this deep dive, I want to leave you with a final thought to mull over.
Throughout this conversation, we have talked about the murky waters of AI, the shifting sand of vendor updates, the invisible changes that break critical infrastructure. The natural human instinct when you are navigating murky waters, especially in a corporate environment, is to pretend you have a perfect map. It is to project absolute confidence and hide the flaws.
But in the era of AI governance, perfection is an illusion that independent auditors and regulators are eager to shatter. Remember this, the disaggregated metric or the out-of-scope limitation that embarrasses you internally today is the exact same metric that protects you legally tomorrow. The words describing the failure are exactly the same.
Authorship is everything. Write your own map, mark the dragons clearly, and you will never fly blind again.
Real cases
These examples show model and system documentation working, and failing, in real settings. Details are attributed; where a specific figure would be invented, it is left out.
Example 1: The behavior-drift study (the anchor). Chen, Zaharia, and Zou compared the March 2023 and June 2023 releases of GPT-4 and GPT-3.5 on tasks including math, sensitive questions, code generation, and visual reasoning ("How Is ChatGPT's Behavior Changing over Time?", arXiv:2307.09009, 2023). They reported large swings, including GPT-4's accuracy on identifying prime numbers falling from about 84 percent to about 51 percent between the two versions. Other researchers, including Arvind Narayanan and Sayash Kapoor, noted that part of the effect reflected a change in the model's answer formatting rather than pure capability loss, and that the test set structure amplified the appearance of collapse. Both things are true, and the governance lesson holds regardless of which interpretation you favor: the deployed behavior of a named product changed under its users, no living document recorded the change, and the users had to reverse-engineer it after the fact. A versioned system card with a changelog is the artifact whose absence made the whole episode possible.
Example 2: Google's model card practice. Following the 2019 proposal, Google published model cards for some released models, including face detection and object detection models, presenting intended use, limitations, and performance disaggregated across groups such as skin tone and age. The value was not the numbers looking good. It was that an outsider could see, before integrating, that performance varied across groups and could decide accordingly. That is the outsider test passing: the card changed a downstream decision.
Example 3: OpenAI and Anthropic system cards. OpenAI's GPT-4 System Card (March 2023) and subsequent system cards for later models documented red-team findings, categories of risk, mitigations applied, and residual risk after mitigation. Anthropic has published model cards for its Claude models covering intended uses, evaluations, and safety testing. The pattern that matters for you: these documents state the bad news, the things the system can still be made to do wrong after safety work, because a system card that only listed successes would tell an integrator nothing they could act on.
Example 4: Hugging Face and the documentation-by-default move. The Hugging Face model hub attaches a model card (a structured README with a standardized metadata block) to hosted models, and prompts uploaders to fill in intended use, limitations, bias, and training data. Millions of models carry at least a skeleton card as a result. The lesson is about defaults: when the card is part of the publishing workflow rather than an afterthought, documentation coverage rises sharply. When you build your own internal model registry, make the card a required field, not an optional one.
Example 5: The vendor who would not give you a card. A common real situation, drawn from procurement practice rather than a single named incident: an organization wants to deploy a general-purpose AI model from a vendor into a customer-facing system, and asks for the model's documentation of capabilities, limitations, and training-data summary. The vendor declines, citing trade secrets. Under the EU AI Act, a general-purpose AI model provider owes downstream integrators the Annex XII information (while protecting genuine trade secrets), and a provider of a systemic-risk model owes more. The absence of a usable model card is itself a governance finding: it means you cannot write an honest system card, because a component of your system is undocumented. The correct move is to record that gap in your own system card as a known limitation and a supplier risk, not to paper over it.
Example 6: The medical AI with a narrow validation and a broad deployment. Across health-AI literature, a recurring failure pattern is a model validated on data from a small number of hospitals or one imaging device, then deployed across many sites with different populations and different equipment. The model card's factors and evaluation-data sections exist precisely to catch this: if the card honestly states "validated on data from three hospitals using one manufacturer's scanner," a downstream site with a different scanner and population knows immediately that its use is outside the validated conditions. When that line is missing from the card, the mismatch is discovered only after the errors accumulate on real patients. The card is the difference between a boundary that is stated and a boundary that is crossed blindly.
Example 7: The EU AI Act turning cards into law. The move from voluntary practice to legal obligation is not hypothetical. The EU AI Act's general-purpose AI model rules require providers to draw up and keep up to date technical documentation (Annex XI) and to give downstream integrators documentation of the model's capabilities and limitations (Annex XII), with these obligations applying from 2 August 2025 (Regulation (EU) 2024/1689). In substance, the law now mandates a model card for general-purpose models. The lesson for you is that building the card habit before you are legally required to is far cheaper than reconstructing documentation under enforcement pressure, and organizations that already document by default absorbed this obligation as routine rather than as a scramble.
Example 8: The disaggregated audit that a card would have pre-empted. New York City's Local Law 144 requires an annual independent bias audit of automated employment decision tools, with the results posted publicly (a 2021 law, in effect since January 2023 and enforced from July 2023). The published audits are, in effect, forced disaggregated results: selection rates broken down by sex and by race-ethnicity groups. Where employers had already maintained honest model cards with disaggregated performance, the audit confirmed what they already knew and documented. Where they had not, the audit was the first time anyone saw the group-level numbers, sometimes uncomfortably in public. The card is the difference between finding your own disaggregated results in private, on your schedule, and having a mandatory audit surface them for you.
Example 9: The changelog that turned a scramble into a routine. Consider the contrast the behavior-drift study sets up, applied to a well-run team. When a provider ships a new model version accompanied by a system card update and a changelog that says, in plain words, "arithmetic and formatting behavior changed; see revised metrics," every downstream integrator receives a signal to re-test the specific behaviors that moved. The change is still disruptive, but it is a managed disruption: integrators know what to check and when. The 2023 episode was the opposite, a silent change discovered by outside researchers months later. The lesson is not that models should never change, they must, but that a change without a changelog converts a routine version bump into a forensic investigation for everyone downstream. The changelog is cheap; its absence is what makes the drift expensive.
Where people go wrong
- "A model card and a system card are the same thing." They are not. The model card documents the trained model in isolation, its capabilities, training, and measured performance. The system card documents the deployed system, the model plus the prompt, retrieval, filters, human review, and deployment context. Most real harm comes from the application layer, which the model card cannot describe. If you deployed anything, you owe both.
- "The card is a marketing document." The fastest way to make a card worthless is to write it to impress. A card exists to help an outsider make a decision, and marketing language helps no one decide anything. If a sentence would fit in a sales deck, it probably fails the outsider test. Comms can write the brochure. Engineering and governance write the card.
- "We can skip the out-of-scope section." The out-of-scope section is the part with the most governance value, because a model safe for one use is often dangerous for another. Omitting it does not make the dangerous uses safe, it just means an integrator finds the boundary by crossing it. Naming out-of-scope uses is how you keep your model from being deployed into a context you never validated.
- "Overall accuracy is enough." A single aggregate number is exactly what model cards were invented to fix. A model that is 90 percent accurate overall can be 60 percent accurate for one group or one condition. Report performance disaggregated across the factors you named. The number that embarrasses you is the one the card exists to carry.
- "We wrote it once, so we are done." A card that stops matching the system is worse than no card, because it carries your authority while telling a lie. Systems change: models get retrained, vendors push updates, retrieval indexes shift, prompts get edited. Every card needs a date, a version, a changelog, and a review-by trigger list. The behavior-drift study is the standing proof that "once" is not enough.
- "Trade secrets mean we cannot document anything." Documentation and confidentiality coexist. You can state capabilities, limitations, intended use, evaluation conditions, and known failure modes without exposing proprietary weights or training internals. The EU AI Act's downstream-documentation duty is explicitly framed to protect trade secrets while still requiring enough for integrators to understand capabilities and limitations. "Trade secret" is not a valid reason to ship a card with no out-of-scope section.
- "If we do not write the bad news, it is not there." The failure mode exists whether or not you document it. Not writing it down does not remove it; it just guarantees that whoever finds it, an auditor, an incident responder, a harmed user, finds it without your framing and without evidence that you looked. A caveat you wrote is diligence. The same fact discovered by someone else is concealment.
- "Our vendor's model card is our problem solved." If you deploy a system around someone else's model, their model card is a dependency of your system card, not a substitute for it. You still owe a system card for what you built around their model, and if their model card is missing or thin, that gap belongs in your system card as a named supplier risk.
- "Benchmark numbers speak for themselves." A metric with no evaluation conditions is close to meaningless. A number needs the test set, the date, the version, and the definition of the metric attached, or a reader cannot tell whether it applies to their situation. An impressive number on an unstated benchmark is a red flag to a good auditor, not a reassurance.
- "A longer card is a better card." Length is not thoroughness. A thirty-page card is usually a report wearing a card's name, and no outsider will read it in the moment they need to decide. The card is the summary that points to the underlying artifacts; the detail lives in the evaluation report, the provenance file, and the logs. Optimize the card for the two-minute decision, not for the appearance of effort.
- "We can copy last quarter's card for the new version." Copying an old card onto a new model version and changing the date is the fastest way to publish a confident lie. If the model changed, the metrics, factors, and failure modes may all have changed with it, and the behavior-drift study is the standing proof that they can move sharply. A new version demands re-evaluation and a genuine changelog entry, not a find-and-replace on the version number.
- "The card is the governance team's job, not engineering's." A card written by people who did not build or evaluate the system will be vague where it matters, because the load-bearing content (real failure modes, actual evaluation conditions, the honest oversight gaps) lives in the heads and artifacts of the people who did the work. Governance can own the structure and the outsider test; engineering must supply the substance. A card written entirely by one side without the other is either accurate but unreadable or readable but wrong.
Questions people ask
- What is model card?
- A short, structured document that travels with a trained model and states, in plain language, what the model is, what it is for, where it works, where it fails, and how that is known. Introduced formally by Mitchell and colleagues (2019). Covers model details, intended and out-of-scope use, factors, metrics, evaluation and training data, disaggregated results, and caveats. More on Model card
- What is system card?
- A document describing a deployed AI system rather than a single model: the model or models plus the application layer of prompts, retrieval, filters, human oversight, and deployment context. It documents what the deployed system actually does, which is a narrower and different thing from what the underlying model can do. More on System card
- What is application layer?
- Everything wrapped around a model in a deployed system: system prompts or instructions, retrieval, input and output filters, human review steps, rate limits, and usage policy. The application layer determines the gap between a model's raw capabilities and the deployed system's actual behavior, and it is documented by the system card, not the model card.
- What is outsider test?
- The standard by which a card is judged. Name the specific outside reader (integrator, auditor, incident responder, buyer, or future maintainer), name the decision they must make, and check that the card lets them make it correctly without the author present. A sentence that helps no outsider decide anything does not belong in the card. More on Outsider test
- What is out-of-scope use?
- The uses, contexts, populations, and conditions for which a model or system was not validated and should not be relied on. The out-of-scope statement is the highest-governance-value section of a card, because a model safe for one use is often dangerous for another.
Keep going
This lesson builds Explainability, transparency and contestability, and that page shows the roles that hire for it. Every Certified AI Governance Professional (CAIGP) lesson.