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.

procedures.yaml

Configuration · procedures.yaml · 197 lines · editable in place

PROCEDURAL GUIDANCE ============================================================================ Idea 57. Step logic and failure modes for the procedure a district physician performs twice a year.

WHY THIS IS NOT A TEXTBOOK -------------------------- A textbook describes the procedure. What someone doing it twice a year actually needs is different: what to have ready before starting, the step people skip, and what to do when it goes wrong — because the failure modes are what experience supplies and infrequency removes.

So each procedure carries three things a description does not:

PREPARATION assembled before starting, because stopping midway to find something is where harm happens THE SKIPPED STEP named explicitly. Every procedure has one, and it is always the one that seems optional WHEN IT GOES WRONG the specific failure and the specific response

NOT A SUBSTITUTE FOR SUPERVISION -------------------------------- This helps someone trained who is out of practice. It does not make an untrained operator safe, and it says so.

Sources: standard procedural references and safety checklists. Every entry must be checked against the unit's own protocol before use.

meta
version0.1.0
ownerUNASSIGNED — set to the responsible clinician
verified bynot set
boundary
For a trained operator who is out of practice. Not a substitute for
supervision, and not a training tool for the untrained.
procedures
- idcentral_line
nameCentral venous catheterisation
frequency noteCommon in tertiary units, infrequent in district hospitals
referenceISCCM Central Venous Catheterisation and Management, 2020
preparation
"Ultrasound, with a sterile probe cover"
"Full sterile barrier — gown, gloves, cap, mask, full drape"
"Chlorhexidine and time for it to dry"
"Correct catheter length for the site"
"Assistant present"
"Coagulation and platelets checked"
checks before
- idcoagulation
questionPlatelets above 50 and INR below 1.5, or a decision recorded?
- idsite
question
Site chosen — subclavian has the lowest infection risk, internal
jugular the lowest mechanical risk
- idconsent
questionConsent taken where the patient can give it?
skipped step
stepWaiting for the chlorhexidine to dry
why
It takes 30 seconds and is skipped under time pressure. Wet
chlorhexidine does not disinfect, and this is the single commonest
omission in line insertion.
steps
"Position and confirm anatomy with ultrasound BEFORE draping"
"Full sterile preparation; allow the antiseptic to dry"
"Local anaesthetic"
"Needle under real-time ultrasound — see the tip, not just the vessel"
"Confirm venous placement before dilating"
"Guidewire — never let go of it"
"Dilate, then rail-road the catheter"
"Aspirate and flush every lumen"
"Secure, dress, and confirm position on imaging"
when it goes wrong
- problemArterial puncture
response
Withdraw and compress for 10 minutes. Do NOT dilate. If already
dilated, leave the catheter in place and call vascular surgery —
removing it converts a controlled problem into a haemorrhage.
- problemGuidewire will not advance
response
Stop. Do not force. Re-confirm position with ultrasound. Forcing a
wire is how it ends up somewhere it cannot be retrieved from.
- problemCannot aspirate after placement
responseDo not use. Re-image before any infusion.
- problemSudden desaturation or hypotension after subclavian attempt
responseAssume pneumothorax until imaging says otherwise.
- idintubation
nameEndotracheal intubation
frequency noteThe procedure where infrequency is most dangerous
referenceDifficult airway guidelines; ISCCM airway position statement
preparation
"Suction, working and within reach"
"Two laryngoscopes, checked"
"Tubes — intended size and one smaller"
"Bougie"
"Supraglottic airway as rescue"
"Capnography"
"Drugs drawn and labelled"
"Vasopressor drawn — peri-intubation hypotension is common"
"Assistant briefed on the plan and the failure plan"
checks before
- idpreoxygenation
questionPre-oxygenated for 3 minutes, or 8 vital-capacity breaths?
- idfailure_plan
questionHas the failure plan been said out loud?
- idhaemodynamics
questionIs the patient fluid-resuscitated? Induction drops the pressure.
skipped step
stepSaying the failure plan out loud before starting
why
Takes 15 seconds. Without it the team improvises during the emergency
rather than executing a plan, and every second is spent deciding
rather than acting.
steps
"Position — ear to sternal notch"
"Pre-oxygenate"
"State the plan and the failure plan aloud"
"Induction and paralysis"
"Laryngoscopy — best view on the first attempt, do not persist on a bad one"
"Tube, then confirm with capnography — not with auscultation alone"
"Secure, set the ventilator, and check the pressure"
when it goes wrong
- problemCannot intubate
response
Stop at two attempts by the same operator. Oxygenate with a bag or
supraglottic airway. A third attempt by the same person is how a
difficult airway becomes a failed one.
- problemNo capnography trace
response
Assume oesophageal until proven otherwise. Remove and oxygenate.
A trace that fades over a few breaths is oesophageal.
- problemHypotension after induction
response
Expected, not a surprise. Give the vasopressor already drawn and a
fluid bolus.
- problemCannot intubate, cannot oxygenate
responseFront-of-neck access. Declare it aloud and act.
- idchest_drain
nameIntercostal chest drain
frequency noteInfrequent outside surgical and respiratory units
preparation
"Imaging confirming side and site — reviewed, not remembered"
"Sterile field and gown"
"Local anaesthetic, generous"
"Drain, underwater seal, and connectors — assembled and checked"
"Analgesia given before starting"
checks before
- idside
questionSide confirmed against the image, at the bedside, now?
- idcoagulation
questionCoagulation checked?
- idtriangle
questionSite within the safe triangle?
skipped step
stepConfirming the side against the image at the bedside
why
Remembered rather than checked. Wrong-side drains happen, and they
happen to competent people working from memory.
steps
"Confirm side against imaging at the bedside"
"Position with the arm abducted"
"Mark the safe triangle"
"Sterile preparation, generous local anaesthetic including the pleura"
"Blunt dissection — never a trocar"
"Finger sweep before inserting"
"Insert, connect to the underwater seal, confirm swinging"
"Secure, dress, and image"
when it goes wrong
- problemNo swing and no drainage
responseAssume malposition. Image before manipulating.
- problemSudden pain or coughing on insertion
responseStop. Consider lung parenchyma. Image.
- problemPersistent large air leak
responseBronchopleural fistula — surgical referral.
- problemRe-expansion pulmonary oedema after rapid drainage
response
Drain no more than 1.5 litres at once, then clamp and wait. This is
the failure that comes from doing the procedure well but too fast.