La IA no te monta el sistema que no tienes


Le das acceso a tus notas a un agente y le pides que te lo ordene, que lo conecte, que le saque punta. Vuelves a los veinte minutos y tienes lo mismo que tenías, con carpetas nuevas.

Esto pasa mucho más de lo que se cuenta, porque lo que se cuenta son los cuatro minutos que salen bien. Busca «PKM con IA» en español y mira lo que hay: cursos traducidos del inglés, anuncios del modelo de la semana y demos cortas donde todo encaja a la primera. Lo que no encuentras es a nadie enseñando su sistema seis meses después, con lo que se rompió por el camino.

Ahí está el malentendido. Y es caro.

La IA no aporta criterio, aporta velocidad

Un agente hace lo que le dejas hacer sobre lo que encuentra. No sabe qué es importante en tu cabeza, ni por qué guardaste aquel subrayado en 2023, ni cuál de tus cuarenta notas sobre el mismo tema es la buena.

Si tu vault es una carpeta llamada «notas» con mil quinientos ficheros dentro, el agente te devolverá mil quinientos ficheros bien redactados. Sin criterio. Con excelente ortografía.

Es el gimnasio. Una máquina no te pone fuerte: multiplica el trabajo que tú haces con ella. Si la técnica está mal, la máquina te la consolida más rápido.

Con el conocimiento personal pasa igual. La IA amplifica lo que ya hay. Si hay estructura, amplifica estructura. Si hay caos, amplifica caos, y encima te lo deja presentable, que es lo peligroso: un desorden ordenado tarda meses en delatarse.

Tres cosas tienen que estar antes que el agente

No son requisitos de software. Son decisiones tuyas, y se toman con papel si hace falta.

Una estructura de notas que sepas decir en voz alta. No hablo de una carpeta bonita, hablo de tipos: qué es una captura, qué es una nota permanente, qué es un activo, qué es un índice. Si tú no distingues esos tipos, el agente tampoco. Cuando le pides «procesa esto» y no hay tipos, procesar significa lo que él se imagine esa mañana.

Un sitio donde el agente escribe y un sitio donde no entra. Un agente trabajando sobre tu conocimiento personal tiene acceso a material que no le darías a nadie por correo. Lo primero que se define no es lo que puede hacer, es dónde. Carpeta de entrada, carpeta de salida, y el resto en solo lectura mientras no tengas motivos para cambiarlo.

Trazabilidad. Cada cosa que el agente toca deja una línea: qué hizo, cuándo, sobre qué. Sin esto no puedes distinguir un sistema que funciona de uno que lleva tres semanas colgado y tú sin enterarte. Y cuando algo sale mal, que saldrá, el registro es la diferencia entre corregirlo en diez minutos o volver a empezar.

Con estas tres, un agente mediocre te sirve. Sin ellas, el mejor modelo del mercado te genera basura elegante.

Cómo se ven esas tres cosas en un sistema encendido de verdad

Os cuento el mío, que es el único del que puedo enseñar fechas.

Esquema de las tres cosas que tienen que existir antes del agente: estructura de tipos, perímetro de escritura y trazabilidad, con el agente operando sobre ellas sin sustituirlas.

En mi vault hay una carpeta, «000 NEXUS», donde vive todo lo que gobierna a los agentes: perfiles, habilidades, hooks y el tablero de tarjetas. Al lado, en la raíz, hay un fichero aburridísimo, «Estructura carpetas Cerebro Digital.md», que hace una sola cosa: decir qué carpeta real de mi vault corresponde a cada uno de los siete tipos canónicos del Cerebro Digital. Captura es «001 CAPTURA». Conocimiento es «200 MEMORIA DIGITAL». Diario es «900 DIARIO».

Parece una tontería administrativa. Es la primera de las tres cosas, escrita para que una máquina la lea. Mientras esa tabla no existió, cada agente interpretaba «guárdalo donde va» a su manera, y «donde va» acabó siendo cuatro sitios distintos.

