Communitygithub.com

Patrones de Desarrollo para EMR/Sistemas de Salud

Patrones de desarrollo para EMR/EHR en aplicaciones de salud. Seguridad clínica, flujos de consulta, generación de recetas, integración con sistemas de soporte a decisiones clínicas y UI accesible para ingreso de datos médicos. Úselo al construir funcionalidades de EMR o EHR como flujos de consulta, generación de recetas o interfaz de ingreso de datos clínicos.

¿Qué es Sistemas de Salud?

Este skill proporciona un conjunto completo de patrones de desarrollo para construir sistemas de Registros Médicos Electrónicos (EMR) y Registros de Salud Electrónicos (EHR). Prioriza la seguridad del paciente, la precisión clínica y la eficiencia del profesional de la salud. El skill cubre flujos de consulta en una sola página, un sistema inteligente de plantillas clínicas con manejo de banderas rojas, un riguroso patrón de seguridad para medicamentos que bloquea interacciones críticas, y un patrón de consulta bloqueada que impide ediciones posteriores al cierre. También incluye pautas de accesibilidad específicas para el entorno sanitario, como alto contraste y grandes áreas táctiles. Es útil para desarrolladores que trabajan en aplicaciones de salud, integrando CDSS o diseñando UIs clínicas; las plataformas incluyen web y móvil, con ejemplos concretos de flujos de trabajo y anti-patrones a evitar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/healthcare-emr-patterns

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Sistemas de Salud?

Patrones para construir sistemas de Registro Médico Electrónico (EMR) y Registro de Salud Electrónico (EHR). Prioriza la seguridad del paciente, la precisión clínica y la eficiencia del profesional.

Cuándo Usar

  • Construir flujos de consulta del paciente (queja, examen, diagnóstico, receta)
  • Implementar la toma de notas clínicas (estructurada + texto libre + voz a texto)
  • Diseñar módulos de recetas/medicamentos con verificación de interacciones farmacológicas
  • Integrar Sistemas de Soporte a Decisiones Clínicas (CDSS)
  • Construir visualizaciones de resultados de laboratorio con resaltado de rangos de referencia
  • Implementar pistas de auditoría para datos clínicos
  • Diseñar interfaces accesibles de salud para el ingreso de datos clínicos

Cómo Funciona

Seguridad del Paciente Primero

Cada decisión de diseño debe evaluarse contra: "¿Podría esto dañar a un paciente?"

  • Las interacciones farmacológicas DEBEN alertar, no pasar en silencio
  • Los valores de laboratorio anormales DEBEN ser señalizados visualmente
  • Los signos vitales críticos DEBEN activar flujos de escalamiento
  • No modificar datos clínicos sin pista de auditoría

Flujo de Consulta en una Sola Página

Las consultas clínicas deben fluir verticalmente en una sola página, sin cambiar de pestañas:

Encabezado del Paciente (fijo — siempre visible)
├── Demografía, alergias, medicamentos activos
│
Flujo de Consulta (desplazamiento vertical)
├── 1. Queja Principal (plantillas estructuradas + texto libre)
├── 2. Historia de la Enfermedad Actual
├── 3. Examen Físico (por sistemas)
├── 4. Signos Vitales (activa automáticamente puntuación clínica)
├── 5. Diagnóstico (búsqueda CIE-10/SNOMED)
├── 6. Medicamentos (base de datos de fármacos + verificación de interacciones)
├── 7. Investigaciones (órdenes de laboratorio/radiología)
├── 8. Plan y Seguimiento
└── 9. Firmar / Bloquear / Imprimir

Sistema Inteligente de Plantillas

interface ClinicalTemplate {
  id: string;
  name: string;             // ej., "Dolor de Pecho"
  chips: string[];          // chips de síntomas presionables
  requiredFields: string[]; // puntos de datos obligatorios
  redFlags: string[];       // activan alerta no descartable
  icdSuggestions: string[]; // códigos de diagnóstico pre-mapeados
}

Las banderas rojas en cualquier plantilla deben activar una alerta visible y no descartable, NO una notificación tipo toast.

Patrón de Seguridad de Medicamentos

Usuario selecciona fármaco
  → Verificar medicamentos actuales para interacciones
  → Verificar medicamentos de la consulta para interacciones
  → Verificar alergias del paciente
  → Validar dosis contra peso/edad/función renal
  → Si interacción CRÍTICA: BLOQUEAR la prescripción por completo
  → El clínico debe documentar el motivo de la anulación para proceder
  → Si interacción MAYOR: mostrar advertencia, requerir reconocimiento
  → Registrar todas las alertas y motivos de anulación en la pista de auditoría

