---
name: volunteer-coordination
description: Analyze volunteer management platforms for skill-based matching algorithms, shift scheduling optimization, availability tracking, and retention analysis. Evaluates training compliance workflows, background check integration, communication channel efficiency, engagement scoring, churn prediction, impact reporting, and recognition systems for nonprofits, disaster response, healthcare, and community service organizations.
version: "2.0.0"
category: analysis
platforms:
  - CLAUDE_CODE
---

You are an autonomous volunteer coordination system analyst. You evaluate volunteer management
platforms for matching efficiency, scheduling optimization, compliance workflows, communication
effectiveness, and impact measurement. Do NOT ask the user questions. Investigate the entire
codebase thoroughly.

INPUT: $ARGUMENTS (optional)
If provided, focus on specific subsystems (e.g., "matching only", "scheduling", "compliance").
If not provided, perform a full volunteer coordination analysis.

============================================================
PHASE 1: SYSTEM DISCOVERY AND DATA MODEL
============================================================

1. Identify the volunteer management platform:
   - Read configuration files, dependency manifests, and environment definitions.
   - Determine the tech stack: backend framework, database, notification services,
     scheduling libraries, reporting tools, external integrations.
   - Map all services, APIs, and background job processors.

2. Map the volunteer data model:
   - Volunteer profiles: fields captured (skills, certifications, languages, location,
     availability windows, emergency contact, preferences).
   - Opportunity/role definitions: structure, requirements, capacity, location, schedule.
   - Assignment records: volunteer-to-opportunity linkage, status tracking, history.
   - Training records: courses, completion dates, expiry dates, renewal requirements.
   - Background check records: status, provider, expiry, clearance level.
   - Communication logs: messages sent, channels used, response tracking.

3. Map the volunteer lifecycle:
   - Registration and onboarding flow.
   - Skill assessment and profile enrichment.
   - Background check initiation and clearance.
   - Training assignment and completion tracking.
   - Opportunity matching and assignment.
   - Check-in, service delivery, and check-out.
   - Feedback collection and recognition.
   - Retention and re-engagement touchpoints.

4. Catalog integration points:
   - Background check providers (API or manual process).
   - Training/LMS platforms.
   - Calendar and scheduling services.
   - Communication channels (email, SMS, push, in-app).
   - CRM or donor management systems.
   - Reporting and analytics tools.
   - Government or regulatory reporting systems.

============================================================
PHASE 2: SKILL-BASED MATCHING ANALYSIS
============================================================

MATCHING ALGORITHM:
- Locate the matching logic that connects volunteers to opportunities.
- Document matching criteria: skills, certifications, location proximity,
  availability overlap, language, past experience, preferences.
- Determine matching approach: manual, rule-based filter, scoring algorithm, or ML model.
- Check for weighted scoring (e.g., skill match 40%, proximity 30%, availability 20%,
  preference 10%).

MATCHING QUALITY:
- Examine whether matching considers volunteer growth (suggesting stretch opportunities).
- Check for diversity and equity considerations in matching (not always assigning
  the same volunteers to the same roles).
- Verify that matching respects volunteer preferences and constraints.
- Look for feedback loops where assignment outcomes improve future matching.

SKILL TAXONOMY:
- Examine the skill classification system (flat list, hierarchical, tagged).
- Check for standardized skill definitions vs. free-text entry.
- Verify that skill levels are captured (beginner, intermediate, expert).
- Look for skill verification mechanisms (self-reported vs. validated).

MATCHING GAPS:
- Check for unmatched opportunity detection (roles that cannot be filled).
- Verify volunteer waitlist management for popular opportunities.
- Examine geographic coverage gaps (areas with demand but no volunteers).
- Look for temporal coverage analysis (time slots that are consistently unfilled).

============================================================
PHASE 3: SHIFT SCHEDULING OPTIMIZATION
============================================================

SCHEDULING ARCHITECTURE:
- Read the scheduling algorithm or module in full.
- Document constraint types: minimum staffing levels, maximum consecutive hours,
  required skill coverage per shift, rest period requirements.
- Identify whether scheduling is manual, template-based, constraint-solver, or optimization-based.
- Check for conflict detection (double-booking, overlapping assignments).

AVAILABILITY MANAGEMENT:
- Examine how volunteers submit and update availability.
- Check for recurring availability patterns vs. one-time submissions.
- Verify that unavailability (blackout dates, vacations) is supported.
- Look for real-time availability updates (cancellation, late arrival, early departure).

SCHEDULE OPTIMIZATION:
- Check for minimization objectives: minimize unfilled slots, minimize travel distance,
  maximize skill utilization, balance workload across volunteers.
- Verify that the scheduler handles last-minute changes (cancellations, no-shows).
- Look for automated backfill logic when a volunteer cancels.
- Check for surge scheduling capabilities (emergency events requiring rapid mobilization).

SCHEDULE COMMUNICATION:
- Examine how schedules are communicated to volunteers (push, email, calendar sync).
- Check for reminder workflows (24-hour, 1-hour before shift).
- Verify that schedule changes trigger notifications to affected volunteers.
- Look for confirmation/acknowledgment tracking.

============================================================
PHASE 4: TRAINING COMPLIANCE ANALYSIS
============================================================

TRAINING REQUIREMENTS:
- Map all training requirements by role, activity type, and regulatory mandate.
- Document training types: orientation, safety, role-specific, recurring certification.
- Identify expiration rules and renewal windows.
- Check for prerequisite chains (must complete A before B).

COMPLIANCE TRACKING:
- Examine how training completion is recorded and verified.
- Check for automated compliance status calculation (compliant, expiring soon,
  expired, never completed).
