docs/brand_guidelines.es.md

OncoAgent — Manual de Marca

Versión: 1.0 · Fecha: 2026-05-05 · AMD Developer Hackathon 2026

---

1. Esencia de Marca

1.1 Declaración de Misión

OncoAgent democratiza la inteligencia clínica oncológica. Construimos sistemas de IA de código abierto, con privacidad como prioridad, que empoderan a los médicos de atención primaria con triaje oncológico basado en evidencia — fundamentado en guías NCCN/ESMO, ejecutándose localmente en hardware AMD Instinct™ MI300X.

1.2 Promesa de Marca

"En medicina, decir 'no sé' es más seguro que adivinar."

Cada recomendación es trazable. Cada fuente es citada. Cada alucinación es bloqueada. OncoAgent entrega transparencia radical en IA clínica.

1.3 Pilares de Marca

Pilar	Descripción
Seguridad Clínica	Política de cero alucinaciones. Puertas anti-fabricación en cada nodo.
Transparencia Radical	Cada recomendación muestra su fuente, página y nivel de confianza.
Código Abierto	100% open-source. La inteligencia que salva vidas pertenece a la humanidad.
Privacidad Primero	Se ejecuta localmente en AMD MI300X. Cero datos del paciente salen del hospital.
Basado en Evidencia	Fundamentado exclusivamente en guías clínicas revisadas por pares NCCN/ESMO.

1.4 Personalidad de Marca

OncoAgent habla como un colega clínico de confianza — no un chatbot, no un motor de búsqueda.

• Autoritativo — Respaldado por guías oncológicas revisadas por pares
• Transparente — Siempre muestra su trabajo y admite incertidumbre
• Preciso — Lenguaje de grado clínico, cero ambigüedad
• Humilde — Se niega a responder cuando la evidencia es insuficiente
• Compasivo — En última instancia, sirve a los resultados del paciente

1.5 Opciones de Eslogan

Contexto	Eslogan
Principal	"Inteligencia Clínica. Código Abierto. Cero Alucinaciones."
Técnico	"RAG SOTA. Inferencia Local. Oncología Basada en Evidencia."
Emocional	"Porque cada hora cuenta en oncología."
Hackathon	"Democratizando la Oncología con AMD Instinct™"

---

2. Identidad Visual

2.1 Concepto del Logo

El logo de OncoAgent combina tres elementos simbólicos:

1. Hélice de ADN — Representa el dominio biológico/oncológico
2. Nodos de Red Neuronal — Representa la arquitectura multi-agente de IA
3. Contorno de Escudo — Representa la seguridad clínica y la protección del paciente

Marca Gráfica: Una doble hélice estilizada fusionándose con nodos neuronales interconectados, encerrada en una silueta sutil de escudo.

Marca Tipográfica: "OncoAgent" en Outfit Bold, con "Onco" en Teal Primario y "Agent" en Azul Medianoche.

2.2 Reglas de Uso del Logo

✅ Hacer	❌ No Hacer
Usar sobre fondos sólidos (blanco, navy, oscuro)	Estirar, rotar o sesgar el logo
Mantener espacio libre mínimo (1x altura del logo)	Colocar sobre fondos fotográficos cargados
Usar la versión monocromática en fondos oscuros	Cambiar los colores del logo arbitrariamente
Escalar proporcionalmente	Agregar sombras o efectos

---

3. Sistema de Color

3.1 Paleta Primaria

Token	Hex	RGB	Uso
Teal Primario	#0D9488	13, 148, 136	Botones, enlaces, estados activos
Teal Oscuro	#0F766E	15, 118, 110	Estados hover, encabezados
Teal Claro	#5EEAD4	94, 234, 212	Destacados, insignias, etiquetas

3.2 Paleta Secundaria

Token	Hex	RGB	Uso
Azul Medianoche	#0F172A	15, 23, 42	Fondos, texto, encabezados
Pizarra	#334155	51, 65, 85	Texto secundario, bordes
Acero	#64748B	100, 116, 139	Leyendas, marcadores de posición

3.3 Colores de Acento y Semánticos

Token	Hex	Uso
Ámbar Esperanza	#F59E0B	Destacados, CTAs, esperanza
Éxito	#22C55E	Validado ✅ — Resultados seguros
Error	#EF4444	Rechazado ❌ — Alucinación detectada
Advertencia	#F97316	Confianza baja ⚠️ — Requiere revisión

3.4 Accesibilidad de Color

Todas las combinaciones de color deben cumplir con las ratios de contraste WCAG 2.1 AA:

• Texto normal: Mínimo 4.5:1
• Texto grande: Mínimo 3:1
• Componentes UI: Mínimo 3:1

---

4. Tipografía

4.1 Stack de Fuentes

Rol	Familia	Peso	Respaldo
Encabezados	Outfit	Bold (700), SemiBold (600)	system-ui, sans-serif
Cuerpo	Inter	Regular (400), Medium (500)	system-ui, sans-serif
Monoespaciado	JetBrains Mono	Regular (400)	monospace
Términos Médicos	Inter	Medium Italic (500i)	system-ui, sans-serif

4.2 Escala Tipográfica

