· 5 min

Nunca le pedí un HTML. Simplemente le pedí un diagrama.

No empecé con la idea de hacer HTMLs. Empecé tratando de no perderme en un pipeline de BigQuery. Lo que me escupió Claude esa vez cambió la forma en que documento todo.


El momento

Estaba tratando de resolver el pipeline interno de BigQuery en Rufus. Teníamos conexiones de APIs con diferentes Ad Managers, un sistema de Airbyte, tablas que fui armando sobre la marcha para entender qué iba a dónde. Yo metía queries, le pasaba CSVs a Claude, armaba nuevas tablas para entender el contexto.

En algún momento dije: "para. Me estoy re perdiendo."

No le pedí un HTML. Le pedí: "armame un diagrama de todo esto porque me estoy re perdiendo".

Me escupió un HTML. Abrí el archivo y dije "wow". Podía ver el flujo de datos, leer las explicaciones, y entender todo de un vistazo. No era una imagen estática. No era texto solo. Era las dos cosas.

Cómo escaló

No fue un momento de iluminación. Fue una cosa llevando a la otra.

01
Empecé a pedir más diagramas
Cada vez que se me complicaba un sistema, le pedía a Claude que lo visualice. Salía un HTML. Lo guardaba en mi compu.
02
Los empecé a usar para instructivos
Documentar procesos para el equipo. Pero primero para mí — para entender yo las cosas antes de explicarlas.
03
Me di cuenta que eran interactivos
Podía filtrar, expandir, hacer click. No era solo un documento — era una herramienta.
04
El primer problema: quedaban en mi compu
Quería mostrarle algo al equipo. Print de pantalla, lo sumaba a una PPT. Adaptaba a Sheets. Era un quilombo.
05
Intenté subirlos a GitHub — fallé
Le pregunté a Claude cómo hospedarlos. Se veía complejo. Intenté, no pude solo, no tenía el tiempo. Desistí.
06
Los seguí usando para mí, los templticé
Para flujos de una manera, para instructivos de otra. Empecé a tener consistencia visual sin pensarlo.
07
Aprendí a hospedarlos — nació francristaldo.com
Cuando entendí cómo subirlos a un servidor, todo lo que venía acumulando encontró un lugar. El lab, el interno, la página personal.

Por qué HTML y no otra cosa

Me lo pregunté muchas veces. Tengo Notion, tengo Google Docs, tengo Markdown. ¿Por qué el HTML?

Las otras opciones
Imagen → estática, no podés filtrar ni leer el texto
PDF → estático, no interactivo
Notion → atado a una plataforma, no es tuyo
Google Doc → texto solo, sin interactividad visual
Markdown → legible por código, pero no visual
HTML
Visual y texto juntos
Interactivo — filtrás, expandís, navegás
Legible por código — un LLM puede leerlo
Es tuyo — no depende de ninguna plataforma
Hospedable — compartible con cualquiera
La conclusión real

El HTML no es un formato de archivo. Es la forma más completa de externalizar algo que entendiste — de una manera que podés ver, tocar, compartir, y que un sistema puede leer después.

Hoy es Claude el que lo lee. Mañana será otro LLM. Pero el HTML es mío.

Para pensar

¿Dónde guardás las cosas que entendiste bien?

No las que anotaste. Las que realmente entendiste — las que podrías explicar, mostrar, volver a leer en seis meses y seguir entendiendo.