Artifact critiqueAdvancedShipping & Model Lifecycle / Incident management for AI products / #2

Write the severity definitions for AI quality incidents.

The direct answer
Set four severity tiers, ranked by how hard the damage is to undo, not by how often the error happens or how wrong the text sounds. Sev-1 is a wrong or made-up clinical fact that lands in a field another system reads and acts on without a person looking first, allergy lists, medication orders, structured lab values. Sev-2 is the same kind of fact, caught before it's signed. Sev-3 is a wrong or missing detail in plain narrative text, nothing downstream reads it automatically. Sev-4 is a formatting or wording problem with no factual error in it at all.
Do this, in order
  1. Rank tiers by what's hardest to undo once it's out, not by how common or how obviously wrong the error is.Why: a rare, quiet error in a field a machine reads on its own can cause harm before any person gets a chance to catch it, while a common, glaring error in plain text gets caught and fixed the moment someone reads the note.
  2. Before ranking anything, map which fields feed a downstream action with no human step in between.Why: severity depends on what happens next to the field, not on how the error looks; the same wrong word means nothing in one field and triggers a pharmacy order in another.
  3. Set Sev-1 as: a fabricated or wrong clinical fact that reaches a field an automated system acts on, before a clinician reviews it.Why: this is the one category where the harm can happen to the patient before anyone at the hospital even knows there was an error.
  4. Set the response clock by tier, not by a single hospital-wide SLA.Why: a Sev-1 needs a same-day model or workflow fix; a Sev-4 can sit in a weekly backlog without costing anyone anything.
  5. Score each tier against a signed-note audit, not the model's own confidence number.Why: a confident, fluent, fabricated sentence and a correct one look identical on a confidence score; only checking real signed notes against the field they landed in tells you which tier an error actually belongs to.
  6. Leave formatting, tone, and phrasing issues out of the incident scale entirely.Why: folding cosmetic complaints into the same ladder as patient-safety errors buries the Sev-1 queue under noise nobody needs to treat as an incident.

How to answer this, stage by stage

Nobody is grading whether you can name four severity levels. They're grading whether your ranking rule survives a case where the rare error is the dangerous one and the common error is the harmless one. Six moves get you there.

1
Scope it to one real tool, one real hospital network
Say it like this
"Let's ground this. Silvermere Health runs fourteen hospitals and its ambient scribe, Fieldnote, drafts about 40,000 visit notes a week for around 900 doctors. Yordanos Bekele, who ran an ED for nine years before moving into product, owns the incident policy for it."
Why this works
Grounds the severity scale in a real volume before any tier gets defined.
2
Say the ranking rule out loud before naming a single tier
Say it like this
"Here's how I'd frame it. Severity isn't about how wrong the sentence sounds. It's about how hard the damage is to undo once it's out. So before I write tier one, I ask one question of every error type: does anything, a pharmacy system, an order set, a nurse's checklist, read this field and act on it without a person checking first?"
Why this works
States the ranking rule before a single tier, so the room hears a method, not a made-up list.
3
Walk the four tiers with a real field in each
Say it like this
"Sev-1: a made-up penicillin allergy or a wrong dose that lands in a structured field, gets signed, and reaches pharmacy before a doctor catches it. Sev-2: the same kind of fact, but a clinician catches it before signing. Sev-3: a wrong or missing detail in the plain narrative text, nothing downstream reads it on its own. Sev-4: a formatting or wording issue, no factual error at all."
Why this works
This is the R step, reversibility, walked through with a concrete field for each tier instead of a vague adjective.
4
Own the real numbers behind the ranking
Say it like this
"We pulled 1,200 signed notes and checked every field against the visit recording. Structured fields, the ones pharmacy and order sets read directly, had a fabricated or wrong entry in 0.4 percent of notes, about five notes. Plain narrative text had an error in 3.1 percent, about thirty-seven notes. The narrative errors are seven times more common. The structured ones are the Sev-1."
Why this works
This is the E step, real evidence with a stated source, not a guess dressed up as policy.
5
Name the dependency the policy can't skip
Say it like this
"None of this ranking works until you can actually tell, field by field, which parts of a note something else reads automatically. We didn't have that map on day one. We had a model confidence score instead, and that number can't tell you whether a sentence is in a paragraph nobody automates or a field the pharmacy reads at 2am."
Why this works
This is the D step, the thing that has to exist before the rank means anything at all.
6
Close on the one line, and the near miss that proved it
Say it like this
"So here's what I'd actually say: four tiers, ranked by what's hardest to undo, not by how the text reads. The rare structured-field fabrication outranks the common narrative typo every time, because one gets caught by a person reading, and the other one doesn't get read by a person at all before it acts."
Why this works
Closes on the rule itself, something a reader could apply to a system they've never seen, not just this one story.
If you remember one thing Two errors can look equally wrong on the page and belong in completely different tiers. What decides the tier is whether a person reads the field before anything acts on it, not how the sentence sounds.

