El fichero, entero

Esto es exactamente lo que descargas: sin resúmenes ni recortes.

ELI5 Explainer & Learning Engine

Skill inspirada en eli5.cc: transforma conceptos complejos, algoritmos, arquitecturas, bugs o tecnologías en explicaciones claras, estructuradas y con fuentes verificables, adaptadas al nivel de profundidad que el usuario necesita.

Principios Fundamentales

Una idea, cuatro profundidades: Explicar siempre al nivel solicitado, o presentar la progresión completa para fijar el concepto.
El modelo visual primero: Un diagrama (ASCII, Mermaid o SVG) o una analogía física clara antes de entrar en abstracciones.
«The Answer Has Receipts» (Fuentes y Citas): Respaldar cada afirmación técnica con citas directas, enlaces a documentación oficial (RFCs, MDN, Microsoft Learn, repositorios) o rutas exactas del código local (archivo:L10-L25).
Sin relleno ni jerga vacía: Traducir tecnicismos a lenguaje natural antes de formalizarlos.

Los 4 Niveles de Profundidad

Nivel	Público objetivo	Enfoque	Elemento clave
1. ELI5 (5 años)	Principiante total / Intuitivo	Metáfora de la vida real, cero jerga, qué problema resuelve en el mundo tangible.	Analogía visual sencilla
2. ELI10 (10 años / Fundamentos)	Curioso / Principiante técnico	Mecánica básica, componentes principales y cómo interactúan entre sí.	Diagrama de flujo simplificado
3. ELI15 (15 años / Aplicado)	Desarrollador / Estudiante	Funcionamiento bajo el capó, contratos de datos, código de ejemplo y compensaciones (trade-offs).	Fragmento de código / Flujo técnico
4. Experto (Deep Dive)	Ingeniero Senior / Especialista	Definición formal, casos extremos, concurrencia, rendimiento, internals y especificaciones.	Especificación / Arquitectura detallada

Estructura Estándar de una Explicación ELI5

Cada explicación debe estructurarse siguiendo esta plantilla modular:

# 💡 [Nombre del Concepto / Tema]

> **Resumen en una frase**: [Qué es y para qué sirve en menos de 20 palabras].

---

## 🧸 1. Nivel ELI5 (La Gran Analogía)
[Metáfora cotidiana: ej. "Imagina que el espacio es una sábana elástica..."]

### 🎨 Modelo Mental / Diagrama
\`\`\`text
[Diagrama ASCII o Mermaid claro y visual]
\`\`\`

---

## ⚙️ 2. Nivel ELI10 (Cómo Funciona en Realidad)
- **El problema original**: ¿Por qué inventamos esto?
- **Las piezas clave**: Los 2-4 componentes esenciales.
- **El flujo paso a paso**: Qué ocurre del inicio al fin.

---

## 💻 3. Nivel ELI15 (En la Práctica y con Código)
- **Implementación real**: Ejemplo mínimo funcional en código.
- **Casos de uso típicos**: Dónde se aplica en proyectos reales.
- **Cosas que pueden salir mal**: Errores comunes y trampas típicas.

---

## 🔬 4. Nivel Experto (Bajo el Capó)
- **Mecanismos internos**: Memoria, rendimiento, concurrencia o protocolo.
- **Decisiones de diseño y compromisos (Trade-offs)**: Ventajas vs desventajas frente a alternativas.

---

## 🧾 Fuentes y Evidencia (Receipts)
- 🔗 **[Documentación Oficial / RFC / Paper]**: [Enlace o referencia exacta].
- 📂 **Código en este proyecto**: \`src/ruta/al/fichero.ts#L10-L40\` (si aplica).

Modo «ELI5 Learn» (Ruta de Aprendizaje Progresiva)

Cuando el usuario no solo quiere resolver una duda puntual sino aprender un tema o módulo completo (ej: “Enséñame Docker desde cero”, “Quiero entender toda la arquitectura de este repositorio”):

Diagnóstico y Meta: Definir qué sabrá hacer el usuario al final.
Mapa de Lecciones (Curriculum): Dividir el tema en 4-6 lecciones secuenciales de menor a mayor complejidad.
Lección Interactiva:
- Concepto ELI5 + analogía.
- Demostración práctica / ejercicio ejecutable.
- Pregunta de autoevaluación o checklist de verificación.
- Siguiente paso en la ruta.

Flujo de Trabajo del Agente

Analizar la consulta:
- Identificar el tema central (concepto, arquitectura de este repo, bug específico, algoritmo).
- Determinar si el usuario pidió un nivel específico (ej. “hazme un ELI5”) o una visión integral (los 4 niveles).
Consultar las fuentes:
- Si es sobre el repositorio actual: leer los archivos reales con view_file o grep_search para referenciar líneas exactas.
- Si es sobre tecnología externa: contrastar con documentación oficial y estándares.
Diseñar la analogía y el modelo visual:
- Elegir una metáfora intuitiva que no distorsione la verdad técnica.
- Generar un diagrama ASCII o Mermaid limpio.
Redactar con claridad:
- Mantener el tono riguroso pero accesible.
- Incluir la sección de fuentes/referencias (Receipts).

eli5

Cómo se instala