Guide
Guide

Quick Start Tutorial

Build your first CareLang workflow in 10 minutes.

Your First Workflow

Let's create a simple patient check-in process. This workflow captures what actually happens when a patient arrives at your clinic:

CarePath [Patient Check-In]
  When [Patient Arrives]
    Record [Arrival Time]
    Verify [Appointment Scheduled]
    Record [Chief Complaint]

That's it! Three lines that describe a real clinical process.

Adding Real-World Logic

Now let's handle common situations—walk-ins and urgent cases:

CarePath [Patient Check-In]
  When [Patient Arrives]
    Record [Arrival Time]
    Verify [Appointment Scheduled]
    
    If [No Appointment]
      -> Assign [Front Desk] (action: schedule or walk-in triage)
    
    Record [Chief Complaint]
    Record [Vital Signs]
    
    If [Vital Signs Abnormal]
      -> Alert [Nursing Staff]
      -> Escalate [Immediate Triage]

Notice how the workflow reads like instructions you'd give to a new staff member.

Encoding Care Intent

CareLang lets you express not just actions, but the why behind them:

CarePath [Patient Check-In]
  When [Patient Arrives]
    Action [Greet Patient] (tone: warm and welcoming)
    
    Record [Arrival Time]
    
    If [Long Wait Expected]
      -> Notify [Patient] (explain wait time, offer water and seating)
    
    Record [Chief Complaint] (approach: active listening)

The phrases in parentheses aren't just comments—they're structured context that AI systems can understand and act on.

Building Complete Workflows

For more complex processes, organize by phase:

CarePath [Emergency Department Visit]
  
  Arrival
    Record [Arrival Time]
    Record [Mode of Arrival] (ambulance, walk-in, police)
    
  Triage
    Record [Chief Complaint]
    Record [Vital Signs]
    Action [Calculate ESI Level]
    
    If [ESI 1 or 2]
      -> Escalate [Immediate Bed Assignment]
      -> Alert [Physician]
    
    If [ESI 3-5]
      -> Assign [Waiting Room]
  
  Disposition
    When [Treatment Complete]
      If [Admit]
        -> Output [Admission Orders]
      
      If [Discharge]
        -> Output [Discharge Instructions]
        -> Assign [Follow-up Appointments]

Common Workflow Patterns

Pattern: Safety Checks

Verify [Patient Identity] (method: two-factor)
Verify [Medication] (five rights check)
Verify [Site Marking] (before procedure)

Pattern: Conditional Actions

If [Lab Result Abnormal]
  -> Alert [Provider]
  -> If [Critical Value]
    -> Escalate [Rapid Response]

Pattern: Time-Sensitive Tasks

Action [ECG] (target: within 10 minutes)
Action [Antibiotic] (target: within 1 hour of sepsis recognition)

Pattern: Generating Output

Output [OperativeNote] [TemplateID]
Output [DischargeInstructions] [PatientFriendly]

Tips for Success

Start Small
Begin with one workflow you do every day. Write it as you'd explain it to someone.

Be Specific

CarePath [Post-Op Day 1 Knee Assessment]  ✓
CarePath [Assessment]  ✗

State Your Intent

Action [Call Patient] (purpose: wound check and reassurance)  ✓
Action [Call Patient]  ✗

Handle Exceptions

If [Lab Delay]
  -> Notify [Provider]
  -> Document [Reason]

Use Sections for Clarity

PreProcedure
  Verify [Consent]

Procedure
  Record [Steps]

PostProcedure
  Assign [Follow-up]

Example: Medication Safety

Here's a complete real-world workflow:

CarePath [Medication Administration]
  
  When [Order Received]
    Verify [Right Patient] (method: two-factor ID)
    Verify [Right Drug] (match order to label)
    Verify [Right Dose]
    Verify [Right Route]
    Verify [Right Time] (within 30 minutes)
    
    If [Allergies Detected]
      -> Alert [Prescriber]
      -> Hold [Administration]
      -> Log [Incident]
    
    If [All Checks Pass]
      -> Record [Administration Time]
      -> Record [Administrator Name]
      
    Action [Monitor Patient] (timeframe: 30 minutes)
    Log [Patient Response]
    
    If [Adverse Reaction]
      -> Escalate [Rapid Response]

Next Steps

  1. Pick a workflow from your daily practice
  2. Write it in CareLang using these patterns
  3. Share with colleagues for feedback
  4. Iterate based on real use

Remember: You're describing what should happen and why, not how to technically implement it.

Need More Examples?

Check out the Examples section for complete workflows including:

  • Surgical documentation
  • Radiology protocols
  • Pathology handling
  • Emergency triage

Ready to start? Open a text editor and describe your first workflow. CareLang will help you turn clinical expertise into structured, shareable knowledge.

ON THIS PAGE