Krog - Manual de Usuario y Guía de Autoría Completa

1. Introducción y Manifiesto

Acerca del Autor (Dany)

Hola, soy Dany. Soy programador de software y actualmente estudio Medicina en la Universidad de El Salvador. Cuando la inteligencia artificial generativa irrumpió en el ámbito académico, me sumé con entusiasmo como tantos otros estudiantes: la utilicé para sintetizar capítulos voluminosos, formular preguntas de opción múltiple y extraer resúmenes de fisiología compleja. Sin embargo, no tardó en manifestarse una contradicción preocupante: las herramientas eran sumamente potentes, pero asumían el trabajo intelectual que le correspondía al estudiante. En lugar de potenciar el razonamiento, convertían el acto de estudiar en una rutina pasiva de lectura superficial.

Aprender exige esfuerzo cognitivo. En disciplinas rigurosas como la medicina, la patología o la arquitectura de software, la verdadera comprensión se forja al enfrentarse a la complejidad, formular hipótesis y confrontar las propias lagunas de conocimiento. Cuando un software entrega un resumen ya digerido y cerrado a la edición, priva al estudiante de esa síntesis personal.

Un ejemplo claro es NotebookLM: aunque representa un logro técnico notable, funciona como una caja negra de carácter paternalista. Aunque es posible solicitar ajustes generales, el system prompt que rige su comportamiento está oculto, las directrices de procesamiento son propietarias y los documentos generados se tratan como artefactos inmutables. El estudiante no puede ingresar directamente al texto para tachar una afirmación imprecisa, afinar un matiz diagnóstico o reestructurar una explicación anatómica con sus propias palabras.

Diseñé Krog para romper con ese esquema. Krog es un Sistema de Gestión de Aprendizaje abierto y soberano, concebido para devolverle al estudiante el control integral de su proceso formativo. Cada prompt es accesible; cada pregunta generada puede editarse y corregirse; cada recurso puede exportarse y ejecutarse bajo los términos del usuario, ya sea a través de servicios en la nube o mediante modelos de código abierto ejecutados localmente en su propia máquina.

Qué es Krog (y qué no es)

Krog ES: Un entorno diseñado para la evocación activa (active recall), la redacción modular de apuntes, la evaluación rigurosa, la colaboración entre pares y la administración de exámenes institucionales con altos estándares de control.
Krog NO ES: Un envoltorio comercial sobre una API cerrada que retiene el conocimiento detrás de suscripciones opacas o formatos cautivos.

Un Sistema de Gestión de Aprendizaje (en inglés: Learning Management System o LMS) es una aplicación de software para la administración, documentación, seguimiento, reporte, automatización y entrega de cursos educativos, programas de formación, materiales de estudio o planes de desarrollo y aprendizaje. Wikipedia

Primitivas Centrales de la Arquitectura

El ecosistema de Krog se articula en torno a seis componentes modulares interconectados:

Contenidos (Content): Guías extensas en Markdown, documentos PDF, textos extraídos y páginas web limpias de distracciones.
Pizarras Vectoriales (Drawing): Diagramas, mapas conceptuales y esquemas visuales trazados sobre un lienzo infinito.
Preguntas (Question): Reactivos atómicos de evocación activa estructurados bajo un formato universal.
Exámenes (Exam): Bloques de reactivos asociados opcionalmente a guías de estudio, parámetros cronometrados y restricciones de acceso.
Colecciones (Collection): Rutas formativas organizadas que agrupan exámenes y materiales a lo largo de ciclos académicos.
Organizaciones (Organization): Entornos institucionales provistos de equipos, repositorios comunes y permisos específicos por recurso.

2. Cuenta, Personalización y Sabores Visuales (Flavors)

Perfil e Identidad

Cada usuario dispone de un identificador exclusivo (username), nombre completo, biografía y avatar.

Control de Privacidad: Es posible definir con total autonomía si el perfil, la actividad reciente y el historial académico son de acceso público o si quedan reservados para la organización y suscriptores autorizados (profile_picture_public, social_public).
Rachas y Disciplina: El compromiso diario se registra a través de contadores de racha (streak y longestStreak). Realizar una serie de preguntas o repasar una lectura actualiza este valor cada día.
Medallas de Logro: Superar simulacros complejos, elaborar bancos validados por la comunidad o coordinar grupos de estudio otorga distintivos que se exhiben en el perfil.

