La semana pasada leí sobre una IA que diseñó una vacuna contra coronavirus que ni siquiera hemos encontrado todavía (ScienceDaily). Cambridge realizó el primer ensayo en humanos y 39 voluntarios recibieron el antígeno.
Es una locura pensar que un algoritmo analizó toda la familia genética de un virus y diseñó protección contra miembros que aún circulan en animales y esperan saltar. Pero cuando le pido que me traiga mi último briefing de una lista de documentos, se pasa casi dos minutos abriendo archivos equivocados en mi bóveda solo para mostrarme un briefing de hace tres meses.
Y sé que Cambridge usa una IA entrenada a medida, pero lo que quiero mostrarte es que la brecha entre lo que la IA puede hacer y lo que una configuración le permite hacer es lo que define o destruye tu flujo de trabajo y productividad.
Nunca construí andamios a propósito, hasta hace poco. Se acumularon alrededor del agente por accidente, carpeta tras carpeta, hasta que el agente perdió el rumbo dentro de un desorden que yo mismo creé.
Así que pasé un día cronometrando cada fallo, y apareció un patrón. En esta edición te muestro por qué tu agente sigue tropezando con lo fácil mientras el mundo lo llama genio, y la solución que lo pone de tu lado.
En este artículo:
- La estructura de carpetas falló a mi agente porque mis carpetas estaban organizadas para cómo pienso yo, no para cómo navega un agente
- Un archivo índice en la raíz de cada carpeta principal convirtió búsquedas lentas en lecturas de treinta segundos
- El andamiaje invisible alrededor de tu agente importa más que la propia capacidad del agente, y aquí te explico cómo construirlo
- Una prueba diagnóstica que puedes ejecutar en cinco minutos para ver si tu estructura de carpetas es el verdadero problema
La estructura que tu agente no puede ver
Organicé mi bóveda como hace la mayoría. Artículos, investigación, recursos, documentos de estrategia, cada uno tenía su propia carpeta. Esa estructura se sentía limpia porque yo pienso en tipos de contenido. Las carpetas coinciden con mis categorías y nunca pienso dónde buscar. Los borradores son artículos, las notas son investigación, el sistema de archivo funciona en piloto automático.
Pero un agente no piensa en categorías. Cuando le pido a Hermes que planifique el lanzamiento de un producto, la tarea extrae de notas de estrategia, guías de marca y lanzamientos anteriores repartidos en diferentes carpetas.
Esas piezas de contexto viven en lugares distintos dentro de mi estructura por tipo de contenido. Mi agente tiene que buscar en todas partes cada vez, sin saber qué borrador está actual y cuál está archivado, o qué nota de investigación es de este mes y cuál de hace seis meses.
La organización por tipo de contenido funciona perfectamente para los humanos. Has pasado toda tu vida archivando cosas bajo categorías, y tu cerebro hace las referencias cruzadas automáticamente. Es natural esperar que la IA funcione igual, cuando en realidad un agente tiene que hacer esas referencias cruzadas manualmente, y ahí es donde la estructura se rompe.
La estructura alrededor de tu agente hace más trabajo que la propia capacidad del agente.
Una vez que vi el patrón, la causa era obvia: había construido mi bóveda para un cerebro humano que recuerda dónde viven las cosas, y luego se la entregué a un agente que tiene que buscar desde cero cada vez, y eso expuso el verdadero problema debajo del desorden de carpetas.
Un buscador necesita un mapa, porque sin él el agente camina en la oscuridad y trata cada archivo como si pudiera ser la respuesta.
En qué desperdicia la capacidad
Hermes se pasaba abriendo un montón de archivos antes de dar con el correcto, o agarraba una versión archivada cuando el archivo actual estaba en otro sitio. Peor aún, preguntaba qué archivo usar cuando la respuesta debería haber sido obvia por el contexto. Esto ocurría con todos los modelos que usé, incluidos Opus, GPT 5.5, Qwen y GLM.
El patrón se repetía, y yo me quedaba viendo las mismas búsquedas lentas una y otra vez en cada tarea.
Aunque mi agente era lo suficientemente capaz para encontrar cosas, la estructura de carpetas se había convertido en el principal cuello de botella antes siquiera de llegar al trabajo real.
Llegué al punto de ruptura el día que cronometré los fallos. Registré cuántos archivos abría Hermes antes de llegar al correcto, y cuánto tardaba en llegar. Cinco tareas comunes tenían este aspecto antes de cambiar nada.
Antes de cambiar nada:
- Encontrar el briefing actual del artículo: 7 archivos abiertos, 2:00 hasta el archivo correcto
- Encontrar las definiciones de color de la marca: 5 archivos abiertos, tardó 1:12
- Consultar la cola de artículos para planificar: 4 archivos abiertos, tardó 0:48
- Encontrar artículos anteriores sobre el mismo tema: 6 archivos abiertos, tardó 1:36
- Obtener la estrategia de promoción para un lanzamiento: 3 archivos abiertos, tardó 0:34
Experimento aproximado, así que toma los números exactos como indicativos.
Cada tarea cruzaba varias carpetas. La mayoría abría versiones archivadas antes de encontrar las activas. Mi agente quemaba capacidad en navegación en lugar de hacer su trabajo. Un plan de lanzamiento necesitaba tres archivos que vivían en tres carpetas diferentes, y lo vi hacer tres intentos equivocados antes de dar con los correctos.
Un agente que escribe artículos, programa y planifica no debería pasar la mayor parte del tiempo buscando cosas.
La jaula más pequeña que funciona
Una carpeta por ámbito, numerada por orden, con un INDEX.md en la raíz que lo mapea todo. Esa es toda la solución, y los detalles viven en tres reglas que funcionan juntas.
INDEX.md en la raíz de cada carpeta principal es un mapa. Lista cada subcarpeta y archivo canónico, además de por dónde debe empezar mi agente. Mi agente lee esto primero y sabe lo que hay dentro antes de tocar nada más. Piensa en ello como una puerta de aprobación suave donde el agente no puede empezar a trabajar hasta que sabe con qué está trabajando.
La estructura de mi carpeta de marca tiene este aspecto después de la reorganización.
105.Marca/2├── INDEX.md3├── 01.Sistema de Marca/4├── 02.Estrategia Editorial/5├── 03.Promoción/6├── 04.Entregables Públicos/7├── 05.Plan Operativo/8└── 06.Archivado/
Esta estructura organiza por ámbito en lugar de por tipo de contenido. Cada ámbito tiene su propia carpeta, así que el trabajo de marca se queda con el trabajo de marca y la estrategia con la estrategia. Mi agente no cruza límites buscando algo que no pertenece allí.
Los números en las carpetas hacen explícito el orden de lectura en lugar de depender de la clasificación alfabética. 01. Sistema de Marca se lee antes que 02. Estrategia Editorial. Mi agente no adivina. Los números dentro de las carpetas hacen lo mismo con los archivos, así que mi agente sabe que 01. Artículos es el punto de partida antes que 02. Artículos Anteriores.
Pongo un número al principio del nombre de la carpeta porque también me resulta más fácil recordarlo.
Así es como mi stack completo de $30 de Hermes se mantiene ágil para moverse por docenas de carpetas sin que mi agente se pierda nunca.
Los archivos archivados viven en 06.Archivado, donde van a esperar los briefings antiguos y los planes retirados. Mi agente sabe que no debe mirar allí a menos que yo le pida específicamente contexto histórico. Esa separación es lo que mantiene las carpetas activas limpias y las búsquedas rápidas.
Una vez que le dije a mi agente que no cruzara ese límite por defecto, cada tarea dentro de las carpetas activas se ejecutó más rápido.
Mi INDEX.md tiene este aspecto.
1# Índice de Marca23Esta carpeta contiene el sistema de marca actual.45## Mapa de Carpetas67| Carpeta | Propósito | Actualizado |8|---|---|---:|9| `01.Sistema de Marca/` | Identidad visual, alcance temático, voz | 2026-06-11 |10| `02.Estrategia Editorial/` | Dirección de artículos, reglas de títulos, cola | 2026-06-11 |11| `03.Promoción/` | Lanzamiento, distribución, estrategia de herramientas | 2026-06-11 |1213## Archivos Canónicos1415| Archivo | Propósito |16|---|---|17| `01.Sistema de Marca/01. Sistema de Marca.md` | Identidad visual, colores, tipografía |18| `02.Estrategia Editorial/01. Artículos.md` | Cola de artículos, reglas de títulos |1920## Por Dónde Ir2122- Empieza con `01.Sistema de Marca/04. Dirección.md` para la misión23- Usa `02.Estrategia Editorial/01. Artículos.md` para la selección de artículos
INDEX.md pasó por tres versiones. Mi primera versión listaba cada archivo individual dentro de la carpeta de marca y ocupaba cuarenta líneas. Técnicamente era completa, pero mi agente tenía que analizarla cada vez y la longitud era su propia sobrecarga. Mi segunda versión era demasiado corta, unas quince líneas, y mi agente seguía haciendo preguntas que no había respondido. Esta tercera versión lista solo las subcarpetas y los archivos canónicos, con una breve sección "Por Dónde Ir" que le indica a mi agente sus puntos de partida.
Cuando le pido a mi agente que obtenga la estrategia de promoción para un lanzamiento, lee 05.Marca/INDEX.md, abre 03.Promoción/01. Estrategia de Promoción.md y se pone a trabajar. El tiempo después de la reorganización tiene este aspecto.
Después de la reorganización:
- Encontrar el briefing actual del artículo: 1 archivo abierto, 0:10
- Encontrar las definiciones de color de la marca: 3 archivos abiertos, 0:22
- Consultar la cola de artículos para planificar: 1 archivo abierto, 0:10
- Encontrar artículos anteriores sobre el mismo tema: 2 archivos abiertos, 0:18
- Obtener la estrategia de promoción para un lanzamiento: 1 archivo abierto, 0:12
La tarea más lenta pasó de 2 minutos a 26 segundos, y las ejecuciones más rápidas rondaban los 10 segundos. Mi agente abre el INDEX.md, sigue el punto de partida que necesita y se pone a trabajar sin deambular. No cambió ninguna capacidad en el lado de mi agente. La estructura de carpetas dejó de desperdiciar la mayor parte antes de que la tarea siquiera comenzara.
La estructura de carpetas es una jaula que construí que limita cómo se mueve mi agente sin limitar lo que mi agente puede hacer. Dentro de la jaula, mi agente corre libremente. Sin ella, Hermes tiende a desviarse y tengo que perder mi tiempo señalándole el archivo correcto.
Pasarme a Hermes me permitió construir ese tipo de sistema a través de archivos, proveedores y memoria todo a la vez, y el patrón INDEX.md es la pieza más pequeña que marcó la mayor diferencia en el día a día.
Toda jaula tiene un candado
Mi primer error fue añadir INDEX.md a cada subcarpeta. Demasiados mapas significan que mi agente pasa el tiempo leyendo índices en lugar de hacer trabajo. Mantengo INDEX.md solo en la raíz de las carpetas principales como Marca y Estrategia Editorial, donde hay suficientes subcarpetas como para necesitar un mapa. Dentro de una subcarpeta pequeña con cuatro o cinco archivos, Hermes navega directamente sin ningún mapa.
Ten en cuenta que la numeración se vuelve tediosa cuando añades carpetas nuevas. Tengo que decidir dónde encaja una nueva carpeta en la secuencia, y a veces la agrego al final en lugar de renumerar todo. Eso está bien. Los números no tienen que ser perfectos siempre que sean direccionales. Las carpetas perfectamente ordenadas no son el objetivo, y tratarlas como tal convierte una solución práctica en un proyecto cosmético.
Un error mayor es construir estructura antes de que tu agente muestre confusión. La mayoría de la gente sobreingenieriza la configuración de su agente porque piensa que necesita una infraestructura adecuada.
Mi regla actual sigue el mismo principio detrás de elegir MCPs frente a CLIs frente a tu propia herramienta. Usa la interfaz más pequeña que haga el trabajo. Añade estructura solo cuando tu agente se pierda, y añade solo la estructura suficiente para solucionar ese problema específico.
Otro fallo con el que me topé fue anidar estructura dentro de estructura. Añadí subcarpetas dentro de subcarpetas para tener todo perfectamente categorizado, lo que convirtió una jerarquía de dos niveles en una de cinco niveles. Mi agente entonces tenía que leer múltiples archivos INDEX y analizar múltiples secuencias de numeración para llegar a un solo archivo. Colapsé esos niveles extra de nuevo en subcarpetas planas y la navegación se aceleró de nuevo.
La profundidad es enemiga de la búsqueda rápida de archivos, y la mayoría de las reorganizaciones añaden profundidad pensando que es precisión.
Mide antes de reorganizar
Antes de tocar una sola carpeta, ejecuta esta prueba en tres tareas reales que tu agente maneje más a menudo. Cronometra cada una y anota cuántos archivos abre antes de encontrar el correcto. Registra con qué frecuencia elige el archivo equivocado o se detiene para preguntarte cuál usar.
Cualquier tarea que le lleve a tu agente más de treinta segundos o que abra tres o más archivos incorrectos apunta a una carpeta detrás de esa tarea que está rota.
Elige el fallo que ocurre más a menudo. Abre esa carpeta y escribe un INDEX.md que liste cada subcarpeta y archivo importante, además de por dónde debe empezar tu agente. Guárdalo. Ejecuta la misma tarea de nuevo.
Si tu agente encuentra el archivo correcto en menos de treinta segundos, la solución funcionó y ahora conoces el patrón. Aplícalo a la siguiente carpeta rota. Si todavía falla, el problema probablemente sea la numeración o una carpeta por ámbito, y esos son los dos siguientes pasos a corregir.
Empieza con la carpeta que más tiempo desperdicie, arréglala y pasa a la siguiente solo cuando estés listo.
Donde los barrotes aún se doblan
El contenido archivado aún se referencia a veces cuando necesito un briefing antiguo para contexto. Mi agente tiene que saber que debe mirar en 06.Archivado en lugar de las carpetas activas, y lo menciono en el INDEX.md para que sepa dónde vive el material histórico. Sin esa nota, mi agente asume que el contenido archivado no existe.
Además, Obsidian Sync crea problemas ocasionales cuando no se sincroniza correctamente entre dispositivos. Si actualizo un archivo en mi portátil pero la versión anterior aún está en mi VPS, Hermes carga la copia del VPS y la trata como la fuente de verdad actual. Eso es más un problema de sincronización que de estructura de carpetas, pero se manifiesta dentro del sistema de carpetas porque el agente solo ve los archivos que tiene delante.
La numeración se rompe cuando tienes tantas carpetas que la secuencia se vuelve sin sentido. Más allá de diez o doce elementos numerados en un nivel, los números empiezan a ser arbitrarios.
Intento mantener las categorías principales por debajo de ese umbral y anidar estructura más profunda dentro en lugar de expandir el nivel superior.
Renombrar es otra fuente de fricción. Cuando reorganizo, a veces renombro carpetas para que coincidan mejor con su propósito, y cualquier referencia en INDEX.md al nombre antiguo se rompe hasta que la actualizo. Ahora intento fijar los nombres de las carpetas una vez y dejarlos en paz, porque un nombre ligeramente incómodo es más barato que una referencia rota.
Esta estructura funciona mejor para flujos de trabajo intensivos en contenido y en planificación. Los flujos de trabajo puramente de código o intensivos en datos podrían necesitar principios de organización completamente diferentes, y el patrón INDEX.md no resuelve todos los problemas de navegación.
Todo lo que he escrito en este artículo se remonta a un instinto. Sé dueño de la capa que importa. Construí mi stack para que ninguna empresa controle mis herramientas. Construí mi bóveda para que ningún desorden controle a mi agente. El mismo principio, desde los proveedores hasta las carpetas y lo que venga después.
La capacidad es barata cuando el andamiaje que la rodea está roto. Construye el andamiaje, y la capacidad se cuida sola. Un archivo índice y unos pocos números delante de los nombres de tus carpetas es la diferencia entre un agente que deambula y un agente que funciona.
Si te fue útil, sigue a @wandermist para más contenido como este.
