La Carga de la Documentacion
Pregunte a cualquier cirujano ortopedico que es lo que menos le gusta de su trabajo. La respuesta casi nunca es la cirugia en si. Generalmente es:
"La documentacion."
Notas de evaluacion, documentacion SOAP, informes de seguimiento, reportes de calidad. Estas tareas consumen horas cada semana, pero cada registro debe ser preciso. No se puede cometer errores, pero tampoco se puede dedicar todo el tiempo necesario para escribir cada cosa desde cero.
Este es el problema que Doctor AI fue construido para resolver.
Phase 1: La IA Que Lee
A principios de 2026, lanzamos Doctor AI Phase 1. Los medicos conectan su herramienta de IA preferida (Claude Code, Gemini CLI, Codex CLI o cualquier cliente compatible con MCP) mediante un API Token, y la IA puede:
- Leer tendencias de VAS del paciente, tasas de adherencia y puntajes PROM
- Generar resumenes semanales y analisis de tendencias
- Responder preguntas como "Que pacientes tienen adherencia en declive?" o "Este paciente se esta recuperando segun lo esperado?"
Phase 1 era solo lectura (read-only). La IA podia observar, pero no podia modificar nada. La informacion personal identificable (numero de identificacion, telefono, correo electronico) se eliminaba automaticamente antes de llegar a la IA.
Esto funciono bien. Pero los medicos comenzaron a preguntar: "La IA ya tiene todo el contexto — puede escribir las notas SOAP por mi?"
Phase 2: La IA Que Escribe (Solo Borradores)
Phase 2 abre el acceso de escritura. La IA ahora puede redactar notas de evaluacion clinica (Assessments) para el medico.
Pero aqui esta la decision de diseno critica:
Lo que escribe la IA se guarda como borrador. Nunca se publica automaticamente.Llamamos a este principio draft-only enforcement (aplicacion solo en borrador).
Por Que No Permitir Que la IA Publique Directamente?
Porque la responsabilidad de las decisiones clinicas pertenece al medico.
La IA puede observar una tendencia de VAS y sugerir "el dolor esta mejorando, se recomienda avanzar de fase." Pero no sabe que el paciente entro hoy a la consulta con aspecto incomodo. No sabe que el paciente se cayo ayer. No sabe que el paciente tiene resistencia psicologica a un ejercicio especifico.
Estas senales contextuales aun no estan completamente disponibles para la IA. El flujo de trabajo correcto es: la IA proporciona un borrador, el medico lo revisa en 30 segundos, edita segun sea necesario y confirma. No: la IA escribe directamente en el registro oficial.
Como Funciona en la Practica
Un Escenario de Consulta
El paciente acaba de terminar la medicion de ROM. El medico escribe una linea en su herramienta de IA:
"Sr. Garcia, 6 semanas post-operatorio de PTR, ROM 120/0, camina con dolor minimo, listo para avanzar."
La IA hace tres cosas:
- Lee los datos del paciente automaticamente — obtiene tendencias de VAS, puntajes PROM, adherencia a ejercicios y el ultimo registro de evaluacion
- Completa el formulario — ingresa ROM 120/0 en los campos de flexion/extension, establece la progresion en "avanzar," pre-llena las notas S/O/A/P usando datos de tendencia
- Pregunta sobre lo que no se menciono — "No mencionaste el grado de derrame ni el VAS post-ejercicio. Debo incluirlos? La ultima evaluacion fue derrame leve, VAS 3."
El medico responde "el derrame se resolvio, VAS 2." La IA completa el borrador y lo envia a traves del MCP Server.
En el Doctor PWA
- Aparece una nueva entrada en la lista de evaluaciones con una insignia morada — que significa "borrador de IA, necesita confirmacion"
- El medico la abre y ve el formulario completo: S/O/A/P + ROM + VAS + derrame + decision de progresion
- Confirma tal cual (o edita) -> toca "Confirmar" -> el registro se vuelve oficial. El avance de fase se ejecuta solo en este momento
El objetivo de diseno: el medico dice dos oraciones, y la IA completa el formulario. Lo que antes requeria seleccionar manualmente una docena de campos se convierte en una conversacion.
Arquitectura Tecnica
| Capa | Descripcion |
|---|---|
| MCP Server v2.0.0 | 2 herramientas de escritura (draft_assessment, draft_prescription) + 6 herramientas de lectura (tendencias, alertas, PROM, etc.) |
| API de denegacion por defecto (Default-deny) | Basada en lista blanca — solo los endpoints explicitamente listados son accesibles via AI Token |
| Draft-only enforcement | En la capa API: los AI Tokens solo pueden escribir registros con status=draft. Establecer status=published es rechazado |
| Gestion de alcance (Scope) | Los medicos autorizan explicitamente los permisos de escritura en la interfaz de Token Scope del Doctor PWA |
Limites de Seguridad
Definimos limites explicitos para lo que Doctor AI puede y no puede hacer:
La IA Puede
- Leer datos de rehabilitacion del paciente (VAS, PROM, registros de ejercicios, historial de evaluaciones)
- Redactar evaluaciones a partir de instrucciones breves del medico (notas SOAP + ROM + VAS + derrame + progresion)
- Redactar prescripciones de ejercicios (seleccionar ejercicios de la biblioteca, establecer series/repeticiones)
- Hacer preguntas de seguimiento sobre campos faltantes (esta es la capacidad conversacional natural de la herramienta de IA, no una funcion del servidor)
- Generar analisis de tendencias e informes semanales
La IA No Puede
- Publicar ningun registro directamente (se requiere confirmacion del medico)
- Ejecutar el avance de fase directamente (se difiere hasta que el medico confirme el borrador)
- Redactar registros quirurgicos o entradas de facturacion (actualmente limitado a evaluaciones y prescripciones)
- Acceder a informacion personal identificable (numero de identificacion, telefono, correo electronico se eliminan automaticamente)
- Acceder a pacientes fuera del alcance autorizado del medico
- Diagnosticar de forma independiente o prescribir automaticamente
Que Pasa Si la IA Se Equivoca?
No pasa nada — porque es un borrador. Si el medico detecta cualquier problema antes de confirmar, simplemente lo elimina o edita. Los borradores no entran en el registro oficial del paciente, no afectan la programacion de PROM y no activan ningun flujo de trabajo clinico.
El costo de un borrador malo es cero. El costo de una nota auto-publicada incorrecta podria ser significativo. Esta asimetria es exactamente la razon por la que existe el draft-only enforcement.
BYO-LLM: Sin Dependencia de Proveedor, Sin Alojamiento
Otra decision de diseno deliberada: iRehab no incorpora una interfaz de chat de IA especifica.
Proporcionamos un MCP Server estandar y una interfaz de API Token. Los medicos eligen su propia herramienta de IA. Claude Code, Gemini CLI, Codex CLI, modelos locales — todos funcionan.
El razonamiento:
- Los modelos de IA cambian cada 6 meses — vincularse a un proveedor especifico es cortoplacista
- Soberania de datos — la eleccion del proveedor de IA por parte del medico determina que servidores procesan los datos. Los niveles Enterprise generalmente no retienen datos
- Costo — diferentes proveedores de IA tienen diferentes precios. Los medicos deben tener la opcion de elegir
El rol de iRehab es proporcionar una capa de acceso a datos segura, no convertirse en un proveedor de IA.
Solo Habla: Entrada por Voz + IA Que Completa Formularios
Una pregunta comun: "No quiero escribir. Puedo simplemente hablar?"
Si, y no se requiere configuracion adicional.
iPhone, Mac y Android tienen dictado integrado — toca la tecla del microfono en cualquier teclado. El medico toca el microfono en el campo de entrada de su herramienta de IA, habla, envia, y la IA mapea el lenguaje natural a campos de formulario estructurados.
No se necesita "entrenar" al modelo. El MCP Server define un esquema para cada campo (ROM flexion/extension, VAS 0-10, grado de derrame, etc.). El LLM lee este esquema y sabe como mapear el habla a los campos. "Flexion ciento veinte, extension cero" se convierte en kneeFlexion: 120, kneeExtension: 0 automaticamente.
Define Tus Atajos con CLAUDE.md
Si usas Claude Code, puedes escribir tu taquigrafia preferida en el archivo CLAUDE.md del proyecto:
# Mi taquigrafia
- "avanzar" o "listo para progresar" = progressionDecision: advance
- "retroceder" = progressionDecision: regress
- "hinchado" = effusionGrade — preguntame la gravedad
- Si no menciono un campo, siempre pregunta — nunca adivines
La IA sigue estas reglas en cada sesion — efectivamente son macros en lenguaje natural. Otras herramientas de IA tienen opciones de configuracion de system prompt similares.
Limitaciones Actuales
- El dictado del sistema maneja bien el lenguaje cotidiano, pero las abreviaturas medicas en ingles (ROM, VAS, TKA) pueden ser mal reconocidas ocasionalmente
- No hay transmision en tiempo real — hablas, envias, luego la IA procesa (no es transcripcion en vivo a los campos)
- La calidad de la entrada por voz depende de tu dispositivo y entorno, no de iRehab
Confiar Pero Verificar
El nombre "draft-only enforcement" toma prestado de un viejo principio: confiar pero verificar (trust but verify).
Confiamos en la capacidad de la IA — genuinamente produce borradores de evaluacion clinica razonables basados en datos del paciente. Pero tambien verificamos — cada borrador debe pasar por los ojos y el juicio de un medico humano antes de volverse oficial.
Esto no es desconfianza hacia la IA. Es un compromiso con mantener a un humano en el ciclo (human in the loop) para las decisiones clinicas.
A medida que la fiabilidad de la IA mejore con el tiempo, draft-only es un punto de partida que puede relajarse gradualmente. Pero en el lanzamiento, erramos por el lado de la precaucion. La historia de la tecnologia medica nos ensena que los despliegues conservadores con limites de seguridad claros generan mas confianza que los agresivos que ocasionalmente fallan.
Dos Oraciones Para Completar un Formulario
Volviendo al problema original: la carga de la documentacion.
Con Doctor AI Phase 2, el flujo de trabajo de la consulta cambia de "abrir formulario, completar manualmente cada campo, guardar" a "decirle a la IA dos oraciones, responder una pregunta de seguimiento, confirmar." El medico no necesita recordar donde esta cada campo ni escribir notas SOAP desde cero. La IA ya conoce las tendencias del paciente — solo necesita las observaciones de hoy de tu parte.
El tiempo ahorrado se destina a lo que importa mas — como dedicar un minuto extra a hablar con el paciente.
Para probar Doctor AI, genera un Token desde Doctor PWA -> Perfil -> API Token, y conecta tu herramienta de IA preferida. La configuracion toma 3 minutos.
Guia de configuracion completa: denovortho.com/irehab/ai-setup