Guia de Copy y Contenido: ADEN

Referencia definitiva de escritura para toda persona que cree contenido en la plataforma ADEN. Aplica a interfaces (UI), notificaciones, correos, onboarding, reportes de salud y cualquier comunicación que llegue al usuario final.

1. Voz de Marca: ADEN

Arquetipo

ADEN combina dos arquetipos de Carl Jung:

La mezcla produce una voz única: protección informada. ADEN sabe, y porque sabe, cuida.

Personalidad en una frase

“Como un amigo que sabe de salud: te explica con calma, te da contexto, te acompaña.”

Cinco atributos de voz

Lo que ADEN nunca es

• Clínica. No suena como un sistema hospitalario.
• Condescendiente. No asume que el usuario no entiende.
• Alarmista. No usa mayúsculas, urgencia falsa ni colores de pánico.
• Genérica. Cada mensaje se siente escrito para esa persona, no para “el usuario promedio”.

2. Matriz de Tono por Contexto

El tono de ADEN se ajusta según la situación emocional del usuario. La voz permanece constante; el tono cambia.

Como usar la matriz

1. Identificar el contexto emocional del usuario.
2. Ajustar calidez y formalidad según la tabla.
3. Redactar el mensaje.
4. Verificar que la urgencia no sea mayor a la indicada.

3. Principios de Escritura (8 Reglas)

Regla 1: Persona primero, dato después

El usuario es más importante que el número.

Regla 2: Acción sobre información

Todo mensaje debe incluir qué hacer. Informar sin orientar genera ansiedad.

Regla 3: Framing positivo siempre

Construir desde la abundancia, la posibilidad y el progreso. Nunca desde el problema, la carencia o el miedo.

Regla 4: Corto sobre largo

Si puedes decirlo en 5 palabras, no uses 15. Máximo 15-20 palabras por oración.

Regla 5: Específico sobre genérico

Los detalles generan confianza. Lo genérico genera desconfianza.

Regla 6: Empatico sobre neutral

Reconocer la emoción del usuario antes de dar la información.

Regla 7: Colombiano sobre genérico

Escribir en español colombiano. No en español de España ni en español neutro de manual.

Regla 8: Informal sobre formal

ADEN habla como amigo informado, no como institución.

4. Glosario Médico → ADEN

Nunca usar jerga médica sin traducir. La siguiente tabla es obligatoria.

Regla general

Si un termino no está en esta tabla, aplicar la prueba: “Si le digo esto a mi mama, entiende?” Si la respuesta es no, traducir.

5. Plantillas de Microcopy

5.1 Mensajes de Error

Formula: [Que paso] + [Por qué] + [Como resolver]

Ejemplo 1 — Fallo de conexión:

No pudimos cargar tu información. Puede ser tu conexión a internet. Verifica tu Wi-Fi e intenta de nuevo.

Ejemplo 2 — Fallo al guardar:

Tu check-in no se guardo. Algo fallo de nuestro lado. Intenta de nuevo en unos segundos.

Ejemplo 3 — Sesión expirada:

Tu sesión se cerro por seguridad. Inicia sesión de nuevo para continuar donde ibas.

Ejemplo 4 — Archivo no soportado:

Ese formato no es compatible. Sube tu archivo en PDF o imagen (JPG, PNG).

Nunca escribir:

• “Error 500”, “Error 404”, “Internal Server Error”
• “Ha ocurrido un error inesperado”
• “Algo salió mal” (sin contexto ni solución)

5.2 Estados Vacios

Formula: [Que falta] + [Por qué está vacio] + [Qué hacer]

Ejemplo 1 — Sin exámenes:

Aun no tienes exámenes. Carga tus laboratorios para ver tu salud personalizada.

Ejemplo 2 — Sin citas:

No tienes citas agendadas. Puedes agendar una con tu médico o tu health coach.

Ejemplo 3 — Sin historial:

Tu historial empieza aquí. Cuando completes tu primer check-in, veras tu progreso.

Ejemplo 4 — Sin notificaciones:

Todo al dia. Cuando haya novedades, apareceran aquí.

5.3 Mensajes de Éxito

Formula: [Que se logró] + [Por qué importa] + [Que sigue]

Ejemplo 1 — Check-in completado:

Check-in completo. Llevas 23 días consecutivos. Mañana a las 8am te recordamos.