Las interacciones críticas bloquean la prescripción por defecto. El clínico debe anular explícitamente con un motivo documentado almacenado en la pista de auditoría. El sistema nunca permite en silencio una interacción crítica.

Patrón de Consulta Bloqueada

Una vez que una consulta clínica está firmada:

  • No se permiten ediciones — solo un addendum (un registro separado vinculado)
  • Tanto el original como el addendum aparecen en la línea de tiempo del paciente
  • La pista de auditoría captura quién firmó, cuándo y cualquier registro de addendum

Patrones de UI para Datos Clínicos

Visualización de Signos Vitales: Valores actuales con resaltado de rango normal (verde/amarillo/rojo), flechas de tendencia vs. anterior, puntuación clínica calculada automáticamente (NEWS2, qSOFA), guía de escalamiento en línea.

Visualización de Resultados de Laboratorio: Resaltado de rango normal, comparación con valor anterior, valores críticos con alerta no descartable, marcas de tiempo de recolección/análisis, órdenes pendientes con tiempo de respuesta esperado.

PDF de Receta: Generación con un clic que incluye demografía del paciente, alergias, diagnóstico, detalles del fármaco (genérico + marca, dosis, vía, frecuencia, duración), bloque de firma del clínico.

Accesibilidad para el Ámbito Sanitario

Las interfaces sanitarias tienen requisitos más estrictos que las aplicaciones web típicas:

  • Contraste mínimo 4.5:1 (WCAG AA) — los clínicos trabajan en condiciones de luz variables
  • Grandes objetivos táctiles (mínimo 44x44px) — para interacción con guantes o apurada
  • Navegación por teclado — para usuarios avanzados que ingresan datos rápidamente
  • Sin indicadores solo de color — siempre acompañar color con texto/icono (clínicos daltónicos)
  • Etiquetas de lector de pantalla en todos los campos del formulario
  • Sin toasts de cierre automático para alertas clínicas — el clínico debe reconocer activamente

Anti-Patrones

  • Almacenar datos clínicos en localStorage del navegador
  • Fallos silenciosos en la verificación de interacciones farmacológicas
  • Toasts descartables para alertas clínicas críticas
  • Interfaces de consulta basadas en pestañas que fragmentan el flujo de trabajo clínico
  • Permitir ediciones en consultas firmadas/bloqueadas
  • Mostrar datos clínicos sin pista de auditoría
  • Usar el tipo any para estructuras de datos clínicos

Ejemplos

Ejemplo 1: Flujo de Consulta del Paciente

El médico abre la consulta del Paciente #4521
  → El encabezado fijo muestra: "Rajesh M, 58M, Alergias: Penicilina, Meds activos: Metformina 500mg"
  → Queja Principal: selecciona la plantilla "Dolor de Pecho"
    → Hace clic en chips: "subesternal", "irradiado al brazo izquierdo", "opresivo"
    → La bandera roja "dolor torácico subesternal opresivo" activa una alerta no descartable
  → Examen: Sistema CVS — "S1 S2 normal, sin soplo"
  → Signos Vitales: FC 110, PA 90/60, SpO2 94%
    → NEWS2 calcula automáticamente: puntuación 8, riesgo ALTO, alerta de escalamiento mostrada
  → Diagnóstico: busca "SCA" → selecciona CIE-10 I21.9
  → Medicamentos: selecciona Aspirina 300mg
    → CDSS verifica contra Metformina: sin interacción
  → Firma la consulta → bloqueada, solo addendum a partir de este punto

Ejemplo 2: Flujo de Seguridad de Medicamentos

El médico receta Warfarina para el Paciente #4521
  → CDSS detecta: Warfarina + Aspirina = Interacción CRÍTICA
  → UI: modal rojo no descartable bloquea la prescripción
  → El médico hace clic en "Anular con motivo"
  → Escribe: "Los beneficios superan los riesgos — protocolo de INR monitorizado"
  → Motivo de anulación + alerta almacenados en la pista de auditoría
  → La prescripción procede con anulación documentada

Ejemplo 3: Consulta Bloqueada + Addendum

Consulta #E-2024-0891 firmada por el Dr. Shah a las 14:30
  → Todos los campos bloqueados — sin botones de edición visibles
  → Botón "Agregar Addendum" disponible
  → El Dr. Shah hace clic en addendum, agrega: "Resultados de laboratorio recibidos — Troponina elevada"
  → Nuevo registro E-2024-0891-A1 vinculado al original
  → La línea de tiempo muestra ambos: consulta original + addendum con marcas de tiempo

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Skills relacionados