Let's learn

Say we build a tool that listens to a doctor and patient talking, then drafts the visit note before the doctor leaves the room. Before a tool like this existed, doctors typed or dictated every note themselves, thorough, but it ate into evenings and weekends that should have belonged to their own lives.

Then Silvermere Health rolled out Fieldnote. About 900 doctors across fourteen hospitals started using it, and the average note went from twelve minutes of typing to about ninety seconds of review and sign-off. Doctors stopped writing notes from scratch and started reading a draft, fixing what needed fixing, and signing.

Knowledge spark: what's a structured field? A slot in the chart with a fixed meaning, like the allergy list or the medication order. Other software, pharmacy systems, order sets, alert engines, reads those fields directly and acts on them. Plain narrative text, the paragraph describing the visit, has no such reader. A person has to read it for anything to happen.

Now say plainly what the mistake was. The first severity policy Silvermere wrote ranked incidents by how wrong the model's own confidence score said a note was. A low-confidence note got flagged high severity. A high-confidence note, even a fabricated one written in a calm, fluent, medically plausible voice, got treated as low risk, because the model sounded sure of itself.

A confident, fluent, fabricated sentence and a correct one read identically on a confidence score. The score tells you how the model felt. It says nothing about what happens next.
The decision that mattered Stop ranking severity by the model's own confidence score. Rank it by whether the field the error lands in feeds an automated action with no person checking first. That's what actually decides how hard the damage is to undo.

At its worst, a fabricated allergy sits in a structured field, gets signed at the end of a fifteen-minute visit, and reaches the pharmacy's order-checking system before any human reads it as a sentence. A wrong plural in the assessment paragraph, by comparison, sits in front of the doctor's own eyes for the entire ninety seconds of review. One of these gets caught by a person almost every time. The other one might not.

Before any model update to Fieldnote ships, it has to clear a bar on a fixed golden set, 200 known structured-field facts pulled from real chart reviews, catching close to all of them, not a promise that it will always be right on every note. A model that clears that bar can still produce a fabrication in production. That is what a 99 percent bar looks like at scale, by design, and the tiered response is what protects the patient on the days it happens.

The choice I would take back. When the incident policy first got written, severity was scored off the model's own word-level confidence, an easy number to pull straight from the vendor's API, and it looked rigorous on a dashboard. It stopped making sense the moment the field-level audit showed the rare, quiet errors in structured fields were the ones nobody was reading before they acted.

There was a cheaper-looking fix on the table too: require a clinician to manually confirm every structured field before it can sync anywhere, on every single note. That would push the Sev-1 rate close to zero. It would also give back nearly all of the time Fieldnote was built to save, since the ninety-second review would balloon back toward the twelve minutes doctors used to spend typing. Silvermere didn't take that trade. It accepted a small, audited residual error rate in exchange for keeping the fast review, and put the safety margin into same-day escalation instead of upfront friction.