Ejemplo 2 — Cita agendada:

Cita confirmada con la Dra. Lopez, martes 10am. Te enviaremos un recordatorio el día anterior.

Ejemplo 3 — Exámenes cargados:

Exámenes cargados. En unos minutos tu equipo de salud los revisara y podras ver tus resultados.

Ejemplo 4 — Perfil completado:

Perfil listo. Ahora podemos personalizar tus recomendaciones. Ve a Inicio para ver tu plan.

5.4 Estados de Carga

No usar “Cargando…” genérico. Cada contexto tiene su propio mensaje.

6. Reducción de Ansiedad en Salud

Principio central

La salud genera ansiedad. ADEN existe para reducirla, no para amplificarla. Cada palabra que el usuario lee sobre su salud tiene peso emocional. Escribir con esa responsabilidad.

Tabla de Reframing

Palabras prohibidas sin contexto

Nunca usar estas palabras de forma aislada. Si es medicamente necesario comunicar urgencia, siempre acompañar con contexto y siguiente paso.

• ALERTA
• ANORMAL
• NO OPTIMO
• URGENTE
• CRITICO
• PELIGRO
• RIESGO ALTO
• MAL / MALO

Tres reglas de oro para resultados de salud

1. Siempre dar contexto. “Tu glucosa subió” no es suficiente. Agregar: por qué puede ser, que tan común es, que puede hacer.
2. Siempre dar siguiente paso. Nunca dejar al usuario con un dato y sin acción.
3. Siempre tranquilizar cuando sea apropiado. Si algo es común o tiene solución sencilla, decirlo.

Copy por escenario de resultados de laboratorio

Resultado normal:

Tu glucosa: 92 mg/dL
Estado: En rango óptimo
Tu tendencia de los últimos 90 días se ve bien.

Resultado ligeramente fuera de rango:

Tu glucosa: 118 mg/dL
Estado: Ligeramente por encima de tu rango
Esto puede deberse a alimentación reciente o estrés.
[Ver que puedes hacer]  [Hablar con Health Coach]

Resultado que necesita atención:

Tu glucosa: 142 mg/dL
Tu nivel necesita atención. Tu equipo de salud ya fue notificado.
Te recomendamos agendar una cita para revisar esto juntos.
[Agendar cita]  [Chatear ahora]

Resultado pendiente:

Tus exámenes estan siendo procesados.
Recibiras una notificación cuando esten listos (aprox. 30 minutos).

7. Copy de Notificaciones

7.1 Recordatorios

Tono: amigable, específico, breve. No genérico.

7.2 Resultados listos

Tono: curioso, invitador. Generar anticipación positiva, no ansiedad.

7.3 Celebración de racha

Tono: cálido, motivador. Conectar esfuerzo con resultado.

7.4 Racha interrumpida

Tono: compasivo, sin culpa, sin vergUenza. Nunca confirmshaming.

7.5 Alertas que requieren atención

Tono: claro, accionable, calmado. Nunca inducir pánico.

8. Reglas de Español Colombiano

Tratamiento

• Usar “tu” (tuteo). No “usted”, no “vos”.
• Excepción: comunicaciones legales o regulatorias pueden usar “usted” si es requerido.

Datos de prueba y mocks

• Ciudad por defecto: Medellín
• Nombre por defecto: María
• Nunca usar ciudades o nombres de otros paises en mocks.

Vocabulario

Jerga médica

• Nunca usar terminos médicos sin explicación. Ver Sección 4 (Glosario).
• Si un termino médico debe aparecer (ej. en un PDF para el doctor), agregar explicación entre parentesis.

Lenguaje centrado en familia

Cuando sea apropiado, incluir referencias a la familia. En la cultura colombiana, las decisiones de salud frecuentemente involucran al nucleo familiar.

Usar con moderación. No en cada mensaje, pero si en momentos clave (onboarding, logros importantes, resumen anual).

Evitar absolutamente

• Confirmshaming: “Realmente quieres dejar tu salud?” / “Prefiero no cuidarme”
• Humor que minimiza: “Ups, parece que olvidaste tu salud”
• Spanglish innecesario: Usar “retroalimentación” en vez de “feedback” en textos formales. “Feedback” es aceptable en contextos internos o de producto.

9. Jerarquía de Contenido

Titulos (Headlines)

• 3 a 7 palabras.
• Orientados a acción o a estado.
• Sin puntos al final.

