Skip to main content
DataCrafters synthetic data · demonstration

Coder worklist · Clinician screen · Chart

Staff surface Coder view

P06 KE-P06 · outpatient visit

One row per condition family: what the record supports under the published definition, what the note states, the visit's diagnosis entries, and an assessment. Codes are coded from the signed documentation; the software never assigns one.

Note: unsigned draft

Side-panel conditions check FRUN-00006 · front-engine 1.2 · replay 37a4cde6f1b51469…

Library check LRUN-00006 · library_default_set@1.1 · library-engine 1.1 · replay c833abb9a7234a32… · Data (JSON)

Core definitions 1

Core definitions: condition families for this encounter (1)
Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
Kidney disease stage (filtering rate)
measured · side-panel condition

front_kidney_stage_wording@1.0 Draft · pending review

Record meets: Chronic kidney disease stage 3b

  • Filtering rate 43.1 on 2026-06-14 (G3b range) and 39.5 on 2026-11-11 (G3b range) · L-0012
Options and what the record shows
  • Chronic kidney disease stage 1 · needs filtering rate 90 or above with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · not met
  • Chronic kidney disease stage 2 · needs filtering rate 60-89 with a kidney damage marker (for example albuminuria on two tests at least 90 days apart) · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · not met
  • Chronic kidney disease stage 3a · needs filtering rate 45-59 on two results at least 90 days apart · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · not met
  • Chronic kidney disease stage 3b · needs filtering rate 30-44 on two results at least 90 days apart · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · met
  • Chronic kidney disease stage 4 · needs filtering rate 15-29 on two results at least 90 days apart · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · not met
  • Chronic kidney disease stage 5 · needs filtering rate below 15 on two results at least 90 days apart · record: filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11 (G3b range) · not met
Citation

Kidney disease stage wording by filtering rate, with the albumin-to-creatinine category (options for the clinician)

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, VA/DoD Clinical Practice Guideline for the Primary Care Management of Chronic Kidney Disease, Provider Summary (Version 5.0) (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

Licence: U.S. government work (public domain); filtering-rate stage bands (90, 60, 45, 30, 15) and the G3a/G3b split: fact only citation; albumin-to-creatinine categories (A1 below 30, A2 30-299, A3 300 mg/g or above): fact only citation; 2021 creatinine equation: public domain. Source checked: opened. No endorsement by the cited bodies is implied.

To confirm with a clinician: three months is encoded as 90 days (the VA/DoD summary says 3 months or more).

Not stated

None entered

The record supports it; neither stated in the note nor entered

Two kidney results 150 days apart are in the G3b range (filtering rate 43.1 on 2026-06-14 and 39.5 on 2026-11-11); the note doesn't mention kidney function.

Clinician's response to the side-panel card: No response yet · offer OF-000003

Draft a query

Whole code category, for reference (no code is selected, ranked or suggested): Kidney disease stage (filtering rate) Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

N18 Chronic kidney disease (CKD) (9 codes in the category).

  • N18.1 Chronic kidney disease, stage 1
  • N18.2 Chronic kidney disease, stage 2 (mild)
  • N18.30 Chronic kidney disease, stage 3 unspecified
  • N18.31 Chronic kidney disease, stage 3a
  • N18.32 Chronic kidney disease, stage 3b
  • N18.4 Chronic kidney disease, stage 4 (severe)
  • N18.5 Chronic kidney disease, stage 5
  • N18.6 End stage renal disease
  • N18.9 Chronic kidney disease, unspecified

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).

Extended capabilities (licence required before commercial use) 1

Extended capabilities: published criteria cited by title and restated in our own words, no text reproduced; a licence or permission is needed before commercial use. Shown to coders always; on clinician screens only when the setting is on (now off).

Extended capabilities (licence required before commercial use): condition families for this encounter (1)
Condition familyWhat the record supportsWhat the note states Visit diagnosis entriesAssessment
Osteoporosis / osteopenia (bone density)
measured

who1994_osteoporosis@1.0 Draft · pending review

Osteoporosis: 2.5 SD or more below the young adult mean

  • bmd t score -2.8 SD 2026-04-25 09:00 · LM-P06-01

Window: 1095 days before the check.

Citation

Osteoporosis and osteopenia by BMD T-score (WHO 1994)

who1994_osteoporosis@1.0

In our words: Bone density T-score (postmenopausal women): -1 or higher normal; between -1 and -2.5 low bone mass; -2.5 or lower osteoporosis; below -2.5 with a fragility fracture severe osteoporosis.

World Health Organization, Assessment of fracture risk and its application to screening for postmenopausal osteoporosis: report of a WHO Study Group (WHO Technical Report Series 843) (1994) · Section 2.1 Definitions, printed pages 5-6 (PDF pages 11-12) · source

Licence: cited source; wording is ours (numbers restated, no text reproduced). Source checked: opened. No endorsement by the cited bodies is implied.

Contested: T-score categories were defined for postmenopausal (white) women; their use in men and other populations relies on later bodies (e.g. ISCD), which were not opened; the report itself calls cut-off values 'somewhat arbitrary'.

Not encoded: Men, premenopausal women and children: the report states the categories for women; not assessable. The site, technique, equipment and reference population (the report notes that results differ by measurement site and technique) are not checked; the lowest T-score passed is used. Fracture risk (e.g. FRAX) is not assessed.

Osteoporosis

M81.0 Age-related osteoporosis without current pathological fracture (visit diagnosis list (synthetic))

Supported and specific

Whole code category, for reference (no code is selected, ranked or suggested): Osteoporosis / osteopenia (bone density) Coders only

reference for coders — the clinician's documented statement governs; the software does not assign codes

M81 Osteoporosis without current pathological fracture: distinguishes osteoporosis without current pathological fracture: age-related, localized, other (3 codes in the category).

  • M81.0 Age-related osteoporosis without current pathological fracture
  • M81.6 Localized osteoporosis [Lequesne]
  • M81.8 Other osteoporosis without current pathological fracture

M80 Osteoporosis with current pathological fracture: distinguishes osteoporosis with current pathological fracture, by type, site and laterality, with encounter and healing 7th characters (324 codes in the category).

324 codes; see the official files

M85 Other disorders of bone density and structure: distinguishes M85.8- other specified disorders of bone density and structure (used for osteopenia), by site and laterality (169 codes in the category).

169 codes; see the official files

Source: official ICD-10-CM FY2027 code descriptions (extract in library/data/code_reference_fy2027.json).