What I would leave alone. A wrong verb tense, an awkward sentence, a slightly clumsy summary in the narrative paragraph, none of that belongs on the incident scale at all. It costs a doctor two seconds to fix while reading, and folding it into the same ladder as a fabricated allergy just buries the tier that actually needs same-day attention.

The lesson. A severity scale built around how wrong something sounds will always underrate the error nobody gets a chance to hear.

Now here is the same thing as a story

The short version is above. Read on if you want to feel how close the confidence-score policy came to missing the one that mattered.

Yordanos Bekele ran the emergency department at a Silvermere hospital for nine years before she moved into product. She still reads a chart the way a charge nurse does, looking for the one line that changes what happens next, not the line that looks the messiest.

Fieldnote had been live for fourteen months when the incident policy Yordanos inherited still scored severity off the model's own confidence number. It was simple, it was already in the API response, and for most of that year it worked fine, because most errors that showed up were exactly what you'd expect: a garbled sentence here, a misheard word there, always sitting in the narrative paragraph, always caught by the doctor reading it before signing.

Then, on an ordinary Thursday afternoon, a resident finished a fifteen-minute visit, skimmed the Fieldnote draft, and signed it. The structured allergy field now read "penicillin, confirmed by patient." The patient had never said that. Fieldnote had picked up a stray mention of a cousin's penicillin reaction earlier in the recording and attached it to the wrong person.

The model's confidence score on that note was high. The sentence was fluent, specific, and calmly worded. Nothing about it looked like an error on a dashboard.

The note that should have scared everyone was the one that looked the most sure of itself.

The chart was already signed. The allergy field had already synced to the pharmacy's order-checking system. A nurse pulling up the patient's chart twenty minutes later to prep a follow-up prescription saw the allergy, paused, and asked the patient directly. The patient said she'd never had a reaction to anything. The nurse caught it by asking one extra question she didn't strictly have to ask.

Hand-sketched comparison titled Reversible or not. Left panel, a document icon labelled Narrative typo, caption clinician edits it, gone in seconds. Right panel, a solid red box labelled Signed chart entry, caption bolted shut once filed, feeds pharmacy on its own.
A narrative typo gets fixed the moment someone reads it. A signed structured-field entry is already acting on its own by the time anyone reads it as a sentence.

Yordanos pulled the incident log from the month before. Every flagged incident that quarter had been a narrative-text error, the kind a doctor fixes in the two seconds it takes to read a sentence. Not one structured-field error had ever been flagged, not because none had happened, because the confidence score never once dipped low enough to trip the policy's threshold on any of them.

She asked the informatics team to pull 1,200 signed notes and check every field against the actual visit recording. Structured fields, the ones pharmacy and order sets read directly, carried a fabricated or wrong entry in 0.4 percent of notes, five notes out of the twelve hundred. Plain narrative text carried an error in 3.1 percent, thirty-seven notes. The narrative errors were seven times more common, and every one of the five structured-field errors had scored high confidence.

What stayed with Yordanos was how close the original policy came to never flagging a single one of the five, quarter after quarter, simply because a fabricated sentence written with confidence looks exactly like a correct one to a score that only measures how sure the model is of its own words.

The redesigned policy now scores severity off two questions, not one: does this field feed an automated action with no person checking first, and did that happen before or after a clinician's own review. A fabricated allergy caught before sign-off is Sev-2, urgent, but reversible. The same fabrication reaching pharmacy after sign-off is Sev-1, same-day escalation, model rollback considered, and a same-day chart correction sent to every downstream system that already read it. Run that quarter's five structured-field errors back through the new policy and all five get flagged the day they're signed, hours after sign-off at worst, instead of one of them surfacing by chance because a nurse happened to ask an extra question.

The thing Yordanos would tell her past self, back when that first policy shipped: a number that tells you how sure the model felt was never going to tell you what the sentence was about to do.

ORDER, the five things behind the tiers

This is a ranking question, what makes one AI documentation error worse than another, not a story about a person's habit switching between two settings, so ORDER fits and FLIPS doesn't.