Cuerpo (Body)

• Máximo 2 oraciones por parrafo.
• Máximo 15-20 palabras por oración.
• Voz activa siempre. “Toma tu suplemento”, no “El suplemento debe ser tomado”.

Llamados a acción (CTAs)

• Verbo primero.
• Máximo 3-4 palabras.
• Específicos, no genericos.

Labels (Etiquetas)

• Máximo 3 palabras.
• Sustantivos o sustantivo + adjetivo.

Tooltips

• Una sola oración.
• Explican, no repiten.

10. Anti-Patrones

Copy que causa ansiedad

Estos patrones deben eliminarse de todo contenido ADEN.

Copy que destruye confianza

Copy que aliena

Copy Comercial y Marketing

Esta sección extiende la voz de marca (Sabio + Cuidador) al territorio comercial: landing pages, redes sociales, investor decks y cualquier comunicación externa. Todo copy comercial debe pasar por el framework AIRE y el Test de los 3 Segundos antes de publicarse.

Para la narrativa completa de marca con los 6 pilares, ver design/product/narrative.

Claims Validados (Seguros de usar)

Claims que pasaron auditoria científica y regulatoria. Usar con confianza:

Claims Prohibidos (NO usar)

Copy por Canal

Landing Page:

• Hero: Pilar 1 (Velocidad) o Pilar 3 (Calibración Latina) como gancho
• Subhero: Pilar 4 (Integración) como explicación
• Social proof: números del engine (323 colisiones, 100% plausibilidad)
• CTA: “Conoce tu salud real”

Redes Sociales:

• Stats visuales: “1,620 cruces en <5ms” con infografia
• Stories de pacientes (use cases): “María tenía fatiga. 4 médicos dijeron estrés. ADEN encontró ferritina en 9.”
• Educational: “Sabias que el 77.7% de las interacciones gen-fármaco son invisibles sin análisis genómico?”

Investor Deck:

• Lead con Pilar 5 (Honestidad): “Auditamos nuestros propios claims”
• Show Pilar 2 (Seguridad): “La IA miente. Nuestro engine la atrapa.”
• Close con Pilar 3 (Calibración): “650 millones de personas merecen medicina calibrada para su biología”

App UI (paciente):

• Nunca mencionar ms, AUC, o stats técnicos
• Traducir a impacto personal: “Tu equipo ya tiene tu información” (no “procesamos 1,620 cruces”)
• Protocolo anti-nocebo: “Hay un cambio que conviene revisar” (no “ALERTA CRITICA”)

Referencia Rápida

Framework AIRE para Copy de Marca

Cada pieza de copy de marca (no UI) debe pasar por:

• Aspiracional: Conecta con el “yo ideal” del usuario.
• Inspiradora: Provoca acción desde emoción positiva.
• Resonante: Usa el lenguaje del usuario, no el de la marca.
• Escalable: Funciona en un tagline y en un parrafo.

Test de los 3 Segundos

Antes de aprobar cualquier copy, verificar:

1. Genera una emoción positiva inmediata?
2. Se entiende sin contexto adicional?
3. Suena como algo que ADEN diria naturalmente?

Checklist Final de Contenido

• [ ] Cero palabras que causan ansiedad sin contexto
• [ ] Persona primero, dato después
• [ ] Siguiente paso claro en todo mensaje de salud
• [ ] Español colombiano, tuteo
• [ ] Máximo 15-20 palabras por oración
• [ ] Terminos médicos traducidos (ver glosario)
• [ ] Sin confirmshaming
• [ ] Sin superlativos vacios
• [ ] Sin humor sobre salud
• [ ] CTAs con verbo primero, max 3-4 palabras

Fuentes

Este documento consolida información de:

• design/research/07-ux-copy-strategy — Investigación de UX copy, voz, glosario, microcopy
• .claude/skills/copy-branding/SKILL — Skill de branding copy, framework AIRE
• .claude/skills/copy-branding/references/arquetipos — Arquetipos de marca (El Sabio + El Cuidador)
• .claude/skills/copy-branding/references/psicologia-color — Psicologia del color aplicada a copy
• docs/agents/copy — Guia editorial para contenido técnico-médico
• Principios de “Calm UX” (UXmatters 2025)
• CDC Clear Communication Strategies
• AMA Health Literacy Guidelines