La segunda cosa, dónde escribe y dónde no, en mi sistema no es una instrucción: es un candado. Hay una carpeta «_PRIVADA/» con las claves API y las notas que no salen de aquí. Un fichero llamado «block-privada.sh» se dispara antes de cada llamada a herramienta y rechaza cualquier intento de leerla, escribirla o incluso listarla. Aunque yo se lo pida. Es la única política del sistema marcada como inviolable.

Y no está ahí de adorno teórico. El 13 de agosto encontré un «client_secrets.json» viviendo tan ricamente dentro de la carpeta de una habilidad. Meses llevaba. No hubo filtración, pero las carpetas de habilidades se comparten y se versionan: el día que distribuyera aquello, la clave viajaba dentro. Esa misma semana escribí un segundo candado, «block-cred-writes-outside-privada.sh», que impide crear ficheros con pinta de credencial fuera de la carpeta protegida. La consecuencia combinada de los dos es deliberada: el agente no escribe credenciales en ninguna parte. Las pongo yo, a mano.

Hay un tercero, «block-destructive-commands.sh», que corta «rm» recursivos, «git reset –hard», «git push –force» y compañía. Estos agentes corren desatendidos; un accidente ahí no lo ve nadie hasta el post-mortem. La política del vault es de una línea: nada irreversible desde un agente. Las notas no se borran, se mueven a «902 ARCHIVO/».

Aquí va la regla que ha salido de todo esto, y que me ahorra discusiones:

Toda cicatriz acaba en un candado. Si algo salió mal una vez y la corrección es «que el agente se acuerde», no está corregido.

La tercera cosa, la trazabilidad, es la que más me costó aceptar. Yo empecé pidiéndole al agente que apuntara en el log del día lo que hacía. Educadamente. Por instrucción.

Se lo saltaba. Constantemente.

El log se me llenó de marcas de «⚠ Log no escrito» hasta que monté «stop-log-guard.sh»: un hook que se dispara al terminar cada turno, mira si hubo escritura de verdad y, si el agente no registró, escribe él la entrada. Hoy, si abres «000 NEXUS/LOGS/2026-09-14.md», verás una tira de entradas que empiezan por «[auto]» con la hora y con lo que yo pedí en ese turno, entre las 10:15 y las 13:23. No las escribió el agente. Las escribió el backstop.

Mezcladas entre ellas hay líneas de otro hook, «log-config-changes.sh», del estilo de esta, literal:

«12:02 ⚙ [hook log-config-changes] configuración modificada: NEXUS.md (vía Bash)»

Ese vigila solo los ficheros que gobiernan el comportamiento de los agentes. Un cambio ahí altera todas las sesiones futuras: es el sitio exacto donde un error, o una inyección, haría más daño con menos ruido.

Y el trabajo en sí vive en un tablero de carpetas, sin base de datos ni aplicación: «pendientes/», «en-curso/», «hechas/», «programadas/». El estado de una tarea es la carpeta donde está su fichero. Cada tarjeta es un markdown con un frontmatter corto (qué se pide, qué agente la reclamó, a qué hora, qué ficheros produjo) y una sección «Registro» donde el agente va dejando lo que hizo mientras lo hace. Hoy, 14 de septiembre, hay 67 tarjetas en «hechas/».

Fíjate en el detalle que importa: el Registro no se escribe al final, para quedar bien. Se escribe en cuanto el agente acepta el encargo, porque una tarjeta en curso sin ninguna anotación es indistinguible de una tarjeta colgada. Esa distinción no me la da el modelo. Me la da la estructura.

La demo y el lunes a las seis

Casi todo lo que se ve por ahí describe la columna de la izquierda. Lo que aguanta meses es la de la derecha.

