← All workflow templates

Workflow templateProven reference

Automate patient triage note entry

The canonical OpenAdapt tutorial: a nurse’s triage-note workflow demonstrated once in a synthetic clinic app, compiled into a deterministic local program, and replayed with the note text as a parameter — including the policy gate that refuses to certify it for clinical writes.

This workflow runs today, end to end, against the named open-source reference application in the openadapt-flow repository. The steps below are the real demonstrated steps and the verification is the real oracle.

Runs on

MockMed, the synthetic clinic application bundled with the openadapt-flow CLI — no setup and no real patient data. It ships so you can run this entire template in about two minutes.

Source in openadapt-flow →

The demonstrated steps

  1. 1Sign in to the clinic app
  2. 2Open the first referral in the task list
  3. 3Start a new encounter for the patient
  4. 4Select the Triage encounter type
  5. 5Enter the triage note — recorded as the parameter "note", overridable at every replay
  6. 6Save the encounter

Parameters: note — the triage note text — recorded values are the defaults; every replay can override them.

How the outcome is verified

Replay writes report.json and an illustrated REPORT.md for every run. lint reports the demonstration’s coverage gaps — including its unarmed irreversible final click — and certify with the strict clinical-write policy refuses the bundle. That refusal is deliberate: the bundled tutorial is runnable but intentionally not certified for clinical writes, so you see the governance boundary working before you trust it with a workflow that matters.

  • per-step postconditions
  • lint coverage report
  • policy certification gate (permissive passes, clinical-write refuses)

Evidence and scope

A nightly clean-machine test runs this complete install-to-uninstall journey on Linux, macOS, and Windows.

Try it from the command line

The compiler and runtime are open source and MIT licensed. Healthy runs are local and make no model calls.

pip install openadapt-flow

Install the open-source compiler and runtime.

openadapt-flow demo-record --out rec

Serve the bundled MockMed clinic app locally and record the canonical triage demonstration.

openadapt-flow compile rec --out bundle --name triage-note

Compile the recording into a deterministic, locally executable bundle.

openadapt-flow lint bundle

Report the bundle’s coverage gaps — expected: it finds the demo’s unarmed irreversible final click.

openadapt-flow certify bundle --policy clinical-write

Enforce the strict clinical-write policy — expected: refusal. That is the safety boundary working.

openadapt-flow replay bundle

Replay locally, $0, no model calls; writes report.json and an illustrated REPORT.md.

Put this workflow into production

Bring your version of this workflow and the record that proves its outcome. We'll map the deployment, verification, shadow run, and supervised rollout.