Build Medical Software From Evidence to Software Lesson 1 of 5 intermediate 7 min read

Evidence Is Not Yet a Clinical Instruction

Clinical evidence describes populations. Physician-developers must preserve its limits before translating it into protocol logic or software.

In This Lesson

Read with a defined objective.

View the complete course

Learning objectives

  • Distinguish population evidence from an individual clinical decision.
  • Create an evidence card with absolute effect, limitations, and a review date.
  • Separate source evidence from the recommendation built upon it.

Prerequisites

  • A clinical recommendation you use in practice.

Build Medical Software From Evidence to Software

Listen to this post

Evidence Is Not Yet a Clinical Instruction

0:00 / 0:00
Clinical research papers narrowing toward a bedside monitor while uncertainty remains visible around the patient
On this page5 sections

At 2 a.m., a growth-restricted fetus does not arrive as a forest plot.

The patient arrives with a gestational age, an umbilical artery Doppler pattern, a blood pressure trend, prior growth measurements, local neonatal capability, and a family trying to understand what happens next. The evidence matters. It does not make the decision by itself.

That distinction is the first boundary in clinical software.

Evidence Describes a Population

A randomized trial estimates what happened across a defined group under defined conditions. A systematic review combines several such estimates. A guideline panel then interprets the strength, consistency, and applicability of those findings.

Software begins farther downstream. By the time a physician-developer writes an if statement, uncertainty has already passed through several layers of interpretation.

The code may look exact. The evidence beneath it is not always exact.

The Evidence Card

Before translating a recommendation, create an evidence card. This is the smallest useful record of what the recommendation rests on.

Capture six things:

  1. The clinical question.
  2. The population studied.
  3. The intervention and comparator.
  4. The absolute effect, not only the relative effect.
  5. The certainty and major limitations.
  6. The date after which the evidence needs review.

Relative risk is attractive because it compresses a result into one number. Software prefers that kind of cleanliness. Patients need the baseline risk as well. A 50 percent relative reduction means something different when the starting risk is 20 percent than when it is 2 percent.

The absolute effect is not a statistical footnote. It changes the clinical conversation.

Evidence Has a Half-Life

Some clinical knowledge is bedrock. Anatomy does not change every six months. Diagnostic thresholds, drug eligibility rules, surveillance intervals, and treatment recommendations can.

I wrote about this problem in Dead Weight. The clinical question is not merely whether a source was authoritative when published. The question is whether it remains authoritative when the software executes.

Every evidence card therefore needs a review date. Without one, the future application has no reliable way to distinguish durable logic from stale logic.

Separate Evidence From Recommendation

Evidence and recommendations are related. They are not interchangeable.

A study reports an association or treatment effect. A guideline decides how that evidence should influence care. That decision may incorporate feasibility, harms, values, equity, and resources that do not appear in the primary endpoint.

When these layers are collapsed, the eventual software becomes difficult to audit. A developer cannot tell whether a threshold came directly from a study, from a professional society, from a local protocol, or from an undocumented assumption made during implementation.

Preserve the chain.

Your Exercise

Choose one recommendation you use often. Do not begin with code.

Create its evidence card. Record the source, population, absolute effect, important exclusions, certainty, and review date. Then write one sentence describing what the evidence does not establish.

If that sentence is difficult to write, the recommendation is not ready to become logic.

Evidence is the first input. Its limits must travel with it.

Share this article

Share X / Twitter Bluesky LinkedIn

Related articles

A precise clinical protocol grid bending around a complex patient silhouette without enclosing it
Clinical Software

A Protocol Is a Memory System, Not a Patient

Clinical protocols reduce avoidable variation, but software must preserve their population boundaries, exceptions, provenance, and judgment points.

· 7 min read
clinical protocolsclinical decision supportevidence-based medicine
A clinical guideline unfolding into an inspectable decision tree with thresholds, branches, and exception paths
Clinical Software

Make the Clinical Logic Visible Before You Code

Translate a clinical protocol into explicit inputs, branches, thresholds, exceptions, and failure states before choosing a programming language.

· 8 min read
clinical algorithmsdecision treesclinical protocols
A transparent clinical application showing a tested logic engine beneath a restrained interface
Clinical Software

Build the Clinical Engine Before the Interface

A reliable clinical application separates guideline logic from presentation, tests expected behavior, and carries provenance into every recommendation.

· 8 min read
clinical softwareclinical decision supportsoftware testing
Chukwuma Onyeije, MD, FACOG

Chukwuma Onyeije, MD, FACOG

Maternal-Fetal Medicine Specialist

MFM specialist at Atlanta Perinatal Associates. Founder of CodeCraftMD and OpenMFM.org. I write about building physician-owned AI tools, clinical software, and the case for doctors who code.