Recomendaciones — por qué así
Cómo funciona: como-funciona/recomendaciones.md · Decisiones: D-RV1 … D-RV11 (2026-10-04, lote El motor en el mundo real), D-PF5-bis, D-TU1 … D-TU3, D-SO1 … D-SO4 · Normativo:
MindTune_Reglas_v1.md,MindTune_Insumos_reglas_v1.md· Evidencia:MindTune2027/Motor_Recomendacion_v0/· Última revisión: 2026-10-10 (la dosis de Inducción, D-IF1).
1. Contexto y problema
Hasta el 2026-10-04 Hoy elegía la terapia con tres fuentes (equipo, en curso, base) y dejaba un hueco
para una cuarta, reglas_v1, que devolvía siempre nada (D-HY1: una regla a medias que recomienda por
una razón mal calculada es peor que no recomendar). El perfil ya tenía quince secciones, la app cuatro
terapias de sonido, un módulo de lecciones y Pausas, y nada que convirtiera ese perfil en una
recomendación. Recomendaciones para mí decía «en una próxima versión».
Para escribir las reglas había tres insumos, de naturaleza muy distinta:
- El audio de Hayo del 2026-10-04 (transcripción
Las Hualtatas 5475 22.txt, no versionada; resumida enLOTE_2026-10-04_El_motor_en_el_mundo_real.md): el criterio clínico del programa de tinnitus —las tres semanas de Inducción como núcleo, mMIDST frente a la persistencia, la hiperacusia como puerta previa, la Inhibición residual como rescate «como un analgésico», el aviso de salud mental que vuelve, y la máxima nunca peor el remedio que la enfermedad. - El motor v0 (
MindTune_Motor_Recomendacion_v0.md, Cowork, 2026-10-02): qué tan predecible es lo que el equipo del programa CAS indica a partir del perfil, en 268 pacientes únicos (las 397 filas de la base maestra tenían 106 pacientes repetidos). - El contrato de insumos de salud mental y sueño (
MindTune_Insumos_reglas_v1.md, lote anterior): qué pueden y qué no pueden hacer las reglas con el POST, el ISI, la señal de sueño y los niveles de riesgo R1–R3.
El problema a resolver: una primera versión que funcione en el mundo real y que Hayo pueda evaluar en el teléfono y corregir, sin esperar datos que no existen, pero dejando escrito cuáles reglas tienen respaldo y cuáles no, y registrando lo necesario para revisarlas.
2. Lo que dice la evidencia
2.1 Lo que el motor v0 sí puede enseñar: las acciones externas
Validación cruzada de 5 particiones sobre los 268 pacientes; regresión logística y árbol de profundidad 3
(Motor_Recomendacion_v0/01_motor_reglas_derivadas.py, reproducible en el Mac, los datos no salen del
disco). Las cuatro decisiones del equipo que más dependen del perfil son, justamente, las que en la app
salen como acción externa o como la terapia de hiperacusia, y cada una tiene un dato dominante:
| Decisión del equipo | Prevalencia | AUC | Dato dominante | Indicada con el dato / sin él | OR | Regla |
|---|---|---|---|---|---|---|
| Salud mental | 61 % | 0,89 (logística) | Goldberg ansiedad ≥ 4 o depresión ≥ 2 | 78 % / 13 % | 23 | S3, S3-bajo |
| Kinesiología oro-cérvico-facial | 38 % | 0,84 (árbol) | Levine positivo | 76 % / 5 % | 57 | K1 |
| Manejo de hiperacusia | 29 % | 0,83 | GÜF ≥ 10 puntos (ver nota) | 60 % / 9 % | 16 | H1 |
| Audífono | 13 % | 0,80 | PTA del peor oído ≥ 40 dB | 51 % / 5 % | 19 | A1 |
Nota: el motor v0 calculó las cifras de hiperacusia con GÜF ≥ 10 puntos («grado ≥ 2» en su texto), y la app usa el grado del instrumento, que empieza en 11 (DF-25). Las cifras de esta página sobre la hiperacusia son las del motor v0 y no se recalcularon con el corte de la app.
Contrastando las reglas a priori que ya tenía el formulario de los tecnólogos (sugerir()) con lo que el
equipo indicó de verdad:
- Kinesiología con «Levine o bruxismo» baja la especificidad de 0,87 a 0,65; el bruxismo solo es débil (49 % frente a 31 %, OR 2,2). Por eso K1 es solo Levine (sensibilidad 0,89, especificidad 0,87) y el bruxismo o el dolor van a K2, sugerida.
- Hiperacusia: el grado ≥ 2 sirve para ofrecer (sensibilidad 0,81, especificidad 0,82, VPP 0,66); el grado ≥ 3 es casi seguro (el equipo la indicó al 92 %, VPP 0,90). Con grado 2, solo al 43 %.
- Audífono: PTA ≥ 25 es sensible pero poco preciso (VPP 0,33); ≥ 40 es más honesto para un aviso (VPP 0,51). PTA 25–39 quedó como A2, débil: solo el 12 % de esos pacientes (n = 34) recibió audífono.
- Salud mental: el THI casi no agrega al Goldberg (con THI ≥ 38 y Goldberg normal hay solo 3 pacientes). S3-bajo usa el THI grado ≥ 3 como señal suave, sin derivación fuerte.
- La prueba de disfunción tubaria es la segunda indicación del programa (47 %), pero ningún dato del perfil la predecía: depende de la otoscopía. Por eso hizo falta un instrumento nuevo (P16, ETDQ-7, H8.17) y T1 es sugerida salvo con alergia.
2.2 Lo que el motor v0 no puede enseñar: la terapia de sonido
La elección entre Inducción de filtrado, mMIDST e Inhibición residual no se puede aprender de la cohorte. No porque el perfil no informe, sino porque la etiqueta no varía: en 2025–2026 el programa escribió «terapia sonora» a secas en el 88 % de los pacientes, y la palabra desincronización aparece en cero pacientes con perfil (en 2023–2024 estaba en el 23–32 % de las indicaciones, pero de esos años no hay perfiles). Las AUC de esas filas (0,39–0,56) son ruido.
Dos hallazgos concretos:
- La IR medida en consulta no predice que se indique IR (VPP 0,10). Por eso la «IR fuerte» de las reglas es la respuesta del paciente en la pausa final de la propia terapia en la app (D-RV4), un dato que hasta ahora no existía en ninguna base.
- El 21 % de los pacientes no recibe ningún componente además de consejería y sonido (THI mediana 14, GÜF mediana 5). Es el paciente para quien la regla base, Inducción, es lo que el programa ya hace.
Para mMIDST, el respaldo es externo a la cohorte: el ensayo controlado del proyecto (Henríquez, 2026) y la
señal observacional de Delta_THI_Outcomes/ (108 pacientes, +7,5 puntos de ΔTHI ajustados con TRAC). Por
eso M1 es la única regla de sonido marcada como empírica.
2.3 De dónde salió cada umbral
| Umbral | Valor | Origen | Respaldo |
|---|---|---|---|
| Sesión que cuenta | Inducción ≥ 25 min, mMIDST ≥ 30, o la dosis completa | Audio de Hayo (rango 25–35); Inducción bajó a 25 con su dictado del 2026-10-09 (D-IF1, MindTune_Induccion_de_Filtrado.md §1) | a priori |
| Semana de uso | 7 días o 5 sesiones hechas | D-RV1, lote; las semanas son de Hayo. El motor v0 había propuesto «un mes = 20 sesiones o 28 días» | a priori |
| Núcleo de Inducción | 3 semanas; mMIDST desde la 4.ª (2.ª en severos) | Audio de Hayo | a priori |
| Persistencia | La EVA no bajó 2 o el THI no bajó 7 | D-RV2: la diferencia mínima clínicamente importante del THI (7) y 2 puntos de EVA, los cortes que ya usó Delta_THI_Outcomes/ (73 % de respondedores) | a priori, con cortes del análisis CAS |
| Mejoría clara | La EVA bajó 3 o el THI bajó 20 | Lote | a priori |
| Severo | THI grado ≥ 4 o EVA de hoy ≥ 8 | Reglas §6 | a priori |
| Ft alta | ≥ 1 500 Hz | D-RV3: Hayo dijo «por arriba de 1 000 o 1 500»; se tomó 1 500 | impresión clínica (pendiente RV-P2) |
| Hiperacusia hiperprioritaria | GÜF grado ≥ 2 (11 puntos o más) | D-RV8, Hayo, contra la sugerencia de los datos (ver §3). Los datos se midieron con ≥ 10 puntos (DF-25) | dato para ofrecer; decisión para priorizar |
| Salud mental | Goldberg A ≥ 4 o D ≥ 2 | El umbral del instrumento (Goldberg), no uno ajustado | empírico (OR 23) |
| Kinesiología | Levine positivo | Motor v0 | empírico (OR 57) |
| Audífonos | PTA ≥ 40 dB; o pérdida conocida sin audífonos y ≥ 60 años | Motor v0 | empírico (OR 19) |
| Tubaria | Media del ETDQ-7 sin el ítem 6 ≥ 2,1, o altura + avión | MindTune_Tubaria_P16.md (McCoul y colaboradores, 2012, para el instrumento); D-TU1 saca el ítem 6, que pregunta por el zumbido | práctica del programa (47 %); evidencia externa débil |
| IR sistemática | 10–20 min, 2–3 veces al día | D-RV9, Hayo | a priori |
| Ventanas de R2, R3, Goldberg para Escucharlo | 14 días | Contrato de Insumos | a priori |
| Vigencia de un dato | Dos cadencias | D-PF5-bis (Perfil §5.1) | a priori |
| Ft que cambia | Más de media octava | Perfil §5.2 | a priori |
Los instrumentos (THI de Newman, Jacobson y Spitzer, 1996; GÜF de Nelting y colaboradores; Goldberg; ISI de Morin y de Bastien y colaboradores; ETDQ-7) se usan con sus puntos de corte publicados, tal como los fija el Perfil. Ningún umbral se optimizó sobre los 268 pacientes: no están sobreajustados, pero tampoco se probaron fuera de ese centro.
3. Alternativas consideradas
Las de MindTune_Reglas_v1.md §14, con la misma seriedad que las elegidas. Las tres últimas filas no
son de §14: la de las reglas sobre la terapia en curso es D-HY3 (Recorrido, 2026-09-22); la de la sesión de
30 min viene de la tabla de decisiones del registro del lote (Dosis mínima 30 min); la del modelo
aprendido, de §3 del mismo registro y de Reglas §0 principio 7:
| Alternativa | A favor | En contra | Resultado |
|---|---|---|---|
| Contar «un mes» desde la instalación | Simple | No refleja uso: quien instaló y no usó la app llegaría a mMIDST sin haber hecho Inducción | Descartada (D-RV1) |
| «Persistencia» como «sigue molesto», preguntado | Es lo que dice el paciente | No se puede medir ni comparar | Descartada (D-RV2) |
| Ft alta desde 1 000 Hz | Hayo también lo dijo | Más pacientes a mMIDST sin dato que lo respalde | Descartada (D-RV3); RV-P2 la deja abierta |
| IR fuerte por la IR clínica del equipo | Ya existe en los informes | No predice la indicación (VPP 0,10) | Descartada (D-RV4): queda solo como respaldo sin sesiones |
| Todas las terapias al mismo nivel, sin priorizar | Neutral | Hayo: «grado 4 de 4 antes que grado 2 de 4» | Descartada (D-RV5) |
| El aviso de salud mental una vez, hasta Entendido; o por notificación | Menos insistente / más visible | Una vez se olvida; una notificación invade | Descartada (D-RV6): hoja al abrir cada 14 días, con Ya lo estoy viendo |
Un valor de AccionExterna por especialidad | Más preciso en el código | El enum crece con cada especialidad; el motivo y el id de regla ya lo dicen | Descartada (D-RV7) |
| Hiperacusia: grado 2 ofrecida, grado ≥ 3 primerísimo (lo que sugerían los datos) | Más preciso (VPP 0,90 con grado ≥ 3) | Hayo: «en nuestra experiencia la hiperacusia limita todas las demás terapias» | Descartada (D-RV8): Hayo eligió sensibilidad sobre precisión |
| IR solo como rescate | Más simple | Desperdicia a quien sí responde | Descartada (D-RV9): rescate y sistemática |
| El horario como regla (solo de tarde, etc.) | Aprovecha P05 | Condiciona sin dato; P05 no tiene correlato en la cohorte | Descartada (D-RV10): subtítulo |
| Recomendaciones sin id ni respaldo | Menos campos | No se podría revisar qué regla falló | Descartada (D-RV11) |
| Las reglas sobre la terapia en curso | La app «sabe más» | Interrumpe tratamientos de 12 semanas | Descartada antes (D-HY3); se mantiene |
| Bajar la sesión por defecto a 30 min | Coherente con la dosis mínima | El ensayo usó una hora; 60 sigue siendo la referencia | Descartada para mMIDST: 30 cuenta, 60 por defecto. Para Inducción la reemplazó D-IF1 (2026-10-09): sesión «25 min o más» y la música hasta 60, ajustable (induccion-de-filtrado §3.5) |
| Un modelo aprendido (ML) desde ya | Promete más | No hay datos de la terapia de sonido; aprender del equipo reproduce sus sesgos | Descartada para v1: solo la bitácora y un primer corte (§7) |
4. Decisiones
| id | Fecha | Quién | Qué | Por qué |
|---|---|---|---|---|
| D-RV1 | 2026-10-04 | Lote (Cowork); semanas de Hayo | Semana de uso = 7 días o 5 sesiones hechas; núcleo de 3 semanas; mMIDST desde la 4.ª (2.ª en severos) | Mide uso, no calendario |
| D-RV2 | 2026-10-04 | Lote | Persistencia = EVA no baja 2 o THI no baja 7 | Cortes medibles y ya usados en el programa |
| D-RV3 | 2026-10-04 | Lote | Ft alta ≥ 1 500 Hz | Lo más conservador de lo que dijo Hayo |
| D-RV4 | 2026-10-04 | Lote, con dato | IR fuerte = respuesta en la app | La clínica no predice |
| D-RV5 | 2026-10-04 | Hayo (regla); mapeo del lote | Grado 0–4 por dimensión y prelación fija en empate | Priorizar lo más grave |
| D-RV6 | 2026-10-04 | Hayo (recordatorio); cadencia del lote | Hoja de R2 cada 14 días, Ya lo estoy viendo 56 días | Recordar sin invadir |
| D-RV7 | 2026-10-04 | Lote | Sin valores nuevos de AccionExterna | El motivo especifica |
| D-RV8 | 2026-10-04 | Hayo | GÜF grado ≥ 2 = puerta previa, L1 desde la semana 1 | La hiperacusia limita las demás terapias |
| D-RV9 | 2026-10-04 | Hayo (dosis); alternancia del lote | IR sistemática 2–3 veces al día, 10–20 min; alterna con Inducción si no hay H1 ni M1 | Rescate y uso regular |
| D-RV10 | 2026-10-04 | Lote | Horario como subtítulo | Sin dato para condicionar |
| D-RV11 | 2026-10-04 | Lote | reglaId y evidencia en cada recomendación | Trazabilidad |
| DS §0 regla 6 | 2026-10-04 | Hayo | Nunca peor el remedio que la enfermedad: dosis mínima, sin rachas ni deudas | La exigencia empeora el tinnitus |
| D-IF1 | 2026-10-09 | Hayo | Inducción: dosis útil 25–35 min, línea propia, kDosisMinimaUtil por terapia (Inducción 25, mMIDST 30) | Una hora no era la dosis de Inducción |
| D-RV12 | 2026-10-28 | Hayo | mMIDST para todo tinnitus con Ft desde la semana 4, sin exigir persistencia (M1 v1.1); antes, M-pre la sugiere mejor después de Inducción | «Todo paciente con Ft identificada puede hacer mMIDST, luego de las tres semanas de Inducción» |
| Q1 | 2026-10-28 | Hayo | Se retiran M1-ft-alta y M1-ft-baja (y el corte de 1 500 Hz, D-RV3, RV-P2) | «Borra lo de los 1 000 Hz» |
| D-RV13/14 | 2026-10-28 | Hayo | Máximos por terapia como sugerencia; al menos una sesión al día, como texto, no como contador | Las máximas son sugerencias |
| D-RV15 | 2026-10-28 | Lote (recomendada) | Con ≥ 2 recomendadas, L1 = la de sesión hecha más antigua; hiperacusia siempre L1; R-sist deja de alternar por día (reemplaza la alternancia de D-RV9) | «Ir ciclando, la que no has hecho primero» |
| D-RV16 | 2026-10-28 | Lote (recomendada; Q-H6 sin respuesta de Hayo) | En Hoy, «en curso» cede ante el ciclo solo con ≥ 2 recomendadas (estrecha D-HY3) | Sin esto el ciclo nunca se vería |
| D-RV18 | 2026-10-28 | Hayo (el qué) | H1-IR: una IR que subió manda hiperacusia primero y saca la IR, por 56 días | «Si aparece kindling … se priorice el manejo de hiperacusia» |
| D-R1H1 | 2026-11-01 | Hayo | Con H1, mMIDST recomendada (M1) solo con ≥ 10 sesiones hechas de hiperacusia y ≥ 14 días desde la primera; antes, Por ahora no con el motivo de cuándo se activa (R.1; el estado lo fijó el orquestador por delegación) | «mMIDST se activa como recomendación 2 semanas luego de sesiones efectivas de hiperacusia (2 semanas y al menos 10 sesiones)» |
Decisiones del código (no las dice el normativo; cada una comentada en reglas_v1.dart o en el archivo
que la toma, y declarada en su informe): la Ft es la en uso; precedencia H1 > M0 > M1 > B0, con el ciclo
entre las recomendadas (v1.1); M0 sin secundarias; con H1, mMIDST entra a las recomendadas como M1 al cumplirse
D-R1H1 —sin pedir la semana 4 ni la severidad— y antes queda Por ahora no con su motivo; con H1 la Ft se pide
desde los 7 días de hiperacusia (R.1;
reemplaza la decisión de H8.20); M-pre y R-sin-dato fuera del ciclo; irNula exige dos respuestas de la app; evaActual
son las dos últimas de después de la basal; Respirar lento siempre con H1; P4 «de noche» = 20:00–05:00;
P6 hasta hacerla una vez; P5 y P8 en las posiciones 3-bis y 3-ter de Siguiente para ti; las guías al
final del apoyo; lo que sube va sin R3.
5. Consecuencias
- Hoy cambia de dueño en el perfil completo: con N de N y vigente, L1 sale de las reglas si no hay equipo ni terapia en curso; aparecen la tarjeta externa, la fila SOS, la Pausa de L3 y el subtítulo de horario.
- La lista de ids es un contrato: viaja en la bitácora, el servidor la valida y un test la compara con esta documentación. Renombrar una regla obliga a tocar los cuatro lugares.
- La privacidad de R3 manda sobre el registro: lo que sube se calcula como si R3 no existiera.
- El seguimiento por instrumento existe por las reglas: sin EVA semanal no hay persistencia, sin THI periódico no hay mejoría clara, sin re-medir la Ft mMIDST podría sonar con un tono que ya cambió.
- P16 entró a N (D-TU2): quien tenía el perfil completo pierde las reglas en Hoy hasta responderla (DF-29).
6. Límites conocidos y riesgos
- Concordancia no es efectividad. El motor v0 mide cuánto se parece una regla a lo que el equipo hace, no si al paciente le va mejor. Aprender del equipo reproduce sus sesgos (p. ej. a más hipoacusia, menos hiperacusia indicada: ¿mecanismo o costumbre?).
- Un centro, una época, 268 pacientes. Levine falta en el 19 % de los informes. Las categorías de sonido son mínimas (IR 23, TRAC 10 pacientes).
- Toda la capa de terapias de sonido es a priori, salvo M1. Las semanas, la persistencia, el ciclo y los 56 días de subió son criterio clínico, no hallazgo.
- H1 por grado 2 recomienda hiperacusia a pacientes a quienes el equipo solo se la indicó al 43 %. Es una decisión consciente de Hayo; se revisa con datos propios.
- M1-ft-alta se retiró en la versión 1.1 (Q1, Hayo): DF-23 queda cerrado. En su lugar, M-pre sugiere mMIDST mejor después de Inducción a todo paciente con Ft antes de la semana 4.
- El ciclo cambia L1 cada día cuando hay dos o más recomendadas, aunque haya una en curso (D-RV16, recomendada del lote, retirable). Si en el iPhone se siente como un vaivén, se vuelve a D-HY3 entera.
- Un día malo mueve L1: con EVA de hoy ≥ 8, M1-precoz puede poner mMIDST ese día y no el siguiente. Pendiente de decisión (INFORME_H8.3b §5).
- A1 deriva aunque el paciente ya use audífonos si el PTA es ≥ 40. Pendiente de decisión.
- La hoja de R2 corre con una lectura provisional (DF-26). Pendiente de decisión de Hayo, que además juzga si se siente cuidado o insistencia (si insistencia, 21 días).
- Los
motivoson borrador (RV-P1) y el mapeo de grados (RV-P3, sobre todo somatosensorial y audición) está por confirmar. - El ISI está apagado (licencia, Q-RD1): P2, P4 y el grado de sueño por ISI no se ejercitan.
- El ETDQ-7 se muestra con una traducción de trabajo y el permiso de uso pendiente (TU-P1, TU-P2).
- Nada de esto se ha visto en un iPhone todavía (los -bis de H8.3-b, H9.9, H8.16, H8.17 y H10.1).
7. Qué revisar y cuándo
- Con 50 pacientes con 6 semanas o más de uso (Reglas §11): repetir el análisis del motor v0 de forma
prospectiva — terapia recibida × perfil × ΔEVA/ΔTHI — con
recomendacion.emitida,sesion.fin,sesion.respuesta_inhibicion,seguimiento.*y las series de EVA y THI. Lo primero que se ajustaría: D-RV1 a D-RV3 y D-RV8. - Modo sombra:
recomendacion.difiere_equipocuenta cada vez que la indicación del equipo y la regla no coinciden; es el contraste del motor v0 §3 hecho hacia adelante. - Cuando Hayo conteste RV-P1, RV-P2 y RV-P3, y las pendientes de §6: actualizar el normativo primero, después el código y estas páginas.
- Si se enciende el ISI: revisar P2, P4, el grado de sueño y la decisión pendiente sobre el perfil «N de N» (P-H8.17-1) antes, porque el ISI también entra a N.
- Si se agrega una regla: id nuevo en
kReglasV1, enREGLAS_V1del servidor y una fila en la tabla de Cómo funciona; el test de DOC.3 falla mientras falte alguna.
8. Historia
- H8.15 (
b347090): seguimiento por instrumento (cadencias.dart), la hoja de la EVA, la Ft re-medida.INFORME_H8.15_Seguimiento_periodico.md. - H8.3-b (
793aa62):reglas_v1.dart, las 30 reglas, Hoy y Recomendaciones, la bitácora y la validación del servidor. Seis contradicciones declaradas.INFORME_H8.3b_Reglas_v1.md. - H9.9 (
90436f2): los insumos entran por parámetro; P2–P7 y S4 en pantalla; la hoja de R2; lo que sube va sin R3.INFORME_H9.9_Insumos_en_Hoy.md. - H8.16 (
3c4a57c): la dosis mínima y la máxima nunca peor el remedio; P8 con su lección.INFORME_H8.16_Dosis_y_maxima.md. - H8.17 (
240ca57): P16 y T1.INFORME_H8.17_P16_Tubaria.md. - H10.1 (
a420c84): las guías de Mandíbula y cuello para K1, K2 y P5; K2 fuerte con peor.INFORME_H10.1_Somatosensorial.md. - DOC.3 (2026-10-05): estas dos páginas, el flujograma en el sitio y el test que ata los ids.
- Antes: H8.3-a (
c33900a, el orquestador de Hoy y el hueco de las reglas), el motor v0 (2026-10-02).