En la demo En un sistema encendido
Dónde escribe el agente En todo el vault Carpeta de entrada, carpeta de salida, el resto en lectura
Quién decide el tipo de nota El modelo, sobre la marcha Tú, antes; el agente obedece
Qué pasa si se equivoca Se repite la toma Queda escrito, y hay que encontrarlo
Quién se acuerda de registrar Nadie: no hace falta Un hook, al terminar cada turno
Cuánto dura la sesión Cuatro minutos Meses
Qué se borra Nada, no hay nada que borrar Nada: se archiva
Dónde están las claves En el «.env» de al lado En una carpeta que el agente no puede ni listar
Cuando cambie el modelo Se graba otro vídeo Cambias una línea de configuración y sigue

Ninguna fila de la derecha es difícil. Todas son aburridas. Por eso no salen.

Por qué esto no se ve en los vídeos

Porque montar la estructura es aburrido y no cabe en un vídeo corto.

Enseñar a un agente escribiendo una nota en directo es espectacular. Enseñar las siete semanas previas decidiendo qué es una nota permanente en tu caso concreto, no. Una obra se fotografía cuando ya está la fachada; nadie sube fotos de la cimentación.

Yo llevo hablando de IA desde 2022, cuando en español casi nadie lo hacía, y tengo cientos de vídeos públicos que sirven de registro de mis aciertos y de mis errores. Los errores son más didácticos. Antes de eso estuve más de veinte años gestionando datos en entornos industriales críticos, líneas robotizadas de soldadura para General Motors, robots hace veinticinco años, donde un sistema no valía por lo bien que salía en la demo del proveedor, sino por lo que aguantaba encendido un lunes a las seis de la mañana con medio turno de baja.

Lo que traigo de ahí es una sola idea:

Un sistema no es lo que hace cuando lo miras. Es lo que hace cuando no lo miras.

El efecto compuesto no lo genera la IA, lo acelera

1,01 elevado a 365 da 37,78. Ese número es la razón de ser de todo esto, y no lo pone la inteligencia artificial: lo pone la constancia de capturar, procesar y conectar durante años.

Lo que la IA cambia es el exponente de trabajo que puedes sostener. Si tú procesabas tres fuentes buenas a la semana, con agentes puedes sostener diez sin ahogarte. Eso es mucho. No es magia, es palanca.

Pero fíjate en la base de la potencia. Si es 1,00, si capturas mucho y no procesas nada, puedes elevarlo a 365 o a 3.650: sigue dando uno. Y capturar sin procesar es exactamente lo que un agente hace más rápido que nadie si le dejas.

Más notas no es más conocimiento. Nunca lo fue.

Lo que no hay que hacer

Cuatro errores que he cometido yo, con lo que me costó cada uno.

Dar acceso de escritura a todo el vault el primer día. Es lo cómodo, porque así el agente nunca te dice que no puede. El problema no es que borre algo: es que acierta a medias en doscientos sitios a la vez, y eso no se revisa, se hereda. Con dos carpetas y el resto en lectura, el mismo error te cabe en una pantalla.

Corregir con instrucciones lo que solo se corrige con candados. «Acuérdate de registrar lo que haces» es una instrucción. Aguantó tres días. El hook que lo escribe por él lleva meses sin fallar. Si tu corrección depende de que el modelo esté fino esa mañana, no es una corrección, es un deseo.

Guardar la credencial donde trabaja el agente. Mi «client_secrets.json» de agosto. La clave no se filtró por listilla del modelo: se filtró casi por logística, por estar dentro de una carpeta que se comparte. Mira dónde están tus claves ahora mismo, antes de seguir leyendo.

Dejar que el agente decida solo qué es importante. Esta es la más sutil y la que más caro sale. Un agente al que le dices «organiza esto» no organiza: clasifica según un criterio que se inventa en ese momento y que no vas a poder auditar dentro de tres meses. Si el criterio no lo has escrito tú en algún sitio, no existe.

Y uno que no es error de agente, es de persona: empezar por la tarea lucida. La tarea lucida, «que me escriba los artículos», «que me resuma el libro entero», es justo la que menos tolera un fallo, la más difícil de revisar y la que antes te hace abandonar. Se empieza por lo contrario.

«Marcos, esto es una excusa para no empezar nunca»

