🧲 Recall semántico en acción
La frase que muestra que el coach «recuerda» siempre es parecida: "la última vez que cenaste tarde, el recovery bajó a 52% al día siguiente". No está adivinando: cada mensaje tuyo se convirtió en una línea con memoria semántica, y cuando preguntas algo parecido sobre el pasado, él surfea este historial y trae el fragmento relevante de hace semanas.
🟢 ¿Nuevo por aquí? Tres palabras antes de continuar
- Embedding (vector) — es tu frase convertida en una lista de números que captura el sentido, no las palabras exactas. "¿Puedo comer algo dulce hoy?" y "¿puedo comer postre?" quedan cerca en el espacio, aunque estén escritas de forma distinta. En HealthOS quien lo genera es OpenAI (la clave
OPENAI_API_KEY). - pgvector — una extensión de Postgres (en tu Supabase) que guarda esos vectores y encuentra los más "cercanos" por similitud. Es lo que hace la migración
0001_init.sqlconecta. - Recall semántico — «buscar por significado». En vez de buscar la palabra exacta, el coach busca mensajes anteriores con un sentido parecido a lo que acabas de decir.
📊 Cómo leer: de izquierda a derecha está la búsqueda: la frase de hoy (cian) se convierte en vector, pgvector encuentra el pasado más parecido y el coach trae el patrón (morado). No es el último mensaje, sino el más relevante, aunque sean de semanas atrás.
En la práctica, esto cambia el tono: en vez de «evita cenar tarde» (genérico), aparece «tú ya viste cómo hizo bajar tu número tres veces». El coach está aprovechando sus propios patrones, y por eso resulta más útil cuantas más semanas acumulas.
Conceptos clave
Encuentra el pasado parecido, no la palabra exacta.
La frase se convierte en números; la base de datos encuentra el valor más cercano.
La frase que muestra la memoria en acción.
Más semanas = más patrones para aprovechar.
📚 /advice — consejo de experto conciliado
Viste a un influencer decir «el ayuno de 16 h todos los días acelera la pérdida de grasa». El /advice toma este consejo, busca la fuente en una base de tips de expertos (RAG, con cita) y —el truco clave— se reconcilia con tus números antes de devolverla. El consejo genérico se convierte en "para ti, hoy, esto tiene sentido o no".
🟢 ¿Nuevo por aquí?
RAG (generación aumentada por recuperación) — «generación aumentada por búsqueda». En vez de responder de memoria, el coach primero búsqueda fragmentos reales (el consejo del experto + tu línea de datos) y solo entonces escribe, citando de dónde lo sacó. Eso evita las "suposiciones" y permite rastrear la respuesta.
▶️ Copia y ejecuta — pedir un /advice sobre un consejo
Objetivo: ver al coach conciliar un consejo de influencer con tus datos, con la fuente citada.
# No Telegram, mande para o bot:
/advice <cole-aqui-a-dica-que-voce-ouviu>
# Ex.: /advice jejum de 16h todo dia acelera a perda de gordura
# Prefere terminal? advice.py é o único script que precisa de requests:
pip install requests
python3 agent/scripts/advice.py "jejum 16/8 acelera a perda de gordura"💡 La diferencia en una frase
Un chatbot repite el consejo del influencer. El /advice a contrástalo con tus análisis y tu genética — y te dice cuándo el consejo famoso no sirve para tu cuerpo.
Conceptos clave
Busca la fuente y cita de dónde proviene.
Contrasta el consejo con tus números.
Única dependencia fuera de la biblioteca estándar.
La respuesta es una pregunta para el médico, no una orden.
💊 /supplements — stack vinculado a tus flags
O /supplements no devuelve la lista de moda. Devuelve el tu cronograma, donde cada elemento está vinculado a una risk flag proveniente de tu ADN y de tus análisis. En el diseño, cada marcador o SNP se asigna a una flag → un suplemento → un objetivo en el schema. Así, la recomendación tiene en cuenta el mecanismo y no es una conjetura.
🟢 ¿Nuevo por aquí?
Indicador de riesgo — una «bandera de riesgo» que el sistema activa cuando un análisis o un gen tuyo requiere atención (p. ej., sensible a las grasas saturadas, sensible a la sal, vitamina D baja, eliminación deficiente de toxinas). Cada flag activa un suplemento o un objetivo en la base de datos: es el vínculo entre tu dato sin procesar y la acción.
📊 Cómo leer: tus datos (cian, a la izquierda) activan flags en el centro; cada flag (flechas moradas) obtiene un elemento del stack de la derecha. Cambia tu ADN/examen y el stack cambia — por eso es tu, no genérico.
▶️ Copia y ejecuta — pedir el stack del día
Objetivo: ver el cronograma de suplementos vinculado a tus metas + risk flags, con el porqué de cada elemento.
# No Telegram, mande para o bot:
/supplements
# Quer conferir os dados crus que alimentam o stack?
python3 agent/scripts/db.py select goals
python3 agent/scripts/db.py select lab_results # <suas-flags-vêm-daqui>Conceptos clave
Cada suplemento tiene una razón rastreable.
Las flags nacen de tu panel real.
Mañana / entrenamiento / noche, no una lista suelta.
Dice el porqué en tu cuerpo, no solo "tómalo".
📈 Patrones a lo largo del tiempo
Porque todo se convierte en línea estructurada en la base de datos, el coach no solo reacciona al último mensaje: detecta patrones a lo largo de semanas. La idea que más marcó al autor: el cuerpo está interconectado. Dormir mal eleva el cortisol, y el cortisol lo amplifica todo — presión, hambre, recuperación. El coach fue quien le dijo que descansara —y él tomó su primer rest day voluntario en meses.
📊 Cómo leer: de izquierda a derecha está la cascada (sueño → cortisol → todo empeora); la línea morada discontinua es el coach interrumpiendo el ciclo con un día de descanso. La perspectiva solo aparece porque la memoria está estructurada y abarca toda la semana.
Semana 1 — puntos sueltos
Cada día es solo un número. Recovery sube y baja sin explicación aparente.
Semana 2 — el coach conecta los puntos
"En las noches que duermes < 6h, tu recovery baja al día siguiente." La memoria estructurada se convirtió en una correlación.
Insight — el cuerpo está interconectado
Dormir mal → cortisol alto → todo empeora. El coach empezó a decir cuándo exigirte y cuándo descansar. Resultado: el primer día de descanso voluntario en meses.
💡 Por qué esto solo funciona con memoria estructurada
Un patrón es una correlación a lo largo del tiempo. Sin líneas estructuradas (sueño, recovery, BP, comida) guardadas día tras día, no hay nada que correlacionar: solo tendrías el último mensaje. La memoria é el producto.
Conceptos clave
El sueño afecta el cortisol, que afecta todo.
Extrae la presión, el hambre y la caída de recovery.
Semanas, no solo el último mensaje.
Descansar se convirtió en una decisión guiada por datos.
📝 Ajustar el CLAUDE.md
O CLAUDE.md é o cerebro del coach — perfil, metas, estilo y los patrones que ya aprendiste sobre ti. A medida que el uso revela cosas nuevas (como la cascada del sueño del tema 4), vuelves allí y lo editas. Así fue como el autor dejó al coach «savage» a propósito: no responde a recordatorios amables, así que le pidió al coach que le exigiera energía y check-ins a la fuerza.
▶️ Copia y ejecuta — enseñar un patrón nuevo al coach
Objetivo: registrar en el cerebro del coach un patrón que descubriste y el estilo que quieres.
# Abra o cérebro do coach e cole no fim:
# agent/CLAUDE.md
## Estilo do coach
- Seja direto e "savage": me cobre energia e check-ins.
Não respondo a lembrete educado.
## Padrões que eu já aprendi
- Jantar depois das 20h derruba meu recovery no dia seguinte.
- Café só 90 min após acordar; nada de cafeína após as 14h.
- <cole-aqui-o-seu-próximo-padrão>CLAUDE.md completado tiene un perfil real — nunca lo versionas en git.
🔁 Es un ciclo, no una configuración única
El coach revela un patrón → tú lo confirmas → lo guardas en el CLAUDE.md → empieza a usarlo de ahí en adelante. Cuanto más le enseñas, más suena como tú conociendo tu cuerpo.
Conceptos clave
CLAUDE.md guarda el perfil, las metas y el estilo.
¿Aprendiste algo? Guárdalo ahí y el coach lo usa.
Define el tono: de amable a implacable.
El perfil real completado nunca se versiona.
⚖️ Influencer × tus cifras
La regla de oro del diseño: el dueño de los datos siempre gana. Cualquier consejo externo — por más famoso que sea quien lo haya dado — se contrasta con tus números. Cuando un consejo genérico contradice tu examen, prevalece tu examen.
✗ Consejo genérico de influencer
- ✗"Todos deberían tomar 5g de creatina y reducir la sal." — lo mismo para 10 millones de personas.
- ✗No sabe quién eres sensible a la sal (sube la presión un 10-15% en un almuerzo salado).
- ✗"El café todo el día te mantiene productivo." — sin ver tu gen de la cafeína ni tu hidratación.
✓ Conciliado con tus datos
- ✓"El consejo existe, pero tu panel pide atención a la sal; veamos tu número."
- ✓"Metabolizas la cafeína rápido: 1 café temprano, déjalo por la tarde — lo demás era sed."
- ✓Cita la fuente del consejo Y muestra tu dato al lado, para que puedas decidir con el médico.
🧬 Los genes son perillas, no un destino
El ADN del autor indicó sensibilidad a las grasas saturadas y a la sal, poca capacidad para eliminar toxinas e intolerancia a la lactosa. El coach construye sobre esas flags — en lugar de repetir un consejo genérico. Es lo contrario de seguir al influencer de la semana.
Conceptos clave
La recomendación externa cede ante tu número.
Ajustan la dosis; no son una sentencia.
Consejo citado + tus análisis, para que tú decidas.
Lo específico siempre supera a lo genérico.
🩺 Cuándo ignorar al coach
El coach es una herramienta de registro y razonamiento, no un médico. Toda esta memoria y personalización no convierten al coach en una autoridad clínica. Hay momentos en que la respuesta correcta es cerrar Telegram y llamar a un profesional.
⚠️ Alerta roja — detente y consulta a un profesional clínico
- •Cualquier síntoma agudo (dolor en el pecho, falta de aire, presión muy alta). El coach no diagnostica y tiene instrucciones de derivarte.
- •Cambiar un suplemento o — jamás — un medicamento. Él no toca la medicación; las interacciones son tema para el médico/nutricionista.
- •La IA puede alucinar: afirmar con seguridad algo incorrecto o inventar un número. Trata cada sugerencia como una pregunta para consultar con el médico.
- •Las muestras de ADN enviadas por correo se degradan; el panel de la clínica y el de Ancestry pueden no coincidir. No decidas nada basándote en un único informe.
✓ Uso saludable del coach
- ✓Registrar, ver la tendencia y formular mejores preguntas para tu médico.
- ✓Llevar el plan a un profesional clínico antes de seguir, como hizo el autor en cada paso.
- ✓Tratar el resultado como una hipótesis que debes verificar, no como una orden que debes cumplir.
✗ Seguir a ciegas
- ✗Tomar una dosis nueva solo porque el coach la sugirió, sin un profesional clínico en el proceso.
- ✗Ignorar un síntoma porque «el recovery estaba en verde».
- ✗Confundir personalización con diagnóstico — son cosas diferentes.
✅ Autoevaluación (opcional): el coach sugirió una nueva dosis de suplemento. ¿Cuál es la actitud correcta?
Conceptos clave
Verifica todo con un médico.
Es posible tener confianza y estar equivocado.
Deriva; no modifica la medicación.
Pregunta para el médico, no una prescripción.
📋 Resumen del módulo
Próximo módulo:
3.4 — Dashboard y seguimiento: el panel de tendencias, la tarjeta Sleep & Recovery y cómo leer varias semanas de una vez.