Skip to content

feat(health): Implement comprehensive healthcare organization plugin with conductor methodology #56

@edithatogo

Description

@edithatogo

Summary

Implement comprehensive health plugin for healthcare organization workflows using conductor-based development methodology. This plugin provides 34 specialized skills and 19 commands covering clinical, administrative, financial, and research domains with full regulatory compliance.

Motivation

Healthcare organizations require specialized Claude Code support for:

  • Complex regulatory compliance (AU/NZ NSQHS, HIPAA, GDPR)
  • Clinical safety-critical workflows
  • Multi-jurisdictional requirements
  • Evidence-based decision making
  • Patient privacy and PHI protection

Scope

Implementation Tracks (14 total)

Phase 1: Foundation

  • health-core: Plugin structure and standards ✓

Phase 2: Core Workflows

  • health-coding: Clinical coding and classification ✓
  • health-governance: Policies, procedures, guidelines ✓

Phase 3: Extended Workflows

  • health-procurement: Device procurement, business cases ✓
  • health-quality: QI, accreditation, PDSA cycles ✓
  • health-financial: Payer contracts, charge capture ✓
  • health-evidence: Systematic reviews, PRISMA workflows ✓
  • health-data-analysis: Epidemiological reports ✓
  • health-public-health: Notifiable diseases, surveillance ✓

Phase 4: Research & Academic

  • health-ethics: Research/clinical ethics, REC/IRB ✓
  • health-economics: HTA, cost-effectiveness, PBAC ✓
  • health-manuscripts: Journal preparation, reporting guidelines ✓
  • health-doc-coauthoring: Collaborative document development ✓
  • health-grants: NHMRC, MRFF, HRC applications ✓
  • health-medicolegal: Reports, child protection, affidavits ✓

Infrastructure

  • skill-quality: Health skill templates and validation ✓

Deliverables

Component Count Description
Skills 34 Healthcare domain expertise
Commands 19 Workflow initiation and guidance
Tracks 14 Development project management
Lines of Documentation 12,000+ Comprehensive guidance

Key Features

  1. Regulatory Compliance

    • AU/NZ-default (NSQHS, HQSC, PBAC, NHMRC)
    • US/EU-lite portability (HIPAA, Joint Commission, GDPR)
    • Jurisdiction matrices for all domains
  2. Clinical Safety

    • Confidence Indicators for risk assessment
    • PHI/PII guardrails in all skills
    • Standard and Lite operating modes
  3. Evidence Rigor

    • 14-section health skill standards
    • Hybrid Evidence Management (strict citations + narrative)
    • FHIR/SNOMED-CT alignment
  4. Quality Assurance

    • Automated track validation
    • Health skill validation script
    • Pre-commit hooks

Implementation Details

Skill Architecture

All skills follow standardized 14-section template:

  • Purpose and scope
  • Confidence Indicators table
  • Security & Privacy (PHI/PII guardrails)
  • Regulatory Context (jurisdiction matrix)
  • Operating Modes (Standard/Lite)
  • Detailed Guidance
  • Common Mistakes (anti-patterns)
  • Tool Requirements
  • Success Indicators
  • Cross-References

Example Skills

  • systematic-review: PRISMA 2020 compliance, GRADE grading
  • research-ethics: NHMRC/HRC REC workflows, informed consent
  • hta-submission: PBAC/MSAC/PHARMAC submission frameworks
  • notifiable-diseases: AU/NZ notification requirements
  • child-protection: Mandatory reporting triggers

Commands

Interactive workflow commands including:

  • /start-review: Systematic review protocol development
  • /ethics-review: Research/clinical ethics routing
  • /report-notifiable: Disease notification compliance
  • /prepare-manuscript: Journal submission checklists
  • /grant-application: NHMRC/MRFF structured applications

Testing

  • All 14 tracks pass validation (validate_tracks.py)
  • Health skills pass quality checks (validate_health_skills.py)
  • Pre-commit hooks configured
  • GitHub Actions workflow for CI

Future Work

Potential enhancements:

  • Additional jurisdiction deep-dives (UK NICE, Canada CADTH)
  • Integration with EHR connectors (Epic, Cerner)
  • Mobile-responsive command interfaces
  • Multi-language support for international deployment

Documentation

Related

Checklist

  • All tracks complete
  • All skills follow health skill standards
  • AU/NZ jurisdiction defaults implemented
  • US/EU-lite portability included
  • Validation scripts passing
  • Documentation complete
  • Pre-commit hooks configured
  • GitHub Actions CI workflow

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions