La semana pasada leí sobre una IA que diseñó una vacuna contra coronavirus que aún no hemos enfrentado (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 el salto. Pero cuando le pido que obtenga mi último brief de una lista de documentos, puede pasarse casi dos minutos abriendo archivos equivocados en mi bóveda solo para mostrarme un brief 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 marca la diferencia en tu flujo de trabajo y productividad.
Nunca construí un andamiaje a propósito, hasta hace poco. Se acumuló 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 surgió 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 nuevo 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 de í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 capacidad del propio agente, y aquí te muestro cómo construirlo
- Una prueba de diagnóstico que puedes ejecutar en cinco minutos para ver si la estructura de tus carpetas es el verdadero problema
La estructura que tu agente no puede ver
Organicé mi bóveda como lo hace la mayoría. Artículos, investigación, activos, documentos de estrategia, cada uno en su propia carpeta. Esa estructura se sentía limpia porque pienso en tipos de contenido. Las carpetas se corresponden 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 requiere 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á vigente 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, 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 abría un montón de archivos antes de dar con el correcto, o agarraba una versión archivada cuando el archivo actual estaba en otro lado. Peor aún, preguntaba qué archivo usar cuando la respuesta debería haber sido obvia por el contexto. Esto pasaba con todos los modelos que usé, incluyendo Opus, GPT 5.5, Qwen y GLM.
El patrón se repetía y yo me quedaba viendo las mismas búsquedas lentas ocurrir tarea tras 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 quiebre 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 se veían así antes de que cambiara algo.
Antes de cambiar nada:
- Encontrar el brief del artículo actual: 7 archivos abiertos, 2:00 hasta el archivo correcto;
- Encontrar las definiciones de colores de 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 trata los números exactos como indicativos.
Cada tarea cruzaba múltiples carpetas. La mayoría abría versiones archivadas antes de encontrar las activas. Mi agente estaba quemando 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 vi cómo hacía 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 área, numerada para 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 dónde debería 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 se ve así después de la reorganización.
105.Brand/2├── INDEX.md3├── 01.Brand System/4├── 02.Editorial Strategy/5├── 03.Promotion/6├── 04.Public Deliverables/7├── 05.Operating Plan/8└── 06.Archived/
Esta estructura organiza por área en lugar de por tipo de contenido. Cada área 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 del orden alfabético. 01. Brand System se lee antes que 02. Editorial Strategy. Mi agente no adivina. Los números dentro de las carpetas hacen lo mismo con los archivos, así que mi agente sabe que 01. Articles es el punto de partida antes que 02. Previous Articles.
Pongo un número al inicio de los nombres de las carpetas porque también me resulta más fácil recordarlo a mí.
Así es como todo mi stack de Hermes de $30 se mantiene fácil de mover a través de docenas de carpetas sin que mi agente se pierda.
Lo archivado vive en 06.Archived, donde van los briefs antiguos y los planes retirados a esperar. Mi agente sabe que no debe buscar allí a menos que yo pida específicamente contexto histórico. Esa separación es lo que mantiene limpias las carpetas activas y rápidas las búsquedas.
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 se ve así.
1# Brand Index23This folder holds the current brand system.45## Folder Map67| Folder | Purpose | Updated |8|---|---|---:|9| `01.Brand System/` | Visual identity, topic scope, voice | 2026-06-11 |10| `02.Editorial Strategy/` | Article direction, title rules, queue | 2026-06-11 |11| `03.Promotion/` | Launch, distribution, tool strategy | 2026-06-11 |1213## Canonical Files1415| File | Purpose |16|---|---|17| `01.Brand System/01. Brand System.md` | Visual identity, colors, typography |18| `02.Editorial Strategy/01. Articles.md` | Article queue, title rules |1920## Where To Go2122- Start with `01.Brand System/04. Direction.md` for mission23- Use `02.Editorial Strategy/01. Articles.md` for article selection
INDEX.md pasó por tres versiones. Mi primera versión listaba cada archivo dentro de la carpeta de marca y ocupaba cuarenta líneas. Era técnicamente completa, pero mi agente tenía que analizarla cada vez y la longitud era su propia sobrecarga. Mi segunda versión fue demasiado corta, unas quince líneas, y mi agente seguía haciendo preguntas que no había respondido. Esta tercera versión lista solo subcarpetas y archivos canónicos, con una breve sección "Hacia dónde ir" que le dice 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.Brand/INDEX.md, abre 03.Promotion/01. Promotion Strategy.md y se pone a trabajar. Los tiempos después de la reorganización se ven así.
Después de la reorganización:
- Encontrar el brief del artículo actual: 1 archivo abierto, 0:10
- Encontrar las definiciones de colores de 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 rondaron los 10 segundos. Mi agente abre el INDEX.md, sigue el punto de partida que necesita y se pone a trabajar sin vagar. No cambió ninguna capacidad del 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í y 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 yo pierdo tiempo señalándole el archivo correcto.
Migrar 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 agregar INDEX.md a cada subcarpeta. Demasiados mapas significa que mi agente pasa el tiempo leyendo índices en lugar de hacer trabajo. Solo mantengo INDEX.md en la raíz de las carpetas principales como Brand y Editorial Strategy, 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 agregas 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 las personas diseñan en exceso la configuración de su agente porque piensan que necesita una infraestructura adecuada.
Mi regla actual sigue el mismo principio detrás de elegir MCPs versus CLIs versus tu propia herramienta. Usa la interfaz más pequeña que haga el trabajo. Agrega estructura solo cuando tu agente se pierda, y agrega solo la estructura suficiente para solucionar ese problema específico.
Otro fallo que encontré fue anidar estructura dentro de estructura. Agregué 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 tenía que leer múltiples archivos INDEX y analizar múltiples secuencias numéricas para llegar a un solo archivo. Compacté esos niveles adicionales de nuevo en subcarpetas planas y la navegación se aceleró otra vez.
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 con más frecuencia. 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 tome 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 ocurra con más frecuencia. Abre esa carpeta y escribe un INDEX.md que liste cada subcarpeta y archivo importante, además de dónde debería 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 aún falla, el problema probablemente sea la numeración o la regla de una carpeta por área, y esos son los dos siguientes pasos a solucionar.
Empieza con la carpeta que más tiempo desperdicie, arréglala y pasa a la siguiente solo cuando estés listo.
Donde las barras aún se doblan
El contenido archivado todavía se referencia a veces cuando necesito un brief antiguo para contexto. Mi agente tiene que saber que debe buscar en 06.Archived en lugar de en las carpetas activas, y menciono esto 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 laptop 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. Pasados 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 quietos, porque un nombre ligeramente incómodo es más barato que una referencia rota.
Esta estructura funciona mejor para flujos de trabajo con mucho contenido y para los que requieren mucha planificación. Las configuraciones de solo código o con muchos 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 de índice y unos pocos números delante de los nombres de tus carpetas es la diferencia entre un agente que vaga y un agente que funciona.
Si te fue útil, sigue a @wandermist para más contenido como este.
