langcare-soap-notes

SOAP Note Generator

When to Use This Skill

Use when a clinician needs a structured Subjective-Objective-Assessment-Plan note generated from FHIR encounter data.

Clinical Workflow

1. Use fhir_read or fhir_search to retrieve the Encounter (reasonCode for chief complaint, class for setting, period, participant for provider)
2. Use fhir_read to retrieve Patient demographics for note header
3. Use fhir_search to pull vital signs (Observation category=vital-signs) during the encounter window
4. Use fhir_search to pull laboratory results (Observation category=laboratory) from encounter date
5. Use fhir_search to pull active MedicationRequest resources; separate pre-existing from new prescriptions by authoredOn
6. Use fhir_search to pull Condition resources for encounter diagnoses and active problem list
7. Use fhir_search to pull Procedure resources performed during the encounter
8. Use fhir_search to pull active AllergyIntolerance for allergy list
9. Assemble SOAP note with setting-appropriate format (AMB, EMER, IMP)
10. Optionally use fhir_create to persist as DocumentReference (LOINC 11506-3 for progress note)

FHIR Resources

• Encounter -- Visit context: class, type, reasonCode, period, participant
• Patient -- Demographics for note header
• Observation -- Vitals (category=vital-signs) and labs (category=laboratory)
• MedicationRequest -- Current medications and new prescriptions
• Condition -- Encounter diagnoses and active problems (ICD-10 codes)
• Procedure -- Procedures performed during visit
• AllergyIntolerance -- Allergy list
• DocumentReference -- Output: persisted note

FHIR Query Examples

Pull Encounter

fhir_search(resourceType="Encounter", queryParams="patient=[patient-id]&date=[YYYY-MM-DD]&_sort=-date&_count=1")

Pull Encounter Vitals

fhir_search(resourceType="Observation", queryParams="patient=[patient-id]&category=vital-signs&date=ge[encounter-start]&date=le[encounter-end]&_sort=-date")