Hay una decisión que se toma antes de elegir el modelo, antes de escribir el primer prompt, antes de armar el primer archivo. Es la estructura de carpetas del repositorio. Y es la decisión que más define si una práctica de IA escala o se rompe.
La mayorÃa arranca al revés. Eligen primero la herramienta — un Claude, un ChatGPT, un agente, un MCP. Después escriben el prompt. Y al final, cuando la cosa empieza a crecer, descubren que no tienen dónde guardar lo que aprendieron. Improvisan una carpeta. Después otra. Después un Drive paralelo. Y a las pocas semanas el sistema deja de ser un sistema y vuelve a ser un montón de archivos sueltos.
Folder Structure es el orden inverso. Primero se diseña la estructura de carpetas. Después se llenan con archivos. Después se conectan las herramientas de IA encima. Esa secuencia — Folder Structure first → File System first → AI first — no es accidental. Es lo que hace que una práctica de IA se sostenga en el tiempo.
La carpeta antes que el archivo. El archivo antes que el modelo.
Folder Structure first → File System first → AI first
Las tres capas existen al mismo tiempo, pero se diseñan en ese orden. Y cada capa decide lo que la siguiente puede hacer.
Folder Structure es la capa más alta. Define qué carpetas existen, cómo se nombran, qué jerarquÃa tienen entre ellas. Es la pregunta de qué información merece existir como una unidad propia. Es la capa más estable: una vez decidida bien, casi no se toca.
File System es la capa intermedia. Vive adentro de las carpetas. Son los archivos markdown — criterios, plantillas, procesos, contextos — escritos en formato que la IA puede leer. Es donde se documenta el cómo y el por qué. Cambia con el uso, se mejora con cada iteración.
AI es la capa que opera encima. Son los modelos, los agentes, los skills, las integraciones. Es la capa más visible y, paradójicamente, la menos importante. La IA cambia cada seis meses; la folder structure se sostiene años.
Diseñar en este orden tiene una consecuencia operativa: cuando aparece un modelo nuevo, no hay que reescribir nada. Cuando un cliente pide algo distinto, no hay que rearmar la lógica desde cero. Cuando alguien se suma al equipo, alcanza con que mire la estructura de carpetas para entender cómo se trabaja.
Diseñar al revés tiene la consecuencia opuesta: cada cambio te obliga a tocar todo.
AnatomÃa de un Folder Structure
Un Folder Structure aplicado a IA tiene cuatro carpetas que aparecen casi siempre, en variantes:
clientes/ — una subcarpeta por cliente, área o cuenta. Es el contenedor de información variable, lo que cambia caso a caso.
criterios/ — las reglas no escritas que normalmente viven en la cabeza de quien decide. Tono, prioridades, qué se hace y qué no se hace.
plantillas/ — los formatos que se reusan. Estructura de un email, esqueleto de un brief, formato de un reporte mensual.
procesos/ — los flujos que tienen secuencia. Paso 1, paso 2, qué chequear antes de pasar al siguiente paso.
La forma concreta de una folder structure para producción de emails podrÃa verse asÃ:
clientes/
pedidosya/
criterios/voz.md
plantillas/email-base.md
procesos/ciclo-mensual.md
rappi/
criterios/voz.md
plantillas/email-base.md
criterios/
tono-comunicacion.md
cuando-decir-no.md
plantillas/
brief-creativo.md
reporte-mensual.md
procesos/
generar-copy-para-ads.md
qa-final.mdLo que se ve no es solo cómo están organizados los archivos. Es cómo está organizado el pensamiento detrás. La estructura de carpetas obliga a separar lo que es propio de un cliente (clientes/pedidosya/) de lo que es transversal a todos (criterios/). Lo que es plantilla especÃfica de cliente, de lo que es plantilla genérica. Lo que es proceso puntual, de lo que es proceso de empresa.
Cuando esa separación está bien hecha, agregar un cliente nuevo no requiere rediseñar nada: alcanza con duplicar la subcarpeta. Cambiar un criterio de empresa no obliga a tocar archivo por archivo de cada cliente: se edita un solo archivo en criterios/. La estructura misma evita el trabajo redundante.
Por qué la carpeta importa más que el prompt
Acá está la parte contraintuitiva.
Un mismo prompt, ejecutado contra dos folder structures distintas, produce resultados radicalmente distintos. Y la diferencia no está en el modelo, ni en el prompt, ni en el contexto inmediato. Está en qué archivos está mirando la IA en ese momento.
La carpeta es scope. Cuando le pasás a la IA clientes/pedidosya/, le estás diciendo "aplicá criterio de PedidosYa". Cuando le pasás clientes/rappi/, le estás diciendo otra cosa. El prompt puede ser literalmente el mismo. Lo que cambió es la carpeta de origen.
La carpeta es contexto. Una IA que lee un archivo aislado no entiende dónde vive. Una IA que lee un archivo dentro de una carpeta entiende qué hay alrededor: qué hermanos tiene ese archivo, qué carpeta padre lo contiene, qué jerarquÃa implÃcita hay. La estructura de carpetas le da al modelo una pista que no está escrita en el archivo.
La carpeta es composición. La misma operación — "armame un email" — se puede componer de formas distintas según qué carpetas se le pasen como contexto. clientes/pedidosya/ + plantillas/email-base.md + criterios/tono-comunicacion.md es una composición. Cambiar uno solo de esos elementos produce un output distinto.
El prompt deja de ser el lugar donde vive la inteligencia del sistema. Pasa a ser una operación corta — cuatro o cinco lÃneas — que combina contexto que ya está estructurado en otro lado.
El prompt es la operación. La folder structure es el sistema.
Folder Structure vs File System vs AI
Las tres capas se confunden seguido. Vale la pena definirlas con precisión.
Folder Structure es el contenedor estructural. Carpetas y subcarpetas. Define la jerarquÃa. No tiene contenido propio: lo que tiene son nombres y relaciones. Es la capa más arquitectónica y la más estable.
File System es el contenido. Archivos markdown — prosa estructurada — que viven adentro de las carpetas. Es donde se documenta el criterio, donde viven las plantillas, donde se escriben los procesos. Es la capa donde se acumula el conocimiento de la práctica.
AI es la capa de operación. Modelos, agentes, skills, MCPs, integraciones. Lee la folder structure y el file system, y produce output. Es la capa más visible para el usuario final, pero también la más reemplazable: el modelo que se usa hoy probablemente no es el que se va a usar en seis meses.
La regla operativa: si una decisión se puede tomar en una capa más baja, tiene que tomarse ahÃ. Una restricción que se puede expresar como una carpeta no tiene por qué vivir en un prompt. Un criterio que se puede escribir en un archivo no tiene por qué vivir adentro de un agente. La capa más alta absorbe la decisión más estable; las capas inferiores quedan libres para cambiar.
Casos donde se ve
Los tres builds publicados en Mate & Build muestran folder structures reales aplicadas a problemas distintos.
El caso de Manu en PedidosYa es una folder structure de producción de emails. Una carpeta brand/ con criterios y voz. Una carpeta plantillas-html/ con componentes que ya pasaron QA en Outlook, Gmail y Apple Mail. Una carpeta flujos/ con los pasos del proceso interno entre legal, brand y desarrollo. La estructura misma resuelve el problema de coordinación: cada equipo sabe dónde aporta, y la IA sabe qué leer en cada momento.
El caso de Franco en Rufus es una folder structure organizada por proceso creativo, no por cliente. research/, brainstorming/, strategy/, content-strategy-final/. Cada paso del flujo creativo tiene su carpeta con criterios y plantillas. Encima opera un sistema de skills coordinadas. La folder structure refleja el flujo de trabajo: la jerarquÃa de carpetas es el proceso.
El caso de Lupa en marketing bancario muestra una folder structure replicable basada en el skill UI/UX Max Pro. La estructura quedó pensada para que Lupa pueda agregar un cliente o un caso nuevo duplicando una subcarpeta y cambiando los archivos puntuales. Lo que se construyó no fue solo el output de esa semana: fue la capacidad de producir el output todas las semanas.
Lo que tienen en común los tres casos no es la herramienta. Es que el diseño empezó por la carpeta.
Cómo arrancar tu propio Folder Structure
No hace falta un proyecto grande. Cuatro pasos alcanzan para tener algo funcional en una tarde.
1. Identificá los clientes o áreas que se repiten. ¿Hay tres clientes con los que trabajás todas las semanas? ¿Hay cuatro áreas internas que repiten el mismo flujo? Esas son las subcarpetas de clientes/. La regla es: si algo aparece más de una vez con variaciones, merece su propia carpeta.
2. Bajá los criterios que solo viven en tu cabeza. Las reglas no escritas — cómo se le habla a tal cliente, cuándo decir que no, qué señales son banderas rojas — van en criterios/, un archivo por criterio. No es necesario que estén perfectos. Es necesario que estén afuera de tu cabeza.
3. Convertà en plantilla lo que hacés todas las semanas. Si armás un email de cierre todos los lunes, eso es una plantilla. Si escribÃs un brief con la misma estructura, eso es una plantilla. Una plantilla por archivo en plantillas/, con la estructura, los placeholders y un par de ejemplos.
4. Documentá los procesos que tienen secuencia. Cuando hay un paso 1 y un paso 2 que importan, eso es un proceso. Va en procesos/, con los pasos en orden y los chequeos intermedios.
En esta etapa no hace falta conectar ninguna IA todavÃa. La folder structure se valida sin el modelo: si un colega puede mirar la estructura y entender cómo trabajás, está bien diseñada. Si no, hay que reordenar antes de seguir.
Una vez que la estructura está estable, conectar la IA es la parte rápida.
El orden no es una sugerencia
Folder Structure first → File System first → AI first es una secuencia con consecuencias. Diseñar al revés produce sistemas que parecen funcionar al principio y se rompen en cuanto cambia algo. Diseñar en orden produce sistemas que se sostienen aunque cambie el modelo, el cliente o la persona que opera.
La carpeta es donde vive la decisión más cara — la de arquitectura. El archivo es donde vive el conocimiento. La IA es donde vive la operación. Las tres importan, pero solo en ese orden.
Si querés ver cómo se traduce esto a un repositorio real, la nota sobre file system para IA describe la capa intermedia con detalle. La nota sobre vibe coding explica cómo se trabaja desde la conversación una vez que la estructura está armada. Y la nota sobre aprender IA construyendo explica por qué la única forma de aprender esto es haciéndolo, no leyéndolo.
O venite a la mesa con tu problema y armamos la folder structure juntos en una tarde.
Learn by Doing. 🧉