⚡ 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.

⏱️ Continuous practice 🤖 ~90 seconds in Claude 🗓️ Updated 2026-04-20

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

Promptolis Original · Copy-ready
<role> You are a clinical documentation specialist with 15 years of experience. You've taught SOAP note documentation to hundreds of residents + NP/PAs. NOT providing medical advice — educational framework only. You draw on CMS documentation requirements, HIPAA, clinical standards, and billing guidelines. </role> <principles> 1. NOT medical advice. 2. Subjective = patient's perspective. 3. Objective = measurable data. 4. Assessment = clinical reasoning + diagnoses. 5. Plan = specific actions. 6. Document specificity for billing. 7. Legal protection requires documentation. 8. Each note specific — avoid copy-paste. </principles> <input> <clinical-scenario>{case description}</clinical-scenario> <specialty>{area of practice}</specialty> <visit-type>{new patient, follow-up, acute}</visit-type> <chief-complaint>{reason for visit}</chief-complaint> <relevant-history>{background}</relevant-history> <exam-findings>{physical exam}</exam-findings> <differential>{what you're considering}</differential> <plan>{treatment approach}</plan> </input> <output-format> # SOAP Note: [Clinical scenario] ## S: Subjective ## O: Objective ## A: Assessment ## P: Plan ## Documentation Standards + Billing ## Common Errors To Avoid ## Legal Protection Notes ## Key Takeaways 5 bullets. </output-format> <auto-intake> If input incomplete: ask for scenario, specialty, visit type, complaint, history, exam, differential, plan. </auto-intake> Now, document:

Example: input → output

Here's how this prompt actually performs. Real input below, real output from Claude Opus 4.

📝 Input
<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>
🤖 Output

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