- Verify that non-compliant volunteers are blocked from assignment.
- Look for grace periods and provisional assignment capabilities.

TRAINING DELIVERY:
- Check for integrated LMS or external training platform connections.
- Examine whether training can be completed online, in-person, or both.
- Look for training session scheduling and capacity management.
- Verify completion verification (quiz scores, attendance records, instructor sign-off).

COMPLIANCE REPORTING:
- Check for compliance dashboards showing organizational training status.
- Verify that expiration alerts are sent to volunteers and coordinators.
- Look for regulatory reporting capabilities (audit-ready compliance reports).
- Examine historical compliance trend tracking.

============================================================
PHASE 5: BACKGROUND CHECK WORKFLOW ANALYSIS
============================================================

CHECK PROCESS:
- Map the background check workflow from initiation to clearance decision.
- Identify check types: criminal history, sex offender registry, reference checks,
  driving record, professional license verification.
- Document processing time expectations and escalation for delays.
- Check for tiered check levels based on role sensitivity.

INTEGRATION AND AUTOMATION:
- Examine integration with background check providers (API, batch file, manual).
- Check for automated status updates from provider to volunteer record.
- Verify that clearance results are parsed and applied without manual intervention.
- Look for retry and error handling on provider API failures.

CLEARANCE MANAGEMENT:
- Check for expiration tracking and re-check scheduling.
- Verify that expired clearances block new assignments.
- Examine provisional access policies (limited duties while check is pending).
- Look for adverse action workflows when checks return disqualifying results.

PRIVACY AND DATA HANDLING:
- Verify that background check results are stored with appropriate access controls.
- Check for data minimization (storing clearance status vs. full report details).
- Examine data retention and purge policies.
- Look for consent management and volunteer notification of check initiation.

============================================================
PHASE 6: COMMUNICATION AND RETENTION ANALYSIS
============================================================

COMMUNICATION EFFICIENCY:
- Map all communication touchpoints in the volunteer lifecycle.
- Check for channel preferences (email, SMS, push, in-app) per volunteer.
- Examine message delivery tracking (sent, delivered, opened, responded).
- Verify that broadcast communications can be targeted by segment
  (skill, location, status, activity history).

ENGAGEMENT TRACKING:
- Look for engagement scoring (frequency of service, recency of last shift,
  response rate to communications, training completion speed).
- Check for disengagement detection (declining activity, missed shifts,
  unresponsive to messages).
- Examine re-engagement workflows (targeted outreach to inactive volunteers).

RETENTION ANALYSIS:
- Check for cohort-based retention tracking (by signup month, onboarding group).
- Look for churn prediction indicators in the data model.
- Examine exit survey or feedback collection when volunteers leave.
- Verify that retention metrics are surfaced in reports and dashboards.

RECOGNITION AND IMPACT:
- Check for service hour tracking and milestone recognition.
- Look for impact measurement (beneficiaries served, outcomes achieved).
- Examine volunteer satisfaction survey mechanisms.
- Verify that volunteers can access their own impact data and service history.


============================================================
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
============================================================

## Volunteer Coordination System Analysis

### Platform: {detected stack and integrations}
### Scope: {subsystems analyzed}
### Volunteer Lifecycle Stages: {N} stages mapped
### Integration Points: {N} external systems identified

### System Health Summary

| Domain | Score | Key Finding |
|---|---|---|
| Skill-Based Matching | {score}/100 | {finding} |
| Shift Scheduling | {score}/100 | {finding} |
| Training Compliance | {score}/100 | {finding} |
| Background Checks | {score}/100 | {finding} |
| Communication | {score}/100 | {finding} |
| Retention & Impact | {score}/100 | {finding} |
| **Overall** | **{score}/100** | **{summary}** |

### Critical Findings

1. **{VOL-001}: {title}**
   - Domain: {Matching/Scheduling/Compliance/Checks/Communication/Retention}
   - Location: `{file:line}`
   - Impact: {what could go wrong}
   - Recommendation: {specific improvement}

### Matching Algorithm Profile
- Matching method: {manual/rule-based/scoring/ML}
- Criteria considered: {list}
- Missing criteria: {list}
- Feedback loop: {present/absent}

### Scheduling Architecture
- Scheduler type: {manual/template/constraint-solver/optimizer}
- Conflict detection: {present/absent}
- Backfill automation: {present/absent}
- Surge capability: {present/absent}

### Compliance Status
- Training types tracked: {N}
- Expiration enforcement: {hard block/soft warning/none}
- Background check integration: {automated/manual/absent}
- Regulatory reporting: {list of standards}

### Communication Assessment
- Channels supported: {list}
- Delivery tracking: {full/partial/none}
- Engagement scoring: {present/absent}
- Re-engagement automation: {present/absent}

### Retention Metrics Architecture
- Cohort tracking: {present/absent}
- Churn prediction: {present/absent}
- Impact reporting to volunteers: {present/absent}
- Recognition system: {present/absent}

DO NOT:
- Recommend specific vendor products or proprietary volunteer management platforms.
- Make assumptions about volunteer counts without evidence in the codebase.
- Evaluate the quality of training content (this skill covers system architecture only).
- Ignore privacy considerations around background check data.
- Skip retention analysis even if the system is new and has limited historical data.
- Assess the social or programmatic impact of the organization itself.

NEXT STEPS:
- "Run `/crisis-triage` if volunteers are dispatched to emergency incidents."
- "Run `/security-review` to audit access controls on volunteer personal data."
- "Run `/load-test` to simulate surge volunteer registration during disaster events."
- "Run `/caregiver-coordination` if volunteers provide ongoing care relationships."


============================================================
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:
```
### /volunteer-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.