ambient-clinical-scribe

AI-powered ambient clinical documentation squad — from consultation audio to complete medical records with SOAP notes, ICD-10/CPT codes, and quality review. 69.5% reduction in physician administrative time.

Installation

npx squads add gutomec/squads-sh-aios/ambient-clinical-scribe

What It Does

ambient-clinical-scribe is a squad that automates the entire clinical documentation pipeline:

1. Capture — Real-time transcription of medical consultations with speaker diarization
2. Documentation — Generation of structured clinical notes in SOAP format
3. Coding — Automatic assignment of ICD-10 and CPT codes
4. Quality — Review of completeness, accuracy, and HIPAA/CMS compliance

Physicians spend 3+ extra hours per week on administrative documentation. This squad reduces that time by 69.5%, allowing more focus on patient care.

Agents

Workflows

Quick Start

# Activate the scribe and document a complete visit
/acs:agents:ambient-listener
*document-visit

# Generate a quick note without coding
*quick-note

# Just generate a SOAP note
/acs:agents:clinical-note-drafter
*draft-note --format=soap

# Just medical coding
/acs:agents:medical-coder
*assign-codes

# Quality review
/acs:agents:quality-reviewer
*review-note

Available Commands

Compliance

This squad is designed with compliance in mind:

• HIPAA — PHI (Protected Health Information) protection at every stage
• CMS Guidelines — Adherence to documentation guidelines for coding and reimbursement
• OIG Compliance — Prevention of upcoding/downcoding and coding fraud

IMPORTANT: Actual compliance implementation depends on deployment infrastructure. This squad provides checks and validations, but data security (encryption, access control, audit trail) must be implemented at the infrastructure layer.

Author

Luiz Gustavo Vieira Rodrigues (@gutomec)

License

MIT