Ya. Es la objeción buena, y la he escuchado con esas palabras.

«Me estás diciendo que antes de tocar un agente monte una estructura, un perímetro y un sistema de registro. Eso es parálisis por análisis. Yo prefiero empezar y arreglarlo por el camino.»

Te respondo con tiempos reales. Las tres cosas no son un proyecto de siete semanas: decidir tus tipos de nota es una tarde, decidir dónde escribe el agente son dos carpetas, y el registro es un fichero de texto con una línea por operación. Lo que sí lleva meses es el vault que ya tienes. Por eso el orden importa tanto: decidir tipos mirando veinte notas es una tarde; decidirlos cuando el agente ya te ha tocado mil quinientas es una reforma.

«Pero es que yo no tengo sistema y con ChatGPT me apaño perfectamente.»

Perfecto, y no te discuto nada. Estás usando una herramienta, y para eso está. Este artículo va de lo otro: de dejar procesos corriendo sobre tu conocimiento cuando tú no estás delante. En cuanto cruzas esa línea, el primer agente que escribe en tu vault sin que tú mires la pantalla, las tres cosas dejan de ser opinión.

«Yo lo probé y el agente me llenó el vault de notas inútiles.»

Eso no lo discuto: te lo confirmo. Es exactamente lo que va a pasar sin las tres cosas, y no se arregla con un modelo mejor ni con un prompt más largo. Se arregla decidiendo tú qué entra, dónde entra y cómo se sabe qué pasó.

Qué haría yo si empezara esta semana

No instalaría nada nuevo.

Cogería las últimas veinte notas que he guardado y me preguntaría, una por una, de qué tipo son y qué tendría que pasar con ellas para que dejen de estar ahí muertas. En veinte notas aparece tu sistema real: el que usas, no el que dices que usas.

De ahí salen tus tipos. Escríbelos en un fichero en la raíz, con el nombre exacto de la carpeta de cada uno. Ese fichero es lo primero que leerá cualquier agente que metas después, y es lo que evita que «guárdalo donde va» signifique cuatro sitios distintos.

Después, dos carpetas. Una donde el agente lee lo que le das y otra donde escribe lo que produce. Todo lo demás, en lectura, hasta que tengas un motivo concreto para abrir la mano. Y si tienes claves API, sácalas hoy de donde estén y déjalas en una carpeta que el agente no pueda ni listar.

Después, un registro. No necesitas hooks el primer día: necesitas un fichero por día donde quede la hora, qué se tocó y qué salió. Si a las dos semanas ese fichero está vacío, ya sabes algo importantísimo sobre tu sistema y te ha costado dos semanas averiguarlo, no seis meses.

Y entonces, y solo entonces, le daría a un agente una tarea pequeña y aburrida de ese circuito. Una. La que más te canse. En mi sistema, el primero fue el que convierte una captura ya clasificada en su nota, en la carpeta que le toca por tipo: un obrero barato, del modelo más pequeño que tengo, que no decide nada, el tipo se lo doy hecho. Aburridísimo. Lleva meses funcionando.

Esa es la versión mínima de esto, y curiosamente es también la versión que sigue funcionando dentro de un año, cuando el modelo que uses hoy ya no exista.

¿Cuál es tu tarea aburrida? Piénsalo antes de abrir ninguna aplicación. Es la única parte que no puede hacer la IA por ti.

Al suscribirte, gratis

Tu primer agente IA sobre tus propias notas, en una tarde

Es un minientrenamiento en vídeo, paso a paso y sin código: montas un agente que lee tu conocimiento en Obsidian y hace por ti lo que hoy le pides a un chat, con la plantilla Nexus 0 ya hecha. No es otro prompt. Es el sistema que hay debajo, el mismo que uso yo.

Y después del regalo, envío un correo cada día salvo cuando voy a la peluquería. Suscribirte es gratis. Mis formaciones no.

Si ya te suscribiste, hazlo de nuevo y te dejaré donde estabas