Por qué este blog tiene una wiki al lado
Artículo del 15 de agosto de 2026 que explica la separación entre blog y wiki, el patrón de Karpathy, la adopción de OKF v0.1 y el flujo de ingesta.
resource: https://eugeniorodriguez.eu/blog/hola-mundo
El único artículo no republicado desde LinkedIn: es la nota fundacional de este sitio, y la fuente que describe el propio bundle donde vive esta página.
Parte de un problema personal: años tomando notas sobre IA y perdiéndolas. No literalmente —las notas siguen ahí, en carpetas, marcadores y capturas—, lo que se pierde es la relación entre ellas.
Dos formatos, dos trabajos
Un blog no arregla eso. Es un registro cronológico: escribes algo un martes, lo publicas y ese texto queda congelado. Un formato honesto —dice lo que pensabas ese día— pero pésimo como base de conocimiento: si seis meses después cambias de opinión, el artículo viejo sigue ahí, igual de indexado, contradiciéndote.
Por eso el sitio tiene dos mitades:
- El blog es cronológico y no se reescribe. Envejece a propósito.
- La wiki es un documento por tema, sin fecha de publicación, que se corrige continuamente. Cuando el autor cambia de opinión, cambia la página.
La distinción viene de lo que Andrej Karpathy describió en abril de 2026 sobre su base de conocimiento personal: un archivo markdown por tema, escrito y mantenido por un LLM, con referencias cruzadas y trazabilidad de las fuentes. Las dos reglas que lo hacen funcionar: un solo tema por documento y los enlaces como estructura, no como adorno.
Y por qué OKF
El patrón de Karpathy era una buena idea sin especificación: cada uno lo
implementaba a su manera y los resultados no eran intercambiables. En junio de
2026 Google Cloud publicó el Open Knowledge Format v0.1 bajo Apache 2.0, que
es esa idea formalizada: un directorio de markdown con frontmatter YAML y un
puñado de convenciones acordadas. La spec es deliberadamente pequeña — sólo
exige un campo type no vacío. El ejemplo que da el artículo:
---
type: concepto
title: Transformer
description: La arquitectura de red neuronal detrás de los LLM modernos.
tags: [IA, arquitecturas]
timestamp: 2026-08-15
---
Eso es todo lo obligatorio: title, description, resource y tags son
recomendados y timestamp opcional. No hay SDK, ni runtime, ni formato
binario. Son archivos de texto.
Lo que convence no es que sea de Google: es lo que no pide. No hay nada que se pueda romper en una migración — si mañana OKF desapareciera, queda un directorio de markdown perfectamente legible. El coste de adoptarlo es casi cero y a cambio la wiki es consumible por cualquier agente que entienda la convención.
De la idea a la wiki: las tres operaciones
Al día siguiente de publicar lo anterior, el autor pasó los doce artículos del blog por el flujo que describe Karpathy. Tres operaciones, y ninguna es “resumir”:
- Ingesta. El modelo lee una fuente entera, extrae las entidades y para cada una decide si crea una página o amplía una existente. Esa segunda mitad es la importante: una fuente nueva no añade un documento al final, toca diez que ya estaban. Por eso el conocimiento se acumula en vez de apilarse.
- Consulta. Se pregunta a la wiki, no al material en bruto. El índice dice de qué va cada página, así que se leen tres y no treinta.
- Lint. Una pasada de mantenimiento que busca lo que se pudre solo: enlaces rotos, páginas huérfanas, conceptos mencionados repetidamente sin página propia, contradicciones entre documentos.
El lint de la primera ingesta encontró cinco páginas casi aisladas y dos demasiado cortas para sostenerse. El desorden se mide y se corrige, en vez de acumularse hasta que dejas de entrar.
El error de la primera versión
La primera pasada salió con una página por concepto: treinta y tres términos, uno por documento. Cumplía “un tema por página” al pie de la letra y aun así estaba mal — producía un diccionario, y un diccionario no dice nada que no supieras ya al buscar la palabra.
El gist describe otra cosa: resúmenes de fuentes, páginas temáticas, comparaciones y una síntesis. La diferencia está en dónde ocurre la fusión: una página sobre “MCP” repite lo que decía el artículo de MCP; una página sobre capacidades de los agentes tiene que decidir cómo encajan el MCP, los Agent Skills y la divulgación progresiva, que salieron de artículos distintos con seis meses de diferencia. Eso es conocimiento nuevo; lo otro es un índice con más pasos.
De ahí las tres capas actuales: fuentes/ (una página por artículo, la
trazabilidad), temas/ (nueve páginas que fusionan varios artículos) y
sintesis.md (la tesis que atraviesa los doce). La prueba de una buena página
temática: contiene al menos una frase que no está en ninguna de sus
fuentes.
Por qué queda ordenado y se puede consultar
Tres decisiones, las tres heredadas de la idea original:
- Un documento, un tema — donde “tema” es un asunto sobre el que varias fuentes discuten, no una palabra del glosario.
- Los enlaces son la estructura. En OKF un enlace afirma una relación. Escritos dentro de la prosa, cada página acaba sabiendo quién la cita: los backlinks salen solos.
- Cada afirmación arrastra su fuente, en la sección
# Citations. Si dentro de un año una página parece equivocada, se sabe de dónde vino y se corrige sin tocar el artículo original.
Consultarla es de dos formas: a mano, con buscador y backlinks; o dándole el directorio a un agente, que es para lo que existe el formato.
Cómo está montado
Astro, compilado a HTML estático. El buscador es Pagefind, que genera un
índice al compilar: las búsquedas ocurren en el navegador y no hay servidor
detrás. Sin rastreadores y sin analítica. El código valida la conformidad OKF
en cada build: si un documento se queda sin type, la compilación falla antes
de publicar.
Un detalle inesperado: los enlaces entre conceptos son rutas al bundle
(/concepto.md), no rutas del sitio. Es lo correcto según la spec —el paquete
debe poder leerse fuera de aquí— pero significa que llegan literales al HTML y
dan 404. Se resuelve reescribiéndolos a /wiki/concepto al compilar, dejando
el markdown de origen intacto. Un ejemplo pequeño de la tensión de fondo: el
formato sirve al agente, la web sirve a la persona, y el sitio tiene que dar
a cada uno lo suyo sin estropear el otro.
El artículo cierra señalando que el patrón no tiene nada de específico de este blog y remitiendo a las dos Agent Skills descargables desde la wiki.
Dónde se integra
Sostiene la tercera capa de conocimiento y documentación, y las dos páginas de referencia del bundle: wiki LLM de Karpathy y Open Knowledge Format.
Citations
- Por qué este blog tiene una wiki al lado — 15 de agosto de 2026