El Sistema de Sabores: Más de 50 Temas Tipográficos Curados

La fatiga ocular durante jornadas extensas de estudio merma sensiblemente el rendimiento cognitivo. Por ello, Krog implementa un sistema visual denominado Sabores de Diseño (Design Flavors). Lejos de limitarse a un simple selector claro/oscuro, cada sabor redefine las paletas cromáticas, los contrastes, el radio de bordes y la escala tipográfica de toda la interfaz:

Minimalistas y Texturas de Papel: minimal, notebook, legalpad, chalkboard, typewriter, eink, newspaper.
Técnicos y Oscuros: krog (verde esmeralda sobre base profunda), nord, dracula, cyberpunk, terminal, developer, repository, charcoal, onyx.
Cálidos y Expresivos: swiss, bauhaus, midcentury, sakura, warmcream, coffee, desert, sumi, kyoto.
Enfoque y Alto Contraste: studyfocus, highcontrast, scientific, blueprint, wireframe.

Asimismo, el usuario puede seleccionar por separado la tipografía del sistema (App Font) y la tipografía para lecturas de largo aliento (Material Font, como Literata o Merriweather), además de graduar la trama de fondo de la interfaz.

3. El Motor de Autoría: Redacción de Material de Estudio en Krog

Redactar materiales de estudio en Krog responde al concepto de Libro de Texto Ejecutable. En lugar de producir prosa inerte y pasiva, el motor de Markdown de Krog permite a los autores articular documentos dinámicos e interactivos utilizando directivas de flujo en texto plano, contenedores semánticos y componentes interactivos integrados.

Cada ejemplo a continuación se presenta en pestañas interactivas de "Text" (código fuente) y "Result" (resultado en vivo procesado por Krog).

1. Separación de Capítulos (`------`)

Los materiales extensos se estructuran en capítulos independientes insertando exactamente seis guiones en una línea en blanco:

# Capítulo 1: Fisiología de la Sinapsis Neuronal
Desarrollo del capítulo 1...

------

# Capítulo 2: Potenciación a Largo Plazo y Plasticidad
Desarrollo del capítulo 2...

Krog divide automáticamente cada segmento en una vista de lectura con índice lateral, estimación del tiempo de lectura y casillas de verificación de progreso individual (StudyProgress). Las directivas de flujo declaradas en capítulos anteriores se heredan de manera fluida a lo largo de los saltos de capítulo.

2. Referencia Completa de Directivas de Flujo

Las directivas inician con el carácter @ al comienzo de una línea. Afectan al contenido subsiguiente hasta que se declare un nuevo valor o se restablezcan:

Directiva	Sintaxis / Valores	Efecto Pedagógico y Visual
`@font`	`@font literata`, `@font jbmono`, `@font cmu`, `@font default`	Cambia dinámicamente la familia tipográfica de lectura.
`@size`	`@size 18`, `@size 1.2x`, `@size 1.1rem`, `@size default`	Modifica el tamaño base del texto en los párrafos siguientes.
`@columns`	`@columns 2`, `@columns 3`, `@columns 1` (o `off`)	Divide el texto en columnas de lectura estilo editorial o periódico (hasta 4).
`@align`	`@align center`, `@align justify`, `@align left`, `@align right`	Modifica la alineación del texto (ideal para títulos o artículos formales).
`@accent`	`@accent emerald`, `@accent sky`, `@accent rose`, `@accent #hex`	Reemplaza el color de acento principal para los bloques inferiores.
`@spacing`	`@spacing tight`, `@spacing relaxed`, `@spacing loose`	Modula la altura de línea e interlineado de los párrafos.
`@lang`	`@lang es`, `@lang en`, `@lang de`, `@lang fr`	Establece el idioma para síntesis de voz, división de palabras y accesibilidad.
`@numbering`	`@numbering on`, `@numbering off`	Agrega numeración jerárquica automática a encabezados `#`, `##`, `###`.
`@h-underlines`	`@h-underlines off`, `@h-underlines on`	Activa o desactiva la línea horizontal de acento bajo los encabezados.
`@watermark`	`@watermark BORRADOR`, `@watermark CONFIDENCIAL`	Proyecta una marca de agua diagonal sutil de fondo.
`@break`	Línea independiente `@break` (o `<pagebreak/>`)	Fuerza un salto de página limpio en exportaciones a PDF e impresión.

