Cuando le hablas a la IA en un chat suelto, le pides que adivine con lo que recuerda de su entrenamiento. Cuando le abres una carpeta, deja de adivinar y empieza a leer. La IA seria empieza siempre así: con una carpetita en el escritorio. Lo demás es entretenimiento.
Cuando la mayoría de la gente abre una IA, ve un chat. Y piensa que ese chat es la IA. Es como confundir el camarero con el restaurante.
Un modelo de lenguaje no contiene tu información. Solo tiene los pesos del entrenamiento (conocimiento general) y lo que le pasas en cada turno (el contexto). Si no le das contexto local, el modelo opera con lo que recuerda de su entrenamiento, que ya alucina por definición.
La sesión de chat no es un cerebro: es un canal por el que pasan tus mensajes y los archivos que tú le abres. La IA "real" en cada momento es la suma de tus instrucciones más los archivos que tiene a mano para leer.
Imagínate una abogada brilliantísima a la que llamas por teléfono. Sabe muchísimo de leyes y de jurisprudencia, pero no sabe nada de tu caso hasta que se lo cuentas.
Si solo le hablas, va a opinar con lo que recuerda de otros casos parecidos. Si le mandas la carpeta del expediente, ya puede defenderte de verdad.
El chat es la llamada. La carpeta es lo que cambia el desenlace.
Hay tres niveles, y la diferencia entre ellos es brutal. Saber en cuál estás cambia tu relación con la herramienta.
Nivel 1, chat vacío: el modelo opera solo con sus pesos y tu prompt. Máxima superficie de alucinación posible. Útil para preguntas generales, no para trabajar sobre algo concreto tuyo.
Nivel 2, chat con carpeta cargada: el agente lee los archivos del proyecto que has abierto. Las respuestas se anclan al contenido real. La alucinación se reduce drásticamente porque puede contrastar antes de hablar.
Nivel 3, chat con carpeta más skills más agent.md: tienes una IA especialista. Sabe cómo trabajar en tu proyecto concreto, con tus reglas, tu estructura y tus convenciones. Es lo más cerca que vas a estar de tener un agente que entiende cómo funcionas.
Nivel 1: una experta a la que llamas por teléfono. Sabe mucho, pero no sabe lo tuyo.
Nivel 2: la misma experta, ahora con tu carpeta abierta delante. Lee, mira, contrasta. Cuando te contesta, te contesta sobre TU caso, no sobre casos que ha visto antes.
Nivel 3: la misma experta, con tu carpeta abierta, con tu manual de la casa al lado y con tus instrucciones pegadas en la pared. Trabaja como si llevara años contigo. Esto es tener una mini-yo de verdad.
La frase que tienes que tatuarte para no olvidarla nunca. Cuando alguien te diga que está usando IA en serio, mira si tiene carpetita.
Un proyecto serio con IA empieza creando un directorio físico en tu sistema de archivos local. Esa carpeta es el workspace: el sitio que el agente abre y donde opera.
No es metafórica. Existe en tu disco, tiene una ruta, la puedes ver, copiar, mover. Cualquier IDE moderno se conecta a ella y permite que el agente lea, escriba y modifique los archivos directamente.
Sin workspace no hay agente. Hay un chat, que es otra cosa.
No hay médica buena sin consulta. No hay cocinera buena sin cocina. No hay mini-yo útil sin una carpetita en el escritorio.
Esto no es un capricho técnico. Es la diferencia entre tener un sitio donde poner las cosas o no tenerlo. Sin sitio físico, no hay método. Sin método, todo se vuelve a empezar cada lunes.
Si la carpeta es el cuerpo del proyecto, agent.md es el ADN. Un archivo de texto plano que le dice al agente quién eres, qué haces aquí y cómo se trabaja en esta casa.
agent.md es un archivo en la raíz del workspace que contiene las instrucciones maestras para el agente. Dentro suele haber: descripción del proyecto, lenguaje y convenciones de código, estructura de carpetas, reglas estilísticas, errores conocidos, fuentes de verdad, criterios de calidad.
Cuando el agente entra al workspace, lo lee antes de hacer nada. Es un onboarding silencioso.
Sin agent.md, cada conversación empieza de cero. Con agent.md, el agente ya sabe cómo te gusta trabajar y por dónde empezar.
Imagínate que contratas a una asistenta nueva cada lunes. Si cada semana le tienes que explicar quién eres, qué hace tu empresa, cómo te gusta el café y dónde están las llaves, vas a perder horas explicando lo mismo.
agent.md es el documento que esa asistenta lee en su primer minuto y ya sabe todo lo que necesita. Da igual cuántas veces empiece de cero: con ese papel sobre la mesa, llega informada.
Aquí hay un detalle técnico que te ahorra disgustos. La IA no lee bien los PDFs. Los lee a medias. Y hasta que esto no se interioriza, se cometen errores serios.
Un PDF es un contenedor complejo: texto, imágenes, tablas, columnas, codificaciones distintas, OCR variable. Los modelos extraen aproximadamente la mitad del contenido y a veces lo extraen desordenado.
Markdown (.md) es texto plano con marcado mínimo. El modelo lo lee íntegro, en orden, sin pérdidas.
Regla práctica: cualquier documento que quieras que el agente trabaje en serio, conviértelo a markdown antes de meterlo en el workspace. Existen pipelines de OCR más limpieza que lo hacen en segundos.
Si metes un PDF largo y le pides un análisis, te va a inventar la mitad de los datos con cara seria.
El PDF es como una vitrina de pastelería empañada. Es bonita, pero tienes que arrimar la cara y mirar de lado para ver bien lo que hay dentro, y aún así te pierdes la mitad de los pasteles.
El markdown es un papel limpio con la receta escrita a máquina. Lo lees de un vistazo y te enteras de todo.
Si quieres que tu mini-yo cocine bien, dale la receta en papel limpio. Si le das la vitrina empañada, va a inventarse los ingredientes que no ve.
Así se ve por dentro una carpeta de proyecto bien montada. No tiene mucho misterio, pero tiene método.
Un workspace básico tiene esta forma:
La regla es simple: cualquier archivo que la IA tenga que leer va dentro de esa carpeta. Si está fuera, no existe para el agente.
Esto cambia cómo organizas tu trabajo: dejas de tener archivos sueltos por OneDrive y empiezas a tener proyectos cerrados, autocontenidos, listos para que un agente entre y se ponga a trabajar.
Es un piso pequeño bien organizado. La carpeta principal es el piso. En la entrada están las normas de la casa (agent.md). Hay un cuarto donde guardas las habilidades de la mini-yo (skills/). Un archivador con la documentación (docs/). Un cajón con los datos (data/). Y, si es un proyecto técnico, un taller con el código (src/).
Todo lo que esté fuera del piso, la mini-yo no lo ve. Si quieres que trabaje con algo, lo metes dentro. Si no, es como pedirle a la asistenta que ordene una habitación a la que no le has dado la llave.
Una clase para entender lo invisible. La IA no es la conversación que tienes con ella. La IA es la suma de la conversación más todos los archivos a los que puede acceder mientras te responde.
La diferencia entre una IA que te impresiona el primer día y una IA que te ayuda de verdad cada día está en una carpeta. Dentro de esa carpeta pones agent.md para decirle cómo trabajas, conviertes los PDFs a markdown para que pueda leerlos enteros, y organizas la información en un sitio físico al que vuelve siempre.
Esto suena pequeño y aburrido. Pero es lo que separa a alguien que usa IA de alguien que trabaja con IA.
La próxima vez que veas a alguien presumir de su flujo con IA, mira lo primero de todo: ¿hay carpeta en el escritorio?
Si no la hay, no hay método. Hay show.
No hay IA sin una carpetita hecha en el escritorio. No existe, es que no existe.