Notice. Illustration and research prototype. Not clinically validated, not a medical device, not for patient care. Example data are fictional.
Live demonstration. The sliders and test cases work — every score recomputes in your browser. The data is generated, no patient is involved, and nothing here has been verified by a clinician.

aki.yaml

Configuration · aki.yaml · 214 lines · editable in place

ACUTE KIDNEY INJURY — staging and nephrotoxin stewardship ============================================================================ Idea 04 in the register. Deterministic: KDIGO staging computed continuously, plus a nephrotoxin burden count with named substitutions.

WHY DETERMINISTIC RATHER THAN PREDICTIVE ---------------------------------------- The value of knowing AKI is coming is that nephrotoxic drugs and fluid strategy can still be changed. But the actionable part — which drugs this patient is on, whether the combination is avoidable, whether the dose fits the current clearance — needs no forecast at all. It is a list and a lookup, recomputed as the creatinine moves.

The two things a human does badly here are exactly the two a machine does without effort: tracking a creatinine ratio against a baseline that keeps changing, and holding a drug list against a nephrotoxin table at 3 AM.

Sources: KDIGO Clinical Practice Guideline for Acute Kidney Injury, 2012. Vancomycin + piperacillin-tazobactam nephrotoxicity: JAC-AMR 2024; Clin Infect Dis 2017. Taiwan AKI Task Force consensus on nephrotoxins.

meta
version0.1.0
ownerUNASSIGNED — set to the responsible clinician
last clinical reviewnot set
verified bynot set
note
KDIGO 2012 remains the published standard; a 2026 guideline is in public
review draft. Thresholds below follow 2012 and should be rechecked when
the new guideline is final.
staging
detection
creatinine absolute rise mg dl0.3
within 48h
creatinine absolute window hours48
creatinine ratio1.5
within 7 days
creatinine ratio window hours168
urine ml kg hr0.5
urine sustained hours6
stages
- stage1
creatinine ratio[1.5, 1.9]
creatinine absolute rise mg dl0.3
urine ml kg hr0.5
urine hours[6, 12]
- stage2
creatinine ratio[2.0, 2.9]
urine ml kg hr0.5
urine hours[12, 24]
- stage3
creatinine ratio3.0
creatinine absolute mg dl4.0
urine ml kg hr0.3
urine hours24
anuria hours12
or rrt startedtrue
baseline
methodlowest_in_prior_7_days
How the reference creatinine is established. Getting this wrong makes every ratio wrong — a patient admitted already injured has no clean baseline, and using their admission value hides the injury entirely.
fallbackadmission_value
warn when no baselinetrue
nephrotoxins
- drugvancomycin
classantibiotic
riskhigh
noteDose-dependent. Trough monitoring reduces risk.
substituteTeicoplanin or daptomycin in high-risk patients
- drugpiperacillin-tazobactam
classantibiotic
riskmoderate
note
Alone, moderate. Combined with vancomycin the risk is substantially
higher — see combinations below.
substituteCefepime, where the spectrum allows
- drugaminoglycoside
classantibiotic
riskhigh
noteDose-dependent and cumulative.
aliases[gentamicin, amikacin, tobramycin, streptomycin, netilmicin]
substituteNon-aminoglycoside cover where the organism permits
- drugamphotericin-b-deoxycholate
classantifungal
riskhigh
substituteLiposomal amphotericin, or an echinocandin
- drugnsaid
classanalgesic
riskhigh
noteRarely necessary in a critically ill patient.
aliases[ibuprofen, diclofenac, ketorolac, naproxen, indomethacin,
aceclofenac, etoricoxib]
substituteParacetamol or opioid analgesia
- drugiv-contrast
classimaging
riskmoderate
note
Independent risk factor, and additive with other nephrotoxins. Named
explicitly because it is ordered by a different team from the one
prescribing.
substituteNon-contrast imaging or ultrasound where the question allows
- drugace-inhibitor
classcardiovascular
riskmoderate
noteReduces glomerular filtration pressure. Usually held in AKI.
aliases[ramipril, enalapril, lisinopril, perindopril, captopril]
substituteHold during acute illness
- drugarb
classcardiovascular
riskmoderate
aliases[losartan, telmisartan, valsartan, olmesartan, irbesartan]
substituteHold during acute illness
- drugdiuretic
classcardiovascular
riskmoderate
noteVolume depletion worsens pre-renal injury.
aliases[furosemide, frusemide, torsemide, bumetanide,
hydrochlorothiazide, indapamide, metolazone]
substituteReassess volume status before continuing
- drugcalcineurin-inhibitor
classimmunosuppressant
riskhigh
noteLevel-dependent.
aliases[tacrolimus, ciclosporin, cyclosporine]
substituteLevel-guided dose reduction
combinations
- drugs[vancomycin, piperacillin-tazobactam]
odds ratio aki1.4
odds ratio dialysis1.3
comparatorvancomycin + cefepime
action
Consider substituting cefepime for piperacillin-tazobactam where the
spectrum allows. If the combination is continued, monitor vancomycin
trough and renal function daily, avoid IV contrast, and maintain
hydration.
sourceJAC-Antimicrob Resist 2024; Clin Infect Dis 2017
dose review
trigger on creatinine rise ratio1.5
trigger on stage changetrue
drugs requiring review
vancomycin
aminoglycoside
piperacillin-tazobactam
meropenem
fluconazole
enoxaparin
digoxin
metformin
note
Flags the drug for review against current clearance. Does not compute a
dose — that requires the unit's own protocol and pharmacy input.
alerting
alert on stage changetrue
alert on new nephrotoxin when akitrue
alert on high risk combinationtrue
silence hours same alert12
standing note
A prompt to review, not an instruction. Clinical judgement governs, and
the reason for continuing a named drug should be recorded.