Para reiniciar cualquier directiva a su estado por defecto, utiliza default, off o none (ejemplo: @columns off, @align default).

3. Mejoras en Línea: Colores, Resaltados y Tipografías Específicas

* **Tipografías Acotadas**: <font jbmono>Código fuente monospaciado</font> y <font cmu>Notación matemática clásica</font>.
* **Tamaño Puntual**: <size 20>Llamada de atención destacada</size>.
* **Colores de Texto**: <c emerald>Término clave esmeralda</c> y <c rose>Alerta crítica en rosa</c>.
* **Resaltador Fluorescente**: ==Concepto de alto rendimiento== y =={sky}:Paleta específica azul celeste==.
* **Flechas Automáticas**: Estado basal → Despolarización celular ⇒ Umbral del potencial de acción.

4. Evocación Activa en Texto: Cloze Deletions, Spoilers y Voz

Huecos Ocultos (Cloze Deletions)

Oculta términos clave detrás de un botón interactivo para forzar la memoria durante la lectura:

La despolarización rápida en la fase 0 del miocardio ventricular ocurre por apertura de {{canales rápidos de Na+ dependientes de voltaje}}.

Desplegables de Razón Clínica (Spoilers)

Oculta la solución o conducta médica hasta que el alumno decida corroborar su razonamiento:

¿Cuál es el antídoto de elección en la intoxicación por paracetamol?
<spoiler>
**N-acetilcisteína (NAC)**, ya que restituye los niveles hepáticos de glutatión.
</spoiler>

Pronunciación y Síntesis de Voz (`<play>`)

Verificación fonética: <play lang="es">esternocleidomastoideo</play> y francés: <play lang="fr">trompe-l'œil</play>.

5. Contenedores Semánticos y Bloques de Alerta

Encapsula notas y advertencias contextuales en etiquetas XML semánticas:

<warning>: Advertencias sobre trampas frecuentes o contraindicaciones.
<danger>: Riesgos críticos o interacciones letales.
<tip>: Reglas mnemotécnicas y atajos de cálculo.
<note>: Aclaraciones de fondo y contexto histórico.
<objective>: Objetivos formativos principales.
<pitfall>: Errores conceptuales habituales.
<key>: Ideas nodales para memoria a largo plazo.
<recap>: Síntesis de consolidación.

<tip>
**Mnemotecnia de Aminoácidos Esenciales:** PVT TIM HaLL
(Fenilalanina, Valina, Treonina, Tryptófano, Isoleucina, Metionina, Histidina, Leucina, Lisina).
</tip>

<warning>
Los betabloqueantes sin actividad simpaticomimética intrínseca están formalmente contraindicados en la insuficiencia cardíaca aguda descompensada.
</warning>

<key>
El hallazgo hemodinámico cardinal de la estenosis aórtica severa es el gradiente de presión sistólica entre el ventrículo izquierdo y la aorta.
</key>

6. Cajas Académicas Numeradas

Para programas formales en ciencias, matemáticas y medicina, Krog proporciona entornos estructurados con numeración automática:

<theorem Ley de Frank-Starling del Corazón>
La fuerza o energía de contracción del ventrículo cardíaco es directamente proporcional a la longitud inicial de las fibras miocárdicas al final de la diástole (precarga).
</theorem>

<example Caso Clínico Demostrativo>
Varón de 64 años con dolor torácico opresivo irradiado a mandíbula y elevación de Troponina I a 4.5 ng/mL. La conducta más urgente es activar la sala de hemodinámica para angioplastia primaria (ICP).
</example>

7. Algoritmos y Procedimientos Clínicos Paso a Paso (`<steps>`)

Estructura procedimientos quirúrgicos, protocolos de emergencia o algoritmos computacionales con distintivos numéricos de alta visibilidad:

```markdown

Krog - Guía del usuario (ES)