Nivel	Tamaño	Peso	Altura de Línea	Uso
H1	48px / 3rem	Outfit Bold	1.1	Títulos de página
H2	36px / 2.25rem	Outfit SemiBold	1.2	Encabezados de sección
H3	24px / 1.5rem	Outfit SemiBold	1.3	Subsecciones
H4	20px / 1.25rem	Inter Medium	1.4	Encabezados de tarjeta
Body	16px / 1rem	Inter Regular	1.6	Texto de párrafo
Caption	14px / 0.875rem	Inter Regular	1.5	Etiquetas, metadatos
Small	12px / 0.75rem	Inter Medium	1.4	Insignias, notas al pie
Code	14px / 0.875rem	JetBrains Mono	1.5	Bloques de código, métricas

---

5. Voz y Tono

5.1 Principios de Escritura

Principio	Descripción	Ejemplo
Precisión Clínica	Usar terminología médica exacta	✅ "NSCLC Estadio IIIA" · ❌ "Cáncer de pulmón avanzado"
Incertidumbre Transparente	Declarar limitaciones explícitamente	✅ "Información no concluyente en las guías provistas"
Atribución de Fuentes	Siempre citar fuentes de guías	✅ "Según NCCN NSCLC v2024, Página 42"
Orientado a Acción	Guiar los próximos pasos claramente	✅ "Recomendar TC en 14 días"
Cero Especulación	Nunca inventar o extrapolar	❌ "Esto podría potencialmente ser..."

5.2 Lenguaje Anti-Alucinación

La siguiente frase es la respuesta de seguridad canónica cuando la evidencia es insuficiente:

"Información no concluyente en las guías provistas."

Esta frase NUNCA debe ser modificada o suavizada. Es la válvula de seguridad del sistema.

---

6. Directrices de Redes Sociales

6.1 Estrategia por Plataforma

Plataforma	Tono	Tipo de Contenido	Frecuencia
X/Twitter	Técnico, Build-in-Public	Hilos (4-5 tweets), métricas, capturas de código	Diario
LinkedIn	Profesional, Estratégico	Posts largos de hitos, decisiones de arquitectura	2-3x/semana
Instagram/TikTok	Visual, Dinámico	Slides, grabaciones de código, B-roll	1-2x/semana

6.2 Estrategia de Hashtags

Primarios (Usar siempre): #AMDHackathon #HealthTech #ROCm

Secundarios (Rotar): #OpenSource #BuildInPublic #AI #Llama31 #LangGraph #OncoAgent

6.3 Pilares de Contenido

Pilar	% del Contenido	Ejemplos
Construcción Técnica	40%	Decisiones de arquitectura, walkthroughs de código, detalles del pipeline RAG
Historias de Fracasos	20%	"Fracaso del Día" — historias honestas de debugging
Misión y Visión	20%	Filosofía open-source, privacidad del paciente, democratización
Métricas y Resultados	20%	Números de benchmark, estadísticas de ingesta, scores de confianza

6.4 Menciones de Cuentas

Siempre mencionar a los partners del ecosistema cuando sea relevante:

Partner	Handle
lablab.ai	@lablabai
AMD	@AIatAMD / @AMD
Hugging Face	@huggingface

---

7. Co-Branding y Partners

7.1 Partners Tecnológicos

Partner	Relación	Uso del Logo
AMD	Patrocinador de hardware (MI300X)	Usar "AMD Instinct™" con símbolo ™
lablab.ai	Organizador del hackathon	Según guías de marca de lablab.ai
Hugging Face	Hosting de modelos y datasets	Según guías de marca de HF
Meta (Llama)	Proveedor del modelo base	Usar nombre completo "Meta-Llama-3.1-8B-Instruct"

7.2 Disclaimer Obligatorio

Todos los materiales de cara al público deben incluir:

⚠️ Aviso: OncoAgent es un prototipo de investigación de IA desarrollado para el AMD Developer Hackathon 2026. NO es un dispositivo médico certificado. Las decisiones clínicas siempre deben ser tomadas por profesionales de la salud calificados. Este sistema está diseñado como herramienta de soporte a la decisión, no como reemplazo del juicio clínico.

---

8. Tokens de Diseño CSS

:root {
  /* --- Primarios --- */
  --color-primary: #0D9488;
  --color-primary-dark: #0F766E;
  --color-primary-light: #5EEAD4;

  /* --- Secundarios --- */
  --color-secondary: #0F172A;
  --color-secondary-light: #334155;
  --color-secondary-muted: #64748B;

  /* --- Acento --- */
  --color-accent: #F59E0B;

  /* --- Semánticos --- */
  --color-success: #22C55E;
  --color-error: #EF4444;
  --color-warning: #F97316;
  --color-info: #3B82F6;

  /* --- Tipografía --- */
  --font-heading: 'Outfit', system-ui, sans-serif;
  --font-body: 'Inter', system-ui, sans-serif;
  --font-mono: 'JetBrains Mono', monospace;
}

---

9. Internacionalización (i18n)

9.1 Estrategia de Idiomas

Capa	Idioma Principal	Idioma Secundario
Código Fuente	Inglés	—
UI (Por defecto)	Inglés	Español
Documentación	Inglés (.md)	Español (.es.md)
Redes Sociales	Español	Inglés
Salida Clínica	Español	Inglés

---

Construido con ❤️ y AMD Instinct™ MI300X para el AMD Developer Hackathon 2026.