Caregiver Coordination System Analysis

============================================================ PHASE 2: SCHEDULING OPTIMIZATION ANALYSIS

SCHEDULE ARCHITECTURE:

• Read the scheduling algorithm or module in full.
• Document constraint types: required skill coverage, continuity of care preferences, maximum shift duration, minimum rest between shifts, regulatory hour limits, travel time between clients, caregiver preferences.
• Identify scheduling approach: manual, template-based, constraint-solver, or optimizer.
• Check for real-time schedule adjustment capabilities.

CONTINUITY OF CARE:

• Examine how the system maintains caregiver-recipient relationships over time.
• Check for primary caregiver assignment with backup designation.
• Verify that scheduling prioritizes familiar caregivers for each recipient.
• Look for metrics tracking caregiver consistency per recipient.

COVERAGE MANAGEMENT:

• Check for minimum staffing requirements per shift and per recipient.
• Examine gap detection (unscheduled time periods without caregiver coverage).
• Verify that the system handles overlapping shifts for handoff periods.
• Look for on-call and emergency coverage management.

SCHEDULE EFFICIENCY:

• Check for travel time minimization between client visits (route optimization).
• Examine utilization metrics (scheduled hours vs. available hours).
• Verify that overtime is tracked and flagged against regulatory limits.
• Look for split shift handling and preference management.

============================================================ PHASE 3: TASK ASSIGNMENT AND TRACKING

TASK FRAMEWORK:

• Examine the task data model: task types, frequency, duration, required skills, priority, dependencies, instructions, verification method.
• Check for care plan-driven task generation (tasks auto-created from care plan goals).
• Verify that tasks are scoped to specific shifts and assigned caregivers.
• Look for recurring task scheduling (daily ADLs, weekly housekeeping, monthly assessments).

TASK COMPLETION:

• Examine task completion workflows: mark complete, record observations, note exceptions.
• Check for time-stamped completion tracking (start time, end time, actual duration).
• Verify that incomplete or skipped tasks require a reason and trigger notifications.
• Look for task verification methods (photo documentation, supervisor sign-off, recipient confirmation).

TASK PRIORITIZATION:

• Check for priority classification of tasks (critical, important, routine, optional).
• Examine how time-sensitive tasks are highlighted (medication administration, meal preparation, mobility assistance).
• Verify that task lists are presented in priority order with time-of-day context.
• Look for dependency tracking (task B cannot start until task A is complete).

DEVIATION HANDLING:

• Check for deviation detection when tasks are not completed on schedule.
• Examine escalation rules for critical task deviations.
• Verify that patterns of deviation are tracked and reported.
• Look for root cause categorization on deviations (recipient refused, time shortage, equipment unavailable, caregiver skill gap).

============================================================ PHASE 4: HANDOFF COMMUNICATION ANALYSIS

HANDOFF STRUCTURE:

• Examine the handoff communication data model and workflow.
• Check for structured handoff templates (SBAR: Situation, Background, Assessment, Recommendation).
• Verify that handoff includes: tasks completed, tasks pending, observations, changes in condition, upcoming appointments, special instructions.
• Look for required fields that prevent incomplete handoffs.

HANDOFF TIMING:

• Check for scheduled handoff windows with overlap between outgoing and incoming caregiver.
• Examine whether handoff completion is a prerequisite for shift end.
• Verify that late handoffs or skipped handoffs trigger alerts.
• Look for asynchronous handoff support when in-person overlap is not possible.

COMMUNICATION CHANNELS:

• Map all communication channels: in-app messaging, voice notes, text, video, structured forms, shared care notes.
• Check for real-time messaging between current and incoming caregivers.
• Verify that communication history is preserved and searchable.
• Look for translation or language matching for multilingual care teams.

INFORMATION CONTINUITY:

• Check for a persistent care summary that all caregivers can access.
• Verify that changes made during a shift are visible in real-time to the care team.
• Examine how critical information is flagged to ensure incoming caregivers see it.
• Look for read receipts or acknowledgment tracking on handoff communications.

============================================================ PHASE 5: CARE PLAN COMPLIANCE

COMPLIANCE TRACKING:

• Examine how care plan goals are translated into measurable compliance metrics.
• Check for completion rate tracking per goal, per intervention, per caregiver.
• Verify that compliance is calculated over meaningful time windows (daily, weekly, monthly).
• Look for trend analysis showing compliance direction over time.

COMPLIANCE GAPS:

• Check for automated detection of consistently missed care plan elements.
• Examine whether compliance gaps correlate with specific caregivers, time periods, or task types.
• Verify that compliance reports distinguish between caregiver-caused gaps and recipient-caused gaps (refusal, absence).
• Look for risk scoring based on compliance patterns (low compliance on critical interventions triggers higher concern).

CARE PLAN REVIEW:

• Check for scheduled care plan review triggers (time-based, event-based, compliance-based).
• Examine the review workflow (who initiates, who participates, how changes are approved).
• Verify that care plan changes propagate to active schedules and task lists.
• Look for version history on care plans with change tracking.

REGULATORY COMPLIANCE:

• Check for regulatory documentation requirements (visit notes, service verification, supervisor oversight).
• Examine EVV (Electronic Visit Verification) integration for home health.
• Verify that documentation meets payer requirements for reimbursement.
• Look for audit readiness features (exportable records, compliance dashboards).

============================================================ PHASE 6: BURNOUT PREVENTION AND CAREGIVER WELLBEING