O, outcome. What every tier is competing to protect: whether a wrong or made-up clinical fact reaches a point where it drives an action on the patient before a human gets a chance to catch it. Not "how wrong the model was," a generic accuracy question that says nothing about consequence.
R, reversibility. Rank by how hard the resulting harm is to undo. A structured-field fabrication that's already synced to pharmacy is far harder to undo than a narrative typo a doctor fixes while reading, even though the typo shows up seven times more often.
D, dependency. Before any tier means anything, you need a map of which fields feed an automated downstream action with no person in between. Silvermere didn't have that map on day one; it had a confidence score, which measures something else entirely.
E, evidence. The 1,200-note field-level audit: 0.4 percent error rate in structured fields, 3.1 percent in narrative text, and every one of the five structured-field errors carried a high confidence score. Cheap to run, and it's what actually located the real Sev-1.
R, rank. Sev-1: fabricated or wrong fact in an automated-reading field, after sign-off. Sev-2: the same kind of fact, caught before sign-off. Sev-3: a wrong or missing narrative-only detail. Sev-4: formatting or wording, no factual error. Defend the top pick in one line: Sev-1 outranks everything else because it is the only tier where harm can reach the patient before the hospital knows an error happened.

Hand-sketched flow diagram titled What has to exist before a tier means anything, four boxes connected by arrows: Find the field, Who reads it (highlighted in red), Rank the tier, Set the clock.
Each box has to happen before the next one is trustworthy. Skipping straight to ranking without knowing who reads the field is how a confidence score ends up standing in for consequence.
Error rate by field type, 1,200 signed notes
Structured fields (allergy, meds, labs) that pharmacy and order sets read directly0.4% (5 notes)
Narrative-only text, nothing automated reads it3.1% (37 notes)
The rare error is the dangerous one. It happens seven times less often and outranks the common one on severity, because nothing catches it before it acts.
Sev-1
Wrong or made-up fact, in an automated-reading field, after sign-off.Same-day escalation. Model or workflow fix considered. Correction pushed to every downstream system that already read it.
Sev-2
Same kind of fact, caught before sign-off.Urgent review of that error type across recent notes. No downstream correction needed, because nothing outside the chart ever read it.
Sev-3
Wrong or missing detail, narrative text only.Logged and trended. No automated system reads narrative text, so the harm stops at the doctor's own review.
Sev-4
Formatting or wording issue, no factual error.Backlog item. Not an incident at all, tracked separately so it never competes with a Sev-1 for attention.

And if you want to be sure it really works, try it somewhere else

Amberline Power runs an AI tool that drafts outage and incident reports for its control room from radio chatter and sensor feeds, so dispatchers don't have to type up every call while a storm is still active.

O, outcome. What every tier competes to protect: whether a wrong report sends a repair crew somewhere unsafe, or clears an outage the public still can't see, before a dispatcher reviews it.
R, reversibility. A draft report that auto-populates the public outage map is far harder to undo once residents have already acted on it than a report still sitting in a dispatcher's review queue.
D, dependency. Amberline's PM, Talise Aluko, first had to map which report fields feed the public map and the crew dispatch queue automatically, versus which fields only a human dispatcher ever reads.
E, evidence. A review of 400 draft reports found the AI wrongly marked "no live wires down" in 0.5 percent of cases, always in the auto-published field, and mislabeled a minor equipment code in 4 percent of cases, always in a field a dispatcher edits before anything goes out.
R, rank. Sev-1: a wrong live-wire status reaching the auto-published map or a crew dispatch, before dispatcher review. Sev-2: the same error, caught first. Sev-3: a wrong equipment code in dispatcher-reviewed fields. Sev-4: report formatting.

Same shape, different stakes At Silvermere a missed structured-field error can hurt a patient. At Amberline it can send a crew toward a live wire, or tell residents power is back on when it isn't. The ranking rule doesn't change: whatever an automated system acts on without a person first is the top tier, no matter how rare it is.

