Skip to main content
DataCrafters synthetic data · demonstration

Staff surface Definitions and reviews

Definition library

Every executable definition, side-panel definition and catalogue entry, in three groups by the licence of its source, with its threshold in our own words and the source it is cited to. All are drafts pending review; a definition shows as reviewed only when both a clinical and a coding approval are recorded. Default set library_default_set@1.1.

Local criteria: site choices among published definitions and named local variants of the side-panel definitions, each with a change record, two approvals and an outcome preview.

Coder worklist

Setting: show extended capabilities on clinician screens

Current on clinician screens: Off (default) When on, findings from extended definitions appear on the side panel and the per-note screen under their own heading, after the core findings. Off or on, every check runs and replays the same, and the coder view shows both groups. The guided demo's four cases are unaffected.

CDI or coding staff can change this setting: switch the demo user.

Licence status

Thresholds are stated in our own words. Verbatim text is kept only from U.S. government works and openly licensed (CC BY) sources, with the attribution the licence asks for; copyrighted guidelines are cited by title, body and year, with a locator. No endorsement by the cited bodies is implied. This is not legal advice: counsel should review before commercial release.

Cancer-treatment adverse-event grading scale (NCI CTCAE): off by default

CTCAE grades describe adverse events in people receiving cancer treatment, usually in trials; they are not diagnostic criteria, and several grades depend on the laboratory reference range or on clinical descriptors that are not encoded. Using them outside that setting is a local decision for the clinical reviewer.

Current: Off (default) When on, grading entries are shown only as "another published definition gives …" or as values needing clinical judgement; they never raise a "not stated" item.

CDI or coding staff can change this setting. A clinician account records clinical reviews; a coding or documentation account records coding reviews: switch the demo user.

1 of 75 entries shown.

Kidney disease stage wording by filtering rate, with the albumin-to-creatinine category (options for the clinician) front_kidney_stage_wording@1.0 measurement U.S. government work Draft · pending review draft — pending clinical and coding review
Status
draft — pending clinical and coding review (draft)
Condition
Chronic kidney disease
Tier
measurement
Licence
U.S. government work
  • filtering-rate stage bands (90, 60, 45, 30, 15) and the G3a/G3b split: fact only citation (KDIGO 2024 CKD guideline, Chapter 1 (cited by title; not opened in this build))
  • albumin-to-creatinine categories (A1 below 30, A2 30-299, A3 300 mg/g or above): fact only citation (KDIGO 2024 CKD guideline, Chapter 1 (cited by title; not opened in this build))
  • 2021 creatinine equation: public domain (NIDDK, Estimating Glomerular Filtration Rate: Adults (last reviewed May 2025; opened))
To confirm
  • To confirm with a clinician: three months is encoded as 90 days (the VA/DoD summary says 3 months or more).
Source checked
opened on 2026-11-14: Opened the VA/DoD provider summary (Sidebar 6, PDF page 16): eGFR below 60 for 3 months or more, and albumin-to-creatinine ratio 30 mg/g or higher on two measurements 3 months or more apart; both match. Opened the NIDDK page: the 2021 equation and its coefficients match the kidney rule. The stage bands and albumin categories (KDIGO) were not opened in this build.
Use here
front condition (side panel options)
Edition
2025

VA/DoD Clinical Practice Guideline for the Primary Care Management of Chronic Kidney Disease, Provider Summary (Version 5.0)

front_kidney_stage_wording@1.0

In our words: Kidney disease by filtering rate: below 60 on results at least 3 months apart; or urine albumin-to-creatinine ratio 30 mg/g or higher on two tests at least 3 months apart. Stage by filtering rate: G1 90 or above; G2 60-89; G3a 45-59; G3b 30-44; G4 15-29; G5 below 15 (G1 and G2 also need a marker of kidney damage). Albumin-to-creatinine category: A1 below 30, A2 30-299, A3 300 mg/g or above. The filtering rate is estimated with the 2021 race-free creatinine equation.

Decreased eGFR <60 mL/min/1.73 m2 (GFR categories G3a-G5) for ≥3 months

Department of Veterans Affairs and Department of Defense (2025) · Sidebar 6 'Criteria for CKD' (PDF page 16; printed page 13 of 37). Do not use Sidebar 9 (a reproduced third-party figure) · source

U.S. government work (public domain). No endorsement by the cited bodies is implied.

See also:
  • KDIGO 2024 clinical practice guideline for the evaluation and management of chronic kidney disease, KDIGO (Kidney International) (2024), Chapter 1 — fact-only citation for the stage bands and albumin categories (CC BY-NC-ND per index metadata); numbers restated; text not reproduced
  • Estimating Glomerular Filtration Rate: Adults, National Institute of Diabetes and Digestive and Kidney Diseases (2025), 2021 CKD-EPI creatinine equation · link — U.S. government work; the equation used by the kidney check
  • ICD-10-CM Official Guidelines for Coding and Reporting FY2027, CMS and NCHS (2026), Section I.C.14.a.1 — coder reference only

Review

Reviewed only when both a clinical review and a coding review are recorded as approved.

Clinical review: none recorded yet.

Coding review: none recorded yet.