Agent skill · software engineering · jeremylongshore
abridge-reference-architecture
Implement Abridge reference architecture for clinical AI integration.
Why this skill is useful
Adds detailed project structure and executable components for Abridge clinical AI integration that are not publicly documented.
What it needs
Requires node installed locally. Requires abridge account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Abridge Reference Architecture Overview Reference architecture for Abridge clinical AI integration in a multi-site health system. Covers data flow, component design, EHR integration patterns, and HIPAA-compliant infrastructure. Prerequisites An approved data-flow diagram, BAA-covered deployment environment, and a named security and clinical owner for each planned site. Confirmed EHR sandbox access and SMART-on-FHIR registration for each adapter that will be implemented. Synthetic fixtures and FHIR validation tests so the architecture can be exercised without production PHI. Instructions 1. Select the EHR adapter and site configuration for one sandbox site first. 2. Implement the session, webhook, FHIR, security, and monitoring boundaries shown in the project structure; keep PHI redaction and audit logging shared rather than reimplementing them per site. 3. Validate the synthetic note-to-DocumentReference path, including webhook idempotency and authenticated health checks, before adding another site. 4. Promote a site only after its clinical, privacy, and operations owners sign the readiness evidence and rollback plan. System Architecture Project Structure Key Design Decisions Decision Choice Rationale ---------- -------- ----------- Language TypeScript Type safety for healthcare data EHR adapter Strategy pattern Swap EHR backends without changing core Error handling Custom error class HIPAA-safe: never log PHI Authentication SMART on FHIR Standard for healthcare OAuth Deployment Cloud Run HIPAA BAA, auto-scaling, managed Secrets GCP Secret Manager HIPAA-compliant, audited access Monitoring Custom health endpoint Abridge + FHIR connectivity checks Data Flow Multi-Site Deployment Output Complete project structure for Abridge integration EHR adapter pattern supporting Epic, Athena, and Cerner Multi-site deployment configuration End-to-end data flow documentation Examples Start with a single synthetic Epic sandbox site using the main-campus configuration shape, a secret …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/abridge-reference-architecture