Swap the trigger and it still runs.
Speed: an interviewer caps the answer at ninety seconds. Skip straight to the rule: rank by whether a field feeds an automated action with no person checking first, not by how often the error happens or how wrong it reads.
Cost: the informatics team can only run a small audit this quarter. Don't skip mapping which fields are automated to save time, that map is what makes every tier after it mean anything; shrink the sample size of the audit instead.
The model got better: Fieldnote's structured-field error rate drops to near zero next year. The four-tier scale doesn't get retired, it just gets checked less often, because the ranking rule, not the current error rate, is what makes it correct.

Where people run it wrong.
They rank severity by how often an error type happens, so the common, harmless one crowds out the rare, dangerous one.
They rank severity by the model's own confidence score, which measures how sure the model sounded, not what happens after.
They fold cosmetic wording issues into the same incident scale as patient-safety errors, so the Sev-1 queue drowns in noise nobody needs to treat as urgent.

How to use it live. Say the rule before naming a single tier: "severity here depends on how hard the damage is to undo, not on how wrong the text sounds, and that comes down to whether something acts on the error before a person reads it." That earns you the room to ask what actually gets automated in this specific product, instead of reciting four made-up labels.

Flashcards (click a card to flip it)

1 · THE FRAMEWORK
What framework fits "write the severity definitions for AI quality incidents," and why not FLIPS?
Tap to flip
ANSWER
ORDER. This is a ranking question, what makes one error worse than another, not a story about a person's habit flipping between two settings.
2 · THE PERSON
Who is this answer about?
Tap to flip
ANSWER
Yordanos Bekele, a former nine-year ED charge nurse turned product lead at Silvermere Health, who owns the incident policy for its ambient scribe, Fieldnote.
3 · WHAT THE FIRST POLICY GOT WRONG
What did the original severity policy score incidents by?
Tap to flip
ANSWER
The model's own confidence score. A fabricated, fluent sentence written with high confidence looked identical to a correct one, so it never once tripped the severity threshold.
4 · WHAT ACTUALLY DECIDES THE TIER
What's the real difference between a Sev-1 error and a Sev-3 error?
Tap to flip
ANSWER
Whether the field the error lands in feeds an automated downstream action with no person checking first (Sev-1) or sits in narrative text a clinician reads before anything happens (Sev-3). Not how wrong the text sounds.
5 · THE OLD DECISION
What decision would you take back, and why did it make sense at first?
Tap to flip
ANSWER
Scoring severity off the model's own confidence number. It made sense because the number was already sitting in the API and looked rigorous on a dashboard. It stopped making sense once the field-level audit showed every real structured-field error had scored high confidence.
6 · THE NUMBER
Fill in the blank: structured-field errors happened in ___% of signed notes, narrative-only errors happened in ___%, roughly ___ times more often.
Tap to flip
ANSWER
0.4% (structured fields), 3.1% (narrative text), about seven times more often. The rarer error is the one ranked Sev-1.
7 · THE REPLAY
Same near miss, new policy. What changes?
Tap to flip
ANSWER
Severity now scores off two questions: does the field feed an automated action, and did the error reach it before or after sign-off. The same fabricated allergy caught before signing is Sev-2; after signing and synced to pharmacy, it's Sev-1 with same-day escalation and a correction pushed to every system that already read it.
8 · CROSS-PRODUCT TRANSFER
Section 4 answers this same ranking question for a different product. Which product, and what's its version of the automated-reading field?
Tap to flip
ANSWER
Amberline Power's AI-drafted outage reports, run by Talise Aluko. Its highest-stakes field is the live-wire status that auto-populates the public outage map and crew dispatch queue.

Check yourself Score: 0 / 0

Multiple choice
1. Why does the rare structured-field error outrank the common narrative-text error, even though it happens seven times less often?
  • A. Rare errors are always harder for the model to fix than common ones.
  • B. The structured-field error reaches a system that acts on it automatically, before a person gets a chance to catch it. The narrative error gets read and fixed by the doctor first.
  • C. Structured fields are checked by a second AI model, so any error there is automatically more serious.
  • D. Doctors are legally required to read structured fields more carefully than narrative text.
Show hint
Think about who or what reads each field first, a person or a piece of software.
Show answer
B. Severity tracks whether the error gets a human check before it does anything, not how often it happens or how it was produced.
Fill in the blank
2. The audit of 1,200 signed notes found a fabricated or wrong entry in ___% of structured fields and ___% of narrative-only text.
Show hint
Check stage 4 of the walkthrough.
Show answer
0.4%; 3.1%. Five notes out of twelve hundred versus thirty-seven out of twelve hundred, and every one of the five carried a high confidence score.
True or false
3. True or false: scoring severity by the model's own confidence number was a reasonable-sounding choice when the policy was first written, not an obviously bad idea from the start.
  • True
  • False
Show hint
The story never suggests Yordanos or her team did anything foolish when they first wrote the policy.
Show answer
True. The confidence score was already available from the vendor's API, cost nothing extra to use, and for most of the year the errors it did catch were the ones that mattered. It only failed on the one category it could never see: a fabrication written with total confidence.
Short answer
4. Name a place in Fieldnote where a factual slip would NOT need its own severity tier at all. Why not?
Show hint
Look at what "what I would leave alone" says.
Show answer
Model answer: A wrong verb tense or a slightly clumsy sentence in the narrative summary. It costs the doctor two seconds to fix while reading before sign-off, nothing downstream ever reads it automatically, and treating it as an incident just buries the tier that actually needs same-day attention.
Short answer, apply it yourself
5. Think of an AI tool at your own job, or one you use, that produces some output automatically. What field or output of it feeds straight into another system with no person checking first, and what would a Sev-1 look like there?
Show hint
Look for the one output nobody reads before something else acts on it.
Show answer
Model answer: An AI expense-categorization tool where the category field feeds straight into automated approval routing. A Sev-1 there is a personal expense mis-tagged as a reimbursable category and auto-approved above a threshold that skips manager review, not a report with the wrong date format on it.
Short answer, the number question
6. If Fieldnote's overall error rate stayed exactly the same but the hospital turned off the pharmacy auto-sync on structured fields, so a person always reviewed them before anything acted, would the four-tier ranking still be correct? Why or why not?
Show hint
Reread the outcome step: what does severity actually track.
Show answer
No, it would need re-ranking. Severity tracks whether a person checks the field before something acts on it, not the error rate itself. Turning off the auto-sync means a person now reviews the structured fields too, so the old Sev-1 category would drop to something closer to Sev-2, caught before it can cause harm, even though the underlying model hasn't changed at all.
Before you close the answer
Why this works
Tests whether you rank incidents by consequence or by how alarming the error looks. Most candidates build a severity scale around how far off the model's output was from the truth; the strong answer recognizes that two equally wrong outputs can sit in completely different tiers depending on what reads the field next.
Follow-up traps
"Isn't a 0.4 percent error rate too rare to build a whole severity tier around?" Response: severity depends on what happens when it occurs, not on frequency; a rare event that reaches the patient before anyone can catch it needs a same-day response plan precisely because it's rare enough that nobody's watching for it.

"Couldn't you just make the model more confident about the fields that matter, instead of building a whole field map?" Response: confidence measures how sure the model is of its own words, not whether a downstream system reads that field automatically; a more confident model can still fabricate fluently, which is exactly what the near miss showed.
If pressed
The field map itself isn't static. Every time Silvermere connects a new downstream system, say a new pharmacy vendor, to read a chart field automatically, that field gets re-evaluated for tier eligibility before the integration goes live, not after the first incident from it.
From U2xAI Academy

From answering questions to owning outcomes.

A live workshop where you ship a working AI agent, defend a launch decision, and walk away with a portfolio recruiters can't wave off, not just more questions to study.

  • A live AI agent you actually shipped
  • A launch decision you can defend under pressure
  • An interview-ready portfolio, not more flashcards
Know more