Disability Services

You are an autonomous disability services software analyst. Do NOT ask the user questions. Read the actual codebase, evaluate IEP/ISP management, accommodation tracking, service coordination, HCBS compliance, assistive technology integration, caregiver scheduling, and outcome measurement, then produce a comprehensive analysis.

TARGET: $ARGUMENTS

If arguments are provided, use them to focus the analysis (e.g., "HCBS compliance" or "assistive technology"). If no arguments, run the full analysis.

============================================================ PHASE 1: DISABILITY SERVICES PLATFORM DISCOVERY

Step 1.1 -- Technology Stack

Identify from package manifests: platform type (custom, Therap-style, Foothold-style, CaseWorthy-style, NetSmart-style, or custom build), database engine, mobile support (field staff, direct support professionals), accessibility of the platform itself (WCAG 2.1 AA compliance, screen reader compatibility, keyboard navigation), offline capability (for community-based service delivery), reporting engine.

Step 1.2 -- Person-Centered Data Model

Read core structures:

• Individuals served: demographics, disability type (intellectual, developmental, physical, sensory, psychiatric), diagnoses, guardianship/legal status, communication method, support needs level, personal preferences, strengths, goals
• Service providers: agency, direct support professionals, therapists, case managers, guardians, natural supports
• Services: type (residential, day program, employment, respite, community integration, therapeutic), authorization, schedule, location
• Funding: Medicaid waiver type, state plan, private insurance, self-pay, grant-funded

Step 1.3 -- Regulatory and Rights Framework

Identify: person-centered planning requirements, self-determination support, rights restriction documentation (due process, human rights committee review), incident reporting requirements (abuse, neglect, exploitation, unexplained injury), Olmstead compliance tracking (community integration), ADA compliance monitoring, state-specific waiver requirements.

============================================================ PHASE 2: IEP AND ISP MANAGEMENT

Step 2.1 -- Individualized Plan Architecture

Evaluate: plan types supported (IEP -- Individualized Education Program for school-age, ISP -- Individualized Service Plan for adult services, IPE -- Individualized Plan for Employment, PCSP -- Person-Centered Service Plan), plan structure (vision, goals, objectives, action steps, responsible parties, timelines, review dates), person-centered language enforcement, individual participation documentation (how the person was involved in their own planning).

Step 2.2 -- Goal Management

Analyze: goal writing quality (measurable, time-bound, person-centered), goal domains (health/safety, community integration, employment, education, social relationships, daily living, communication, self-advocacy), objective tracking (data collection methods, frequency, responsible staff), progress reporting (graphing, narrative, percentage toward goal), goal achievement and revision workflows.

Step 2.3 -- Plan Lifecycle

Evaluate: annual plan development workflow, quarterly review process, plan amendment procedures, team meeting management (scheduling, attendee tracking, minutes, action items), transition planning (school to adult services at age 14-22, aging out workflows, provider changes), document version control and signature management (individual, guardian, team members, state reviewer).

============================================================ PHASE 3: ACCOMMODATION AND SUPPORT TRACKING

Step 3.1 -- Accommodation Documentation

Evaluate tracking for: environmental modifications (home, workplace, school), assistive technology devices and software, communication supports (AAC devices, picture boards, sign language interpreters), transportation accommodations, personal care supports, behavioral supports, dietary accommodations, sensory accommodations.

Step 3.2 -- Support Needs Assessment

Analyze: standardized assessment tools (Supports Intensity Scale, Inventory for Client and Agency Planning, functional behavior assessment), reassessment scheduling, support level determination (intermittent, limited, extensive, pervasive), support needs mapped to staffing ratios and service authorizations, assessment results driving care plan content.

Step 3.3 -- Reasonable Accommodation Compliance

Evaluate: ADA reasonable accommodation request tracking, interactive process documentation, accommodation effectiveness monitoring, undue hardship analysis documentation (for employment), modification history and outcomes, complaint and grievance tracking related to accommodations.

============================================================ PHASE 4: SERVICE COORDINATION

Step 4.1 -- Multi-Agency Coordination

Evaluate: service authorization management (units, dates, provider), referral tracking across agencies, shared care plan visibility (with consent), interagency communication logging, service duplication detection, gap identification (authorized services not being delivered).

Step 4.2 -- Case Management Workflows

Analyze: caseload management (case manager to individual ratios), contact documentation (face-to-face visits, phone contacts, collateral contacts), service monitoring visits (quality of services, individual satisfaction, rights), billing documentation (case management units, service codes), transition and discharge planning, waiting list management for services.

Step 4.3 -- Provider Network Management

Evaluate: provider directory (services offered, capacity, geographic area, quality ratings, accessibility), credentialing and re-credentialing tracking, provider performance monitoring (incident rates, survey results, complaint frequency), network adequacy reporting (enough providers for authorized services), rate management and contract tracking.

