El modo agente empieza en el explorador de archivos
Lo que vas a aprender
- El modo agente no empieza con el prompt: empieza organizando tus carpetas
- Separar fuentes de salidas te da control total sobre lo que hace el agente
- El archivo AGENTS.md es tu primera automatización: explicale al agente una vez y no volvás a repetirte
Este desorden que ves es lo que hace que tus agentes no trabajen de la forma correcta. Porque todo el mundo habla de contexto, contexto, contexto… pero en una aplicación de escritorio en modo agente, ¿cómo le das contexto a ese agente?
Cuando sos contador y querés hacer una conciliación bancaria, unos estados financieros o —en esta época— declaraciones de renta de persona natural, lo primero que tenés que hacer es tener orden. Y saber cómo ese orden afecta a los agentes y cómo trabajamos todos los días de forma más eficiente.
El modo agente no empieza cuando empezás a escribir el prompt. Empieza en el explorador de archivos, cuando empezás a organizar tus carpetas.
Por qué el chat te malacostumbró
Esto es ChatGPT. Y vos estabas acostumbrado a entrar al chat y juntar archivos directamente ahí, arrastrándolos uno por uno.
En modo agente no se trabaja así. De hecho, podrías perfectamente coger los archivos y llevarlos al chat, pero esa no es la forma correcta de trabajar con un agente. ¿Por qué? Porque los agentes trabajan a través de proyectos. Traducción: como nosotros hemos venido trabajando toda la vida — en carpetas.
La idea no es que abras un chat de Claude, de OpenCode o de cualquier aplicación agéntica y le adjuntes archivos. La idea es que directamente le digas al sistema que lo abra en una carpeta. Y es en esa carpeta donde vas a agregar todos los archivos, todos los papeles de trabajo que necesitás para hacer el trabajo.
Porque a su vez, esa carpeta es la que constituye el contexto que va a tener el agente.
Una carpeta por proyecto
Toda la vida hemos trabajado con nuestros clientes y ya tenemos una organización de carpetas y archivos en nuestros equipos. Para no chocar con eso, lo que hacemos es crear una carpeta nueva. Llamala “Proyectos” o como quieras.
Para este ejemplo: creamos una carpeta que se llama conciliaciones. Ahí metemos los archivos fuente —un auxiliar y un libro de bancos— y luego en la aplicación agéntica entramos a esa carpeta.
Al abrirla como proyecto, le dimos como contexto al agente únicamente esa carpeta. No todas las demás. Si le preguntás “¿qué archivos hay en el proyecto?”, te va a responder exactamente lo que está en esa carpeta. Con eso corroborás que el contexto está correcto.
Esa es la forma correcta. No subir archivos por el chat. Los archivos están disponibles en la carpeta.
Fuentes y salidas: la estructura que te da control
Cuando empecés a trabajar con un agente, vas a ver que el agente empieza a crear una cantidad de archivos. Entonces si tenés una carpeta con tus archivos de conciliación bancaria, se te van a mezclar con todos los archivos intermedios que el agente crea para procesar.
¿La solución? Dos carpetas adentro de tu proyecto:
fuentes: acá ponés los archivos fuente, los papeles de trabajo que vas a usar.salidas: acá le pedís al agente que te entregue el trabajo.
Y entonces tu prompt cambia. Ya no es “tomá estos archivos y hacé tal cosa”. Es:
“Tomá los archivos de
fuentesy creame una conciliación bancaria en un HTML autocontenido en la carpetasalidas.”
El agente va a trabajar, va a crear sus archivos intermedios donde corresponda, pero el entregable va a quedar limpio en salidas. Sin archivos regados. Sin caos.
Y esto es solo el principio. Podrías crear carpetas intermedias para tener entregables parciales que te sirvan para auditar que lo que está haciendo el agente sea real.
El resultado: control total, cero caja negra
Cuando el agente termina, abrís la carpeta salidas y ahí está tu HTML autocontenido. Lindo, ordenado. ¿La información es correcta? Eso ya toca analizarlo vos —porque el criterio lo tenés vos. El agente es tu copiloto, no tu reemplazo.
Pero el objetivo se cumplió: no tenés archivos regados, el entregable está en la carpeta que corresponde, y vos tenés control total de lo que está haciendo el agente.
Esto es importante porque deja de ser una caja negra. Al ordenar las carpetas y pedirle al agente que haga cada cosa en su lugar, vos mantenés el control. El agente ejecuta, vos decidís.
La ñapa: AGENTS.md
Hay una cosa más que podés hacer y que es el primer paso hacia automatizaciones serias.
Cuando creás un proyecto, lo primero que deberías hacer —o lo que podés hacer— es decirle al agente de qué se trata ese proyecto. Una sola vez.
¿Cómo? Le decís al agente: “Iniciame el proyecto”. Él va a crear un archivo que se llama AGENTS.md (o CLAUDE.md, según la aplicación) dentro de la carpeta, con las instrucciones del proyecto:
- “Este es un proyecto para hacer conciliaciones bancarias”
- “Las fuentes siempre van en la carpeta
fuentes” - “Los entregables siempre son HTML autocontenidos en la carpeta
salidas”
¿Lo mejor? Este archivo funciona con cualquier aplicación agéntica: OpenCode, Claude Code, Claude Cowork, GPT-5 Codex, Antigravity… es transversal. No importa cuál uses.
Cada vez que abras ese proyecto, el agente va a leer ese AGENTS.md y ya va a saber para qué sirve. No vas a tener que volver a explicarle nada.
AGENTS.md es tu primera automatización. Lo creás una vez y nunca más repetís las instrucciones.
Tu tarea de hoy
Hoy vas a hacer esto:
- Creá una carpeta nueva para un proyecto.
- Adentro creá
fuentesysalidas. - Supongamos que le estás haciendo la declaración de renta de persona natural a un cliente. En
fuentesmetele los extractos bancarios, el pago de salud y pensión, el informe que la DIAN entrega sobre el contribuyente… todas las fuentes que usás para hacer la declaración. - Decile al agente algo como:
“Sos un experto tributarista en Colombia. Con los archivos de
fuentes, creame un borrador de renta para 2026 y ponelo ensalidascomo HTML autocontenido.”
¿Te va a entregar la declaración lista? Probablemente no. Pero se puede acercar mucho. Y dependiendo del modelo que elijas, te puede sorprender.
⚠️ Importante: por ahora, mientras esta tecnología evoluciona, nunca dejés que un agente trabaje directamente con tus archivos fuente originales. Trabajá en carpetas duplicadas. Copiá los archivos, trabajá ahí, y si querés al final borrás la carpeta. Pero no arriesgués tus datos.
¿Te sirvió? Suscribite al canal para más contenido sobre agentes, automatización y cómo usar la IA en el día a día profesional.