WORKLOAD MONITORING:

• Check for caregiver workload tracking: hours scheduled per week, consecutive days worked, number of clients, travel time, task complexity.
• Examine whether workload thresholds are defined and enforced.
• Verify that overtime and excessive hours trigger alerts to supervisors.
• Look for workload balancing across the caregiver pool.

BURNOUT INDICATORS:

• Check for tracked signals: increased sick days, shift swap frequency, late arrivals, task completion rate decline, communication responsiveness decline.
• Examine whether these signals are aggregated into a burnout risk score.
• Verify that burnout indicators trigger proactive outreach (not just punitive action).
• Look for anonymous feedback channels for caregivers to report stress.

SUPPORT RESOURCES:

• Check for integration with employee assistance or caregiver support programs.
• Examine whether the system surfaces peer support or respite care options.
• Verify that training and skill development opportunities are accessible.
• Look for recognition and appreciation features (milestone acknowledgment, positive feedback from families).

FAMILY CAREGIVER SPECIFIC:

• Check for unpaid family caregiver identification and support features.
• Examine respite scheduling capabilities (temporary professional coverage for family breaks).
• Verify that family caregivers receive training resources appropriate to their role.
• Look for family caregiver stress assessment tools.

============================================================ PHASE 7: DOCUMENTATION WORKFLOW

DOCUMENTATION TYPES:

• Map all documentation generated: visit notes, daily summaries, incident reports, assessment forms, medication administration records, care plan updates.
• Check for structured vs. free-text documentation.
• Verify that documentation templates match regulatory and payer requirements.
• Look for required-field enforcement to prevent incomplete documentation.

DOCUMENTATION EFFICIENCY:

• Examine documentation entry methods: typed notes, voice-to-text, checkboxes, pre-populated templates, copy-forward from previous entries.
• Check for mobile-friendly documentation entry for field caregivers.
• Verify that documentation can be completed during or immediately after a shift.
• Look for time-tracking on documentation (how long does it take caregivers to document).

DOCUMENTATION QUALITY:

• Check for supervisory review workflows on caregiver documentation.
• Examine whether documentation is checked for completeness before shift sign-off.
• Verify that documentation quality metrics are tracked (completeness, timeliness, accuracy).
• Look for automated quality flags (boilerplate detection, copy-paste detection, missing required observations).

============================================================ SELF-HEALING VALIDATION (max 2 iterations)

After producing output, validate data quality and completeness:

1. Verify all output sections have substantive content (not just headers).
2. Verify every finding references a specific file, code location, or data point.
3. Verify recommendations are actionable and evidence-based.
4. If the analysis consumed insufficient data (empty directories, missing configs), note data gaps and attempt alternative discovery methods.

IF VALIDATION FAILS:

• Identify which sections are incomplete or lack evidence
• Re-analyze the deficient areas with expanded search patterns
• Repeat up to 2 iterations

IF STILL INCOMPLETE after 2 iterations:

• Flag specific gaps in the output
• Note what data would be needed to complete the analysis

============================================================ OUTPUT

Caregiver Coordination System Analysis

Platform: {detected stack and integrations}

Scope: {subsystems analyzed}

Care Roles: {N} caregiver role types

Integration Points: {N} external systems identified

System Health Summary

Critical Findings

1. {CARE-001}: {title}
   • Domain: {Scheduling/Tasks/Handoff/Compliance/Burnout/Documentation}
   • Location: {file:line}
   • Impact: {what could go wrong for care quality or caregiver wellbeing}
   • Recommendation: {specific improvement}

Scheduling Profile

• Scheduler type: {manual/template/constraint-solver/optimizer}
• Continuity tracking: {present/absent}
• Gap detection: {present/absent}
• Travel optimization: {present/absent}

Task Management

• Task generation: {manual/care-plan-driven/hybrid}
• Completion verification: {self-report/photo/supervisor/recipient}
• Deviation handling: {present/absent}
• Priority classification: {present/absent}

Handoff Architecture

• Handoff structure: {SBAR/custom/unstructured}
• Overlap scheduling: {present/absent}
• Asynchronous support: {present/absent}
• Read confirmation: {present/absent}

Care Plan Compliance

• Compliance metrics: {present/absent}
• Gap correlation: {present/absent}
• Review workflow: {scheduled/event-driven/manual}
• EVV integration: {present/absent}

Caregiver Wellbeing

• Workload monitoring: {present/absent}
• Burnout risk scoring: {present/absent}
• Respite scheduling: {present/absent}
• Recognition features: {present/absent}

DO NOT:

• Recommend specific home health agency software vendors.
• Make clinical recommendations about care plans or treatment approaches.
• Evaluate caregiver clinical competency (focus on system coordination capabilities).
• Ignore family caregiver needs even if the system primarily serves professional caregivers.
• Skip burnout prevention analysis as caregiver retention directly impacts care quality.
• Assess individual caregiver performance (focus on system-level capabilities).

NEXT STEPS:

• "Run /medication-adherence to analyze medication management integration."
• "Run /fall-risk to evaluate how fall alerts integrate into caregiver workflows."
• "Run /security-review to audit access controls on care recipient health data."
• "Run /volunteer-coordination if volunteer caregivers are part of the care model."

============================================================ SELF-EVOLUTION TELEMETRY

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:

• Look for the project path in ~/.claude/projects/
• If found, append to skill-telemetry.md in that memory directory

Entry format:

### /caregiver-coordination — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}

Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.