caregiver-alert

name	caregiver-alert
description	Automatically notifies caregivers and healthcare providers when a patient misses critical doses, shows declining adherence trends, or reports a symptom after medication.
allowed-tools	Bash Read Write

Caregiver Alert Skill

Purpose

This skill acts as the bridge between the patient and their support network. It ensures the right people are informed at the right time — without overwhelming them with noise, and without staying silent when it matters.

When This Skill Triggers

1. A patient misses 2+ doses within 24 hours
2. A critical medication (e.g., Warfarin, Insulin) is missed once
3. A patient reports a concerning symptom after taking medication
4. Weekly adherence rate drops below 80%
5. Patient is unresponsive for more than 4 hours during waking hours

Alert Levels

🟡 Level 1 — FYI Alert (Low urgency)

Recipient: Primary caregiver only
Channel: App notification + email
Template:

"FYI: [Patient Name] missed their [Medication] ([Dosage]) today at [Time]. They have been reminded and we're monitoring."

🟠 Level 2 — Action Required (Medium urgency)

Recipient: Primary caregiver
Channel: SMS + email
Template:

"⚠️ [Patient Name] has missed [N] doses in the past 24 hours, including [Critical Med if applicable]. Please check in with them when possible. Tap here to view their full schedule."

🔴 Level 3 — Urgent Intervention (High urgency)

Recipient: Primary caregiver + Secondary caregiver + Physician
Channel: Phone call (via Twilio) + SMS
Template (call transcript):

"This is MedGuard, an automated health monitoring assistant. [Patient Name] has missed [N] consecutive critical doses of [Medication]. Immediate follow-up is recommended. Press 1 to confirm you've been notified."

Caregiver Profile Format

Stored in data/caregivers/{patient_id}_caregivers.json:

{
  "patient_id": "P-001",
  "caregivers": [
    {
      "name": "David Collins",
      "relationship": "Son",
      "priority": 1,
      "phone": "[phone]",
      "email": "[e-mail]",
      "notify_on": ["level1", "level2", "level3"]
    },
    {
      "name": "Dr. Priya Rao",
      "relationship": "Physician",
      "priority": 2,
      "phone": "[phone]",
      "email": "[e-mail]",
      "notify_on": ["level3"]
    }
  ]
}

Alert Deduplication

• Do NOT send the same level alert more than once every 4 hours
• If caregiver confirms receipt → log alert_acknowledged: true and pause further alerts for that incident
• If caregiver resolves the issue → log incident_resolved: true with a note

Caregiver Dashboard Update

After every alert, update the caregiver-facing dashboard with:

• Patient's 7-day adherence trend (chart data)
• List of all missed doses in the past week
• Last confirmed medication + timestamp
• Any logged symptoms

Symptom Reporting Flow

If patient says: "I feel [symptom] after taking [medication]"

1. Log the symptom against the medication and timestamp
2. Display standard disclaimer: "I'm not a doctor, but that's worth noting. I've logged this and let your care team know."
3. Trigger Level 2 alert if the medication is marked as critical
4. If symptom is potentially severe (chest pain, difficulty breathing, severe dizziness), trigger Level 3 immediately