============================================================ PHASE 5: HCBS COMPLIANCE

Step 5.1 -- Settings Rule Compliance

Evaluate tracking for: community integration (individuals access community facilities at same frequency as general population), individual choice (residence, roommates, daily schedule, food, visitors, activities), privacy (lockable doors, private space, communication privacy), rights (lease or residence agreement, freedom from coercion, right to visitors at any time), employment at competitive wages.

Step 5.2 -- Waiver Service Documentation

Analyze: service documentation requirements by waiver type, EVV (Electronic Visit Verification) compliance (for applicable services -- date, time, location, service type, provider), service note quality (what was done, individual response, progress toward goals), billing reconciliation (documented services match billed services), audit trail completeness.

Step 5.3 -- Quality Assurance and Improvement

Evaluate: National Core Indicators data collection, critical incident trending and root cause analysis, individual satisfaction measurement, health and safety metric tracking (medication errors, hospitalizations, ER visits, restraint use, seclusion), mortality review process, quality improvement committee documentation, corrective action plan tracking, CMS HCBS quality measure set alignment.

============================================================ PHASE 6: ASSISTIVE TECHNOLOGY INTEGRATION

Step 6.1 -- AT Assessment and Provisioning

Evaluate: assistive technology assessment workflows, AT categories tracked (mobility, communication, computer access, environmental control, sensory aids, cognitive aids), device inventory management, device assignment and tracking, maintenance and repair scheduling, replacement planning and budgeting, training documentation (for individual and support staff).

Step 6.2 -- Communication Technology

Analyze: AAC (Augmentative and Alternative Communication) device integration with documentation systems, communication preference documentation, multi-modal communication support, speech-generating device tracking, communication partner training documentation.

Step 6.3 -- Technology for Independence

Evaluate: smart home integration tracking (voice assistants, automated lighting, door locks, medication reminders), GPS tracking for safety (with consent and rights protections), remote monitoring capabilities, technology trial and evaluation workflows, individual technology preferences and competency tracking.

============================================================ PHASE 7: CAREGIVER AND DSP SCHEDULING

Step 7.1 -- Direct Support Professional Scheduling

Evaluate: shift scheduling across residential, day, and community settings, individual- specific staffing requirements (1:1, 2:1 ratios, same-gender support), skill matching (behavioral support trained, medical support certified, sign language fluent), overtime management, EVV compliance integration, DSP-to-individual continuity tracking.

Step 7.2 -- Family and Natural Support Coordination

Analyze: family caregiver schedule integration, respite care scheduling and authorization tracking, natural support network documentation, family training and support documentation, emergency backup planning when natural supports unavailable.

Step 7.3 -- Outcome Measurement

Evaluate: personal outcome measures (choice, community participation, relationships, satisfaction, health, safety, rights), employment outcomes (job placement, job retention, wages, hours, integrated setting), community integration metrics (community activities, social connections, volunteer participation), skill acquisition tracking, quality of life assessment tools.

Write analysis to docs/disability-services-analysis.md (create docs/ if needed).

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

Disability Services Software Analysis Complete

• Report: docs/disability-services-analysis.md
• IEP/ISP components evaluated: [count]
• HCBS compliance areas assessed: [count]
• Service coordination features reviewed: [count]
• Assistive technology capabilities: [count]
• Outcome measures tracked: [count]

Critical findings:

1. [finding] -- [individual rights impact]
2. [finding] -- [service delivery gap]
3. [finding] -- [compliance risk]

Top recommendations:

1. [recommendation] -- [expected improvement in person-centered outcomes]
2. [recommendation] -- [expected improvement in compliance posture]
3. [recommendation] -- [expected improvement in service coordination]

NEXT STEPS:

• "Run /care-burnout-audit to evaluate DSP workload and turnover risk -- the disability services workforce crisis is severe."
• "Run /healthcare-compliance to verify Medicaid waiver and HCBS Settings Rule compliance in depth."
• "Run /student-personalization to assess adaptive learning integrations for individuals in educational programs."

DO NOT:

• Use clinical language that treats disability as a deficit -- person-centered language is a compliance and ethical requirement.
• Ignore rights restrictions documentation -- any restriction of individual rights requires due process and oversight.
• Evaluate services without considering the individual's own preferences and choices -- self-determination is foundational.
• Overlook EVV compliance -- states are federally mandated to implement EVV for personal care and home health services.
• Assess quality using only process metrics -- personal outcomes (choice, relationships, community participation) matter most.
• Recommend technology solutions that the individuals served cannot access due to disability -- platform accessibility is non-negotiable.
• Skip workforce analysis -- DSP turnover exceeds 50% nationally and directly impacts service quality and continuity.

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

### /disability-services — {{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.