⚡ Promptolis Original · Healthcare & Medical
🩺 SOAP Note Structure — The Clinical Documentation Framework
The structured SOAP note methodology — Subjective / Objective / Assessment / Plan — covering proper documentation per section, clinical reasoning flow, legal + billing requirements, and the time-efficient approach that turns 15-min documentation into 5-min disciplined notes.
Why this is epic
Most clinicians spend 1-2 hours daily on documentation. Bad SOAP notes = billing denials + legal exposure + time waste. This Original produces disciplined structure with specific examples per section.
Names the 5 SOAP note errors (mixed sections, insufficient objective data, unclear assessment, vague plan, legal gaps).
Produces complete framework + examples. NOT medical advice. Educational + documentation framework.
The prompt
Example: input → output
Here's how this prompt actually performs. Real input below, real output from Claude Opus 4.
<clinical-scenario>Primary care follow-up for hypertension + diabetes. 58yo male.</clinical-scenario> <specialty>Primary Care / Family Medicine.</specialty> <visit-type>3-month follow-up for chronic disease management.</visit-type> <chief-complaint>'Here for my BP and diabetes check.'</chief-complaint> <relevant-history>HTN × 8 years. Type 2 DM × 5 years. Takes lisinopril 20mg daily + metformin 1000mg BID. Last A1C 7.8%.</relevant-history> <exam-findings>BP 142/88. HR 76. BMI 32.5. Heart regular rate + rhythm. Lungs clear. No edema.</exam-findings> <differential>Uncontrolled HTN + DM — need to assess medication adherence + lifestyle + possible medication adjustment.</differential> <plan>Increase lisinopril to 40mg daily. Continue metformin. Add SGLT2 inhibitor (empagliflozin 10mg). Lifestyle: refer to RD for nutrition. Follow-up 6 weeks with BP + A1C.</plan>
SOAP Note: HTN + DM Follow-Up, 58yo M, 3-Month F/U
A SOAP note produces disciplined clinical documentation meeting medical + billing + legal requirements. This example demonstrates proper structure for chronic disease management visit.
S: Subjective
Chief Complaint: '58yo male here for 3-month follow-up of HTN and Type 2 DM.'
History of Present Illness:
Patient reports feeling 'pretty good overall' since last visit. Denies chest pain, shortness of breath, dizziness, or syncope. No polyuria, polydipsia, or nocturia. Adherent to medications per patient report. Home BP monitoring 3x/week — reports readings 130-150/80-90 range. Denies medication side effects. Diet remains 'mostly ok' — acknowledges occasional deviations on weekends. Physical activity: walks 20 min × 3/week.
Review of Systems:
- Constitutional: denies fever, chills, weight changes
- Cardiovascular: denies chest pain, palpitations, dyspnea
- Respiratory: denies cough, wheezing
- GI: regular bowel habits, denies nausea/vomiting
- GU: denies dysuria, frequency (important for DM)
- Neuro: denies headaches, vision changes, numbness/tingling
- All other systems reviewed + negative
Past Medical History:
- Type 2 DM × 5 years
- Essential hypertension × 8 years
- Hyperlipidemia
- Obesity (BMI 32.5)
Current Medications:
- Lisinopril 20mg PO daily (for HTN)
- Metformin 1000mg PO BID (for DM)
- Atorvastatin 40mg PO QHS (for lipids)
- Aspirin 81mg PO daily
Allergies: NKDA (no known drug allergies)
Family History:
- Father: deceased at 68 from MI
- Mother: alive, age 82, HTN + DM
Social History:
- Former smoker, quit 15 years ago (20 pack-year history)
- Rarely drinks alcohol
- Office worker, sedentary job
- Married, supportive spouse
O: Objective
Vital Signs:
- BP: 142/88 mmHg (left arm, seated, 2 min rest)
- HR: 76 bpm (regular)
- RR: 16
- Temp: 98.4°F
- SpO2: 98% room air
- Weight: 218 lbs
- Height: 5'10"
- BMI: 32.5 kg/m²
Physical Examination:
- General: Alert, oriented, in no acute distress. Appears stated age.
- HEENT: Normocephalic, atraumatic. PERRLA, EOMI. Oropharynx clear.
- Neck: Supple, no JVD, no lymphadenopathy, no thyromegaly.
- Cardiovascular: Regular rate + rhythm. S1, S2 normal. No murmurs, rubs, or gallops. No carotid bruits.
- Pulmonary: Clear to auscultation bilaterally. No wheezing, rhonchi, or rales.
- Abdomen: Soft, non-tender, non-distended. Normal bowel sounds. No hepatosplenomegaly.
- Extremities: No cyanosis, clubbing, or edema. Pulses 2+ and symmetric.
- Skin: No rashes. No diabetic-related skin changes.
- Neurological: Grossly intact. Monofilament testing feet: sensation intact bilaterally.
Labs/Studies (from pre-visit labs):
- A1C: 7.8% (elevated — target <7.0%)
- Fasting glucose: 142 mg/dL (elevated)
- LDL: 88 mg/dL (at goal)
- eGFR: 68 mL/min (stable from prior)
- Urine albumin-to-creatinine ratio: 45 mg/g (mildly elevated — microalbuminuria)
A: Assessment
Assessment + Plan by Problem:
1. Type 2 Diabetes Mellitus — Suboptimally Controlled
- ICD-10: E11.9
- A1C 7.8% (goal <7.0%)
- Microalbuminuria noted (emerging nephropathy)
- Current regimen inadequate for target
2. Essential Hypertension — Suboptimally Controlled
- ICD-10: I10
- Office BP 142/88 (goal <130/80 for DM patient)
- Home BP readings consistently elevated
- Current regimen inadequate
3. Hyperlipidemia — At Goal
- ICD-10: E78.5
- LDL 88 (goal <100 for patient with DM)
- Continue current management
4. Obesity — Class I
- ICD-10: E66.9
- BMI 32.5
- Contributing to above conditions
5. Microalbuminuria (Early Diabetic Nephropathy)
- ICD-10: N18.1
- New finding
- Requires ACE-inhibitor optimization + monitoring
P: Plan
For Diabetes (#1):
Medication Changes:
1. Add Empagliflozin (Jardiance) 10mg PO daily — SGLT2 inhibitor
- Rationale: A1C lowering + cardiovascular + renal protection given microalbuminuria + CV risk factors
- Patient education: rare risks (UTI, DKA, volume depletion, Fournier's gangrene), symptoms to watch for, importance of hydration
2. Continue Metformin 1000mg BID — maintain dose
Non-Pharmacologic:
- Referred to Registered Dietitian (1-hour nutrition counseling session scheduled)
- Encouraged continued exercise + discussed increasing frequency
- Home glucose monitoring — review log at next visit
For Hypertension (#2):
1. Increase Lisinopril to 40mg PO daily
- Rationale: currently on 20mg, need additional BP lowering
- Patient counseled on rare side effects (cough, angioedema)
- Also benefits microalbuminuria management
Non-Pharmacologic:
- Low-sodium diet reinforced
- Continued home BP monitoring (target <130/80)
For Hyperlipidemia (#3):
- Continue Atorvastatin 40mg PO QHS (maintain — at goal)
For Obesity (#4):
- Dietitian referral (addresses multiple conditions)
- Physical activity discussion
- Weight-loss goal: 5-10% over 6 months
For Microalbuminuria (#5):
- Continue + increase ACE-inhibitor as above
- Adding SGLT2 inhibitor beneficial
- Monitor renal function
Follow-Up:
- 6 weeks: Return visit for medication titration + BP assessment
- 3 months: Repeat A1C + comprehensive metabolic panel + urine microalbumin
- Patient Education: Provided with written instructions. Confirmed understanding. Q&A.
- Emergency Instructions: Call office for BP >180/110, symptoms of DKA, severe hypoglycemia, signs of allergic reaction to new medications.
Time Spent: 25 minutes (documented for time-based billing).
Documentation Standards + Billing
Required elements for Level 4 (99214) visit — documented:
HPI (4+ elements):
- Location: (DM/HTN — systemic)
- Duration: 3 months since last visit
- Quality: 'pretty good'
- Timing: ongoing
- Context: adherence + diet + exercise
- Modifying factors: lifestyle
- Associated symptoms: denies (documented ROS)
ROS (10+ systems or pertinent positive/negative):
- Extensive ROS documented above
- Meets requirements
PFSH (Past/Family/Social):
- Complete PFSH documented
Exam (detailed):
- Multiple systems examined
- Documented findings
MDM (high complexity):
- Multiple chronic conditions
- Medication adjustments
- New finding (microalbuminuria)
- Risk: moderate-high
Appropriate billing code: 99214 (or 99215 based on documentation depth).
Common Errors To Avoid
Error 1: Mixed Sections
- 'Patient states chest pain. BP 140/90.' Mixing subjective (chest pain) + objective (BP) in one section.
- Fix: keep sections distinct.
Error 2: Insufficient Objective Data
- 'Looks well.' → vague.
- Fix: specific findings documented.
Error 3: Vague Assessment
- 'Patient doing OK.' → no clinical reasoning.
- Fix: differential diagnoses + severity + rationale.
Error 4: Plan Without Rationale
- 'Continue meds.'
- Fix: explain WHY continuing + what targets.
Error 5: Copy-Paste From Prior Visits
- Dangerous legally + clinically.
- Fix: each note reflects THIS visit.
Error 6: Missing Follow-Up
- No clear plan for next steps.
- Fix: specific timeline + triggers for earlier visit.
Legal Protection Notes
Document:
- Specific conversations about medication risks/benefits (informed consent)
- Patient's understanding + acceptance
- Emergency instructions given
- Patient education provided
- Time spent (if relevant)
- Who was present
- Reviewed by patient (if applicable)
What you didn't document = you didn't do (in medico-legal eyes).
Protect yourself:
- 'Patient counseled on medication risks including [specific list]'
- 'Patient verbalized understanding'
- 'Return precautions discussed'
- 'Patient declined [X] despite recommendation' (if applicable)
Key Takeaways
- SOAP structure keeps sections distinct: S (patient's words), O (measurable data), A (clinical reasoning + diagnoses with ICD-10), P (specific actions with rationale).
- Thorough documentation meets Level 4 (99214) billing requirements: HPI 4+ elements, ROS 10+ systems, PFSH complete, exam detailed, MDM high complexity with multiple conditions.
- Each note specific to THIS visit. Copy-paste dangerous. Templates helpful but must customize per patient encounter.
- Legal protection: document informed consent + patient understanding + emergency precautions + return instructions. 'What you didn't document, you didn't do.'
- Time efficiency + thoroughness balance: structured templates + voice dictation + smart phrases (Epic dot phrases) enable 5-10 min documentation for most visits vs. 15-20 min unstructured.
Common use cases
- Medical students learning documentation
- Residents refining notes
- Physicians streamlining documentation
- NP/PA clinical documentation
- EHR training for new practitioners
Best AI model for this
Claude Opus 4 or Sonnet 4.5. Clinical documentation requires medical + legal + billing understanding. NOT medical advice.
Pro tips
- NOT medical advice. For clinical use, apply to specific patient scenarios with medical judgment.
- Subjective: patient's own words. Objective: measurable data.
- Assessment: differential diagnoses + most likely.
- Plan: ordered actions with rationale.
- Copy-paste dangerous — each note specific to visit.
- Billing requires specificity (HPI elements documented).
- Legal: what you didn't document = you didn't do.
- Time-efficient templates help without losing nuance.
Customization tips
- Develop specialty-specific templates (dot phrases in Epic). Saves significant time on common presentations.
- Voice dictation (Dragon, MModal) reduces documentation time 30-50%. Worth investment.
- Proper coding = proper billing. Quick CPT/ICD-10 reference card at desk helpful.
- Periodically review your documentation with a compliance consultant. Catches drift + protects against audits.
- For residents: quality over speed initially. Speed comes with practice + templates.
Variants
Primary Care SOAP
General family medicine.
Specialist SOAP
Cardiology, dermatology, etc.
Mental Health Note
Psychiatric/therapy.
Urgent Care SOAP
Acute care documentation.
Frequently asked questions
How do I use the SOAP Note Structure — The Clinical Documentation Framework prompt?
Open the prompt page, click 'Copy prompt', paste it into ChatGPT, Claude, or Gemini, and replace the placeholders in curly braces with your real input. The prompt is also launchable directly in each model with one click.
Which AI model works best with SOAP Note Structure — The Clinical Documentation Framework?
Claude Opus 4 or Sonnet 4.5. Clinical documentation requires medical + legal + billing understanding. NOT medical advice.
Can I customize the SOAP Note Structure — The Clinical Documentation Framework prompt for my use case?
Yes — every Promptolis Original is designed to be customized. Key levers: NOT medical advice. For clinical use, apply to specific patient scenarios with medical judgment.; Subjective: patient's own words. Objective: measurable data.
Explore more Originals
Hand-crafted 2026-grade prompts that actually change how you work.
← All Promptolis Originals