Conocimiento y documentación
El know-how que vive en prompts sueltos se pierde; escrito como documentación, skills o wiki se convierte en un activo que sobrevive a la sesión.
Cuatro artículos tocan el mismo nervio desde sitios distintos: el conocimiento no se pierde por falta de talento, sino porque nadie quiere hacer el mantenimiento.
En el repositorio: documentación viva
“El código no miente”, pero los documentos externos desactualizados sí. Los agentes de programación detectan cambios en los requisitos y actualizan código y comentarios a la vez, en ramas dedicadas. Al incrustar los comentarios junto al código, la documentación forma parte del repositorio: buscable, revisable y versionada con el mismo commit que la provoca.
Es además la trazabilidad más barata que existe —el commit dice qué cambió y por qué— y lo que permite revisar trabajo que uno no ha escrito sin reconstruir el contexto desde cero.
En la biblioteca: skills
El valor no está en el modelo, que se sustituye cada pocos meses y es el mismo para todos los competidores. Está en lo que no es igual para todos: estándares, procesos, guardrails y automatizaciones. Empaquetados como Agent Skills, dejan de ser un truco que vive en una sesión y pasan a ser un activo portátil entre proveedores.
¿Tu organización está capturando su know-how como skills reutilizables… o sigue perdiéndolo en prompts sueltos y conversaciones que se olvidan?
En la wiki: el patrón de Karpathy y OKF
Un blog es un registro cronológico: honesto, porque dice lo que pensabas ese día, y pésimo como base de conocimiento, porque el artículo viejo sigue indexado contradiciéndote. Por eso este sitio tiene dos mitades: el blog envejece a propósito y la wiki se corrige.
La distinción viene de la wiki LLM de Karpathy —un archivo por tema, escrito y mantenido por un modelo, con referencias cruzadas y trazabilidad de fuentes— y su formalización es el Open Knowledge Format. Lo que convence de OKF no es de quién viene, sino lo que no pide: sin SDK, sin runtime, sin formato binario. Si mañana desapareciera, queda un directorio de markdown legible.
Dos reglas hacen el trabajo: un documento un tema, y los enlaces como estructura y no como adorno —cada enlace afirma una relación, y de ahí salen los backlinks que nadie mantiene a mano—.
El hilo común
Las tres capas son la misma apuesta: markdown en git, legible por personas y por agentes, con historial, y separando lo cronológico de lo corregible.
| Dónde vive | Qué captura |
|---|---|
| El repositorio | Cómo funciona el sistema |
| La biblioteca de skills | Cómo se ejecuta un procedimiento |
| La wiki | Qué sabemos de un dominio |
Y todas responden al mismo hueco técnico: mientras el modelo no consolide —ver memoria y arquitecturas—, el conocimiento tiene que vivir fuera de él. Que la organización quiera escribirlo es, otra vez, un problema de cultura.