Cómo crear tu agente de IA con una carpeta: estructura, plantilla de AGENTS.md y las 2 reglas de oro (guía 2026)

📅 Actualizado: noviembre 2026 · ⏱️ Lectura: 11 minutos

Qué vas a conseguir

• Un agente que se sabe tu negocio: tus precios, tu tono y tus servicios, sin que se lo expliques cada mañana.
• Que deje de inventarse datos y te pregunte cuando le falte algo.
• Que cada corrección que le hagas se quede guardada y la próxima vez lo haga bien.
• No depender de una sola IA: la misma carpeta funciona en Claude, ChatGPT o Gemini.
• La plantilla completa de AGENTS.md y de la estructura, lista para copiar.

Qué es un agente de IA (y por qué es solo una carpeta)

Un agente de IA es una IA que trabaja para ti con contexto propio: sabe quién eres, cómo trabajas y qué tiene que hacer, y hace tareas completas (un presupuesto, una respuesta a un cliente, un post) en vez de contestar preguntas sueltas.

Lo que convierte un chat en un agente no es un programa especial. Es lo que la IA sabe antes de empezar. Y eso se guarda en archivos.

Piensa en un empleado nuevo. El primer día no necesita un ordenador mejor: necesita que alguien le explique cómo funciona la empresa, le enseñe cómo se hace cada tarea, le deje apuntar lo que va aprendiendo y le dé una mesa por cliente. Eso son las 4 carpetas. Y el manual de bienvenida que lee primero es el AGENTS.md.

La ventaja de hacerlo así, con archivos y no dentro de una herramienta concreta:

1. Es tuyo. Vive en tu ordenador o en tu Drive, no en la cuenta de una empresa que mañana cambia sus planes.
2. Se puede llevar a cualquier IA. Si mañana sale un modelo mejor, le das la misma carpeta.
3. Mejora con el uso. Cada corrección se guarda en un archivo que la IA vuelve a leer.

La estructura: 4 carpetas y un manual

Esta es la estructura completa. Créala tal cual en tu ordenador (o en Google Drive) y cambia luego los nombres de los archivos si quieres:

Los archivos .md son texto normal (Markdown). Se crean con el Bloc de notas, con TextEdit o con Obsidian, que es gratis y te enseña las carpetas de forma cómoda. También puedes escribirlos en Google Docs y descargarlos como texto.

Así es la carpeta de IAEmpresa

No es teoría. Nuestro propio negocio funciona con una carpeta así, que usamos a diario con Claude. Los nombres son otros, pero las piezas son las mismas:

• Un AGENTS.md de 63 líneas en la raíz, con lo que hay que leer al empezar y al terminar cada sesión.
• Un CLAUDE.md de una sola línea que dice a Claude que lea el AGENTS.md (te explico por qué más abajo).
• Carpetas de marca, oferta y reglas (nuestro Contexto).
• Una carpeta Equipo IA con una nota por rol: copy, anuncios, guías (nuestras Skills).
• Una carpeta Revisiones con un diario por sesión (nuestra Memoria).
• Una carpeta Clientes con una subcarpeta por cliente (nuestros Proyectos).

Qué va en cada carpeta

Contexto: cómo funciona tu empresa

Es lo que un empleado nuevo te preguntaría la primera semana. Con estos cuatro archivos tienes de sobra para empezar:

• negocio.md: a qué te dedicas, a quién vendes, dónde, horarios y lo que te diferencia.
• tarifas.md: precios, descuentos, IVA y cómo calculas un presupuesto. Esta es la única fuente de verdad de tus precios: no los repitas en ningún otro archivo.
• tono.md: cómo hablas (tú o usted, emojis sí o no, palabras que nunca usas) y 5 mensajes tuyos reales que te gusten. Los ejemplos enseñan más que cualquier descripción.
• catalogo.md: tus servicios o productos, uno por línea, con lo que incluye cada uno.

Qué preparar: abre tu web, tu lista de precios y tus últimos 5 WhatsApp a clientes. Copiar de ahí es más rápido que escribir desde cero.

Si no sabes por dónde empezar, deja que la IA te entreviste. Pega esto en cualquier chat:

Voy a crear los archivos de contexto de mi agente de IA.
Entrevístame para rellenar 4 archivos: negocio.md, tarifas.md, tono.md y catalogo.md.

Reglas:
1. Hazme una sola pregunta cada vez y espera mi respuesta.
2. No inventes ningún dato. Si no te lo he dicho, no lo pongas.
3. Cuando tengas lo suficiente para un archivo, enséñamelo completo en Markdown y pasa al siguiente.

Empieza por negocio.md.

Resultado esperado: en 10 minutos de preguntas tienes los 4 archivos escritos con tus palabras.

Skills: recetas paso a paso de cada tarea

Una skill es una tarea que se repite, escrita como una receta: qué pedir, qué pasos seguir y cómo entregar el resultado. Se guarda en una carpeta con el nombre de la tarea y, dentro, un archivo SKILL.md.

Usamos ese formato a propósito: es el de Agent Skills, un estándar abierto que creó Anthropic y que ya usan muchas herramientas (agentskills.io). Así la misma receta se puede subir tal cual a Claude, a Gemini o a ChatGPT cuando te lo pidan.

Esta es una receta completa para presupuestos. Cambia lo que va entre corchetes:

Qué personalizar: los pasos 3 y 4 son los que más cambian de un negocio a otro. Copia el formato del último presupuesto que te aceptaron.

Error habitual: una sola skill que lo hace todo ("ayúdame con ventas"). Una skill es una tarea. Si dentro hay un "y además", son dos.

Tres recetas que casi todos los negocios repiten cada semana: hacer-presupuesto, responder-cliente (una consulta por WhatsApp, Instagram o correo) y publicar-post (un texto para redes con tu estilo).

Memoria: lo que aprende sobre la marcha

Es un solo archivo, memoria.md, donde la IA apunta lo que no estaba en el Contexto y ha aprendido trabajando contigo: correcciones, preferencias y decisiones. Una línea por cosa, con fecha:

# Memoria del agente
Una línea por aprendizaje, con fecha. Lo más nuevo, arriba.

- 2026-11-05: Los bonos de 10 sesiones llevan un 10 % de descuento. Siempre.
- 2026-11-04: Tutear siempre. Nunca "estimado cliente".
- 2026-11-03: Los sábados no hay citas aunque el calendario lo permita.

La diferencia con Contexto: Contexto lo escribes tú, Memoria la escribe la IA. Cuando una línea de Memoria se vuelve una regla fija (un precio, un horario), la pasas tú a Contexto y la borras de Memoria. Así no hay dos versiones del mismo dato.

Proyectos: un cliente por subcarpeta

Cada cliente, una carpeta con una ficha.md: datos de contacto, qué ha comprado, qué está pendiente y lo que hayas hablado con él. Cuando le pides algo sobre ese cliente, la IA trabaja dentro de su carpeta y no mezcla datos de unos con otros.

Qué no poner nunca: contraseñas, números de tarjeta o de cuenta, ni datos de salud de tus clientes si no hacen falta para la tarea. Lo que no está en la carpeta, no se puede filtrar.

El manual: AGENTS.md con las 2 reglas de oro

El AGENTS.md es el primer archivo que lee la IA. No es un invento nuestro: es un formato abierto que hoy custodia la Agentic AI Foundation, dentro de la Linux Foundation, y que según su web oficial usan más de 60.000 proyectos. Lo leen, entre otras, Codex de OpenAI, Jules y Gemini CLI de Google, Cursor y el agente de GitHub Copilot. Y desde septiembre de 2026, Claude Code también lo lee si no hay un CLAUDE.md.

Es Markdown normal, sin campos obligatorios. Pero de todo lo que puede llevar, hay dos instrucciones que marcan la diferencia entre un agente útil y uno inservible:

1. Si te falta un dato, pregunta en vez de inventar. Por defecto, una IA rellena los huecos con algo que suena bien. En un presupuesto, eso es un precio inventado. Con esta regla, te dice qué falta y espera.
2. Apunta todo lo que convenga recordar. Sin esta regla, cada conversación empieza de cero. Con ella, cada corrección acaba en Memoria y la siguiente vez ya la sabe.

Esta es la plantilla completa. Cópiala en un archivo llamado AGENTS.md (en mayúsculas, que es el nombre del estándar) en la raíz de tu carpeta y cambia lo que va entre corchetes:

Por qué no lleva tus precios: el manual dice dónde está cada cosa, no la repite. Si pones los precios en el AGENTS.md y en tarifas.md, el día que subas precios uno de los dos se quedará viejo y la IA no sabrá cuál vale.

Cuánto debe ocupar: poco. La documentación de Claude Code recomienda menos de 200 líneas por archivo de instrucciones, porque los archivos largos se siguen peor. Y Codex, por defecto, deja de leer cuando el total de estos archivos pasa de 32 KiB (documentación de Codex). Nuestro manual tiene 63 líneas.

Cada corrección se convierte en una habilidad

Aquí está la gracia del sistema: le corriges una vez y lo aprende para siempre. Son tres pasos.

Paso 1. Le das una instrucción. Trabajas con normalidad y, cuando algo no está como quieres, se lo dices claro:

Esto no está bien: los bonos de 10 sesiones llevan siempre un 10 % de descuento.
Corrígelo y apúntalo en Memoria.

Paso 2. Anota el criterio en Memoria. Con la regla de oro 2 en el manual, lo hace sola. Si trabajas en una IA que no puede escribir archivos (lo verás en la siguiente sección), te devuelve la línea y la pegas tú en memoria.md.

Paso 3. Lo guarda como Skill reutilizable. Cuando una corrección se repite o una tarea ya tiene varias reglas en Memoria, pídele que la convierta en receta:

Mira Memoria/memoria.md y las correcciones de hoy.
¿Qué tarea te he corregido más de una vez?
Conviértela en una receta nueva en Skills/[nombre-de-la-tarea]/SKILL.md, con el formato de las demás.
Enséñamela antes de guardarla.

Y al terminar cada sesión, para no perder nada:

Antes de terminar: ¿qué has aprendido hoy que convenga recordar?
Escríbelo en Memoria/memoria.md, una línea por cosa y con la fecha de hoy.
Si algo ya es una regla fija, dime en qué archivo de Contexto debería ir.

Error habitual: corregir el resultado a mano y seguir. Si lo arreglas tú sin decírselo, la IA no se entera y mañana lo vuelve a hacer igual.

Una carpeta, cualquier IA: cómo usarla en Claude, ChatGPT y Gemini

La carpeta es la misma en todas. Lo que cambia es cómo se la das, y sobre todo una cosa: si la IA puede escribir en tus archivos o no. Si puede, la Memoria se rellena sola. Si no, la IA te da la línea y la pegas tú.

Mi recomendación: si ya pagas Claude, la app de escritorio con la carpeta conectada es lo más cómodo, porque la Memoria se escribe sola. Si no quieres pagar nada, un proyecto de ChatGPT con los archivos subidos funciona desde el primer día.

En Claude: la carpeta conectada

1. Abre la app de escritorio de Claude y empieza una conversación.
2. Conecta tu carpeta Mi Agente desde la opción de añadir carpeta, debajo de la caja de texto.
3. Crea en la raíz un archivo CLAUDE.md con esta única línea:

Lee y sigue siempre @AGENTS.md

Por qué este truco: Claude busca primero un archivo llamado CLAUDE.md, y la documentación oficial explica que con @ se importa otro archivo. Así el manual vive en un solo sitio, el AGENTS.md, y lo leen igual Claude y el resto de herramientas. Es exactamente lo que hacemos en IAEmpresa.

Si prefieres no conectar la carpeta, crea un Proyecto en claude.ai, pega el AGENTS.md en sus instrucciones y sube el resto de archivos como conocimiento. Las recetas de Skills también se pueden subir como skills en los ajustes de Claude.

En ChatGPT: un proyecto (o Codex)

1. En ChatGPT, crea un Proyecto nuevo y llámalo "Mi Agente".
2. En los tres puntos de arriba a la derecha, abre las instrucciones del proyecto y pega tu AGENTS.md entero. Según la ayuda de OpenAI, esas instrucciones mandan sobre tus instrucciones generales dentro del proyecto.
3. Sube los archivos de Contexto, Skills y Memoria. En el plan gratuito el límite es de 5 archivos por proyecto: junta los 4 de Contexto en uno solo (contexto.md) y las recetas en otro (skills.md).
4. Al crear el proyecto, elige la memoria solo del proyecto si no quieres que mezcle lo que sabe de tus otros chats.

Como el proyecto no puede escribir en tus archivos, al final de cada sesión pídele las líneas de Memoria y actualiza memoria.md tú (y vuelve a subirlo).

Si trabajas con el ordenador, Codex lee el AGENTS.md de la carpeta por sí solo y sí puede escribir en ella. Ojo: está pensado para programar, así que la interfaz es más técnica.

En Gemini: skills o Gemini CLI

En la app de Gemini, lo que equivale a una receta son las skills. Desde la web o la app de Mac puedes subir un SKILL.md con sus archivos, y Google las ha abierto a cuentas personales de mayores de 18. Llegan de forma escalonada: si no ves Skills en los ajustes, todavía no ha llegado a tu cuenta.

Si usabas Gems, atento: según la ayuda oficial de Google, en cuentas personales pasan a ser de solo lectura el 17 de noviembre de 2026 y se eliminan el 17 de diciembre de 2026, convertidos en skills. Tener tu agente en una carpeta te protege justo de esto.

Si te manejas con la terminal, Gemini CLI lee por defecto un archivo llamado GEMINI.md. Para que lea tu AGENTS.md, añade esto a su archivo de ajustes, settings.json (documentación oficial):

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

La frase que funciona en cualquier IA

Si no tienes claro si tu herramienta ha leído el manual, empieza siempre así:

Lee AGENTS.md y todo lo que te indica.
Después dime en 3 líneas qué has entendido de mi negocio y qué datos te faltan.

Si en esas 3 líneas se equivoca, el problema está en tu Contexto, no en la IA. Corrige el archivo, no la conversación.

Lo que no cambia de una IA a otra es el agente. Lo que sí cambia es el modelo. Con la misma carpeta, Claude, ChatGPT y Gemini harán lo mismo, pero no escribirán exactamente igual. Por eso compensa tener la carpeta: puedes probar con otra IA en cinco minutos y quedarte con la que mejor te funcione.

¿Y si tu agente, además de trabajar para ti, te ayudara a que lleguen clientes todos los meses? Eso es Negocio Lleno: el sistema de 30 días para tener clientes todos los meses sin depender de ti. Entrar a Negocio Lleno →

Créalo en 15 minutos, paso a paso

1. Crea la carpeta (1 minuto). "Mi Agente" con las 4 subcarpetas: Contexto, Skills, Memoria y Proyectos.
2. Pega el manual (3 minutos). Crea AGENTS.md en la raíz con la plantilla de arriba y rellena los corchetes de "Para quién trabajas".
3. Rellena el Contexto (6 minutos). Usa el prompt de entrevista y guarda los 4 archivos. Si vas justo de tiempo, empieza solo por tarifas.md y tono.md.
4. Escribe tu primera receta (3 minutos). Copia la de presupuestos o adapta la de la tarea que más repites.
5. Crea memoria.md vacío y conéctalo (2 minutos). Con la cabecera de la plantilla. Después dale la carpeta a tu IA (sección anterior) y lanza la frase de prueba.

En 15 minutos tienes una primera versión que funciona. La buena llega con el uso: cada corrección la mejora.

Caso práctico: una clínica de fisioterapia monta su agente de presupuestos

Un ejemplo de cómo se encadena todo. Laura tiene una clínica de fisioterapia y pierde media hora al día contestando presupuestos de bonos por WhatsApp.

1. Lunes, 15 minutos. Crea la carpeta. En tarifas.md pone la sesión suelta y los bonos de 5 y de 10. En tono.md, cinco mensajes suyos reales. En Skills, la receta de presupuestos de esta guía.
2. Primer presupuesto. Le pide uno para un bono de 10 sesiones. El agente no sabe si hay descuento y, como tiene la regla de oro 1, pregunta en vez de inventarlo.
3. Primera corrección. Laura contesta: "10 % siempre en bonos de 10". El agente lo apunta en memoria.md con la fecha (regla de oro 2).
4. Martes. Otro presupuesto: el agente lee Memoria, aplica el 10 % sin preguntar y cierra con "¿Te lo reservo?", como dice la receta.
5. Viernes. Laura le pide revisar la semana. El agente ve que le ha corregido tres veces lo mismo (tutear, no dar citas en sábado, el descuento) y propone pasarlo a la receta y a tarifas.md. Laura lo aprueba.
6. Fin de semana. Desde el móvil, abre un proyecto de ChatGPT con los mismos archivos y saca un presupuesto igual de bien. Misma carpeta, otra IA.

Lo que se gana no es solo tiempo. Es que el criterio de Laura queda escrito, y el día que contrate a alguien, ese alguien tiene el mismo manual.

Errores frecuentes

• Escribir el manual como una novela. Más de 200 líneas y la IA empieza a saltarse cosas. Lo largo va en Contexto y en Skills.
• Repetir los precios en varios archivos. Un dato, un sitio: tarifas.md.
• No darle permiso para preguntar. Sin la regla de oro 1, rellena los huecos con datos que suenan bien.
• Corregir a mano sin decírselo. Si no se lo dices, no lo apunta, y mañana repite el error.
• Llamarlo de otra forma. El nombre del estándar es AGENTS.md, en mayúsculas. Algunas herramientas distinguen mayúsculas y minúsculas.
• Tener un CLAUDE.md con otras instrucciones. Si existe un CLAUDE.md, Claude Code lee ese y no el AGENTS.md. Por eso el nuestro solo tiene una línea que apunta al manual.
• No limpiar nunca la Memoria. Cuando algo ya es regla fija, pásalo a Contexto y bórralo de Memoria.
• Meter contraseñas o datos de pago. Ninguna IA los necesita para trabajar contigo.

Preguntas frecuentes

¿Qué es un agente de IA?

Una IA que trabaja para ti con contexto propio: sabe cómo funciona tu negocio, sigue tus recetas y recuerda tus correcciones. La diferencia con un chat normal es que no empieza de cero cada vez.

¿Necesito saber programar para crear un agente de IA?

No. Todo son archivos de texto escritos en español. Solo si eliges Gemini CLI o Codex tendrás que usar una interfaz más técnica.

¿Qué es el archivo AGENTS.md?

Un archivo de instrucciones en Markdown que las herramientas de IA leen antes de trabajar en una carpeta. Es un formato abierto que custodia la Linux Foundation y que, según su web oficial, usan más de 60.000 proyectos. Lo leen Codex, Gemini CLI, Cursor, GitHub Copilot y, desde septiembre de 2026, Claude Code.

¿Funciona igual en ChatGPT, Claude y Gemini?

El agente es el mismo, porque las instrucciones y los archivos son los mismos. La respuesta no será idéntica, porque cada IA usa un modelo distinto. Lo que sí cambia es si la IA puede escribir sola en tu Memoria: en la app de escritorio de Claude, en Codex y en Gemini CLI, sí; en los proyectos de ChatGPT y de Claude en la web, te da la línea y la pegas tú.

¿Es gratis?

La carpeta, sí. Para usarla gratis, lo más sencillo es un proyecto de ChatGPT (hasta 5 archivos en el plan gratuito) o las skills de Gemini. Conectar la carpeta a la app de escritorio de Claude necesita un plan de pago según Anthropic. Estos planes cambian a menudo: revisa la página oficial de cada uno.

¿En qué se diferencia de un GPT personalizado o de un Gem?

En que es tuyo y se puede llevar a cualquier IA. Un GPT o un Gem viven dentro de una plataforma. Ejemplo real: Google convierte los Gems en skills el 17 de noviembre de 2026 y elimina los antiguos el 17 de diciembre (ayuda de Google). Con la carpeta, ese tipo de cambios no te afecta.

¿Cuánto tiene que ocupar el AGENTS.md?

Cuanto menos, mejor. La documentación de Claude Code recomienda menos de 200 líneas por archivo de instrucciones, y Codex deja de leer por defecto cuando el total pasa de 32 KiB. Con 40-80 líneas tienes de sobra.

¿Qué diferencia hay entre Skills y Memoria?

Las Skills son recetas completas de una tarea, que escribes tú (o apruebas tú). La Memoria son apuntes sueltos que la IA va tomando. Cuando varios apuntes hablan de la misma tarea, se pasan a su receta.

¿Puede este agente contestar solo a mis clientes por WhatsApp o Instagram?

Este agente trabaja para ti: prepara la respuesta y tú decides si se envía. Para contestar solo, 24/7, necesitas un bot conectado a tus redes, por ejemplo con ManyChat. La buena noticia es que tu carpeta de Contexto es justo lo que ese bot necesita para no inventar. Antes de dar ese paso, lee 🦾Agentes de IA para empresas: explica los candados que necesita cualquier agente que habla con clientes.

¿Es seguro meter los datos de mis clientes?

Depende de la herramienta y del plan, así que revisa sus condiciones de privacidad. Como regla: en Proyectos, solo los datos que hagan falta para la tarea, y nunca contraseñas, tarjetas ni números de cuenta. Tienes una guía con la configuración paso a paso en 🔒Cómo blindar la privacidad de tu negocio: Gmail, Drive, WhatsApp y ChatGPT (guía 2026).

Conclusión

Un agente de IA no es un programa que tengas que comprar. Es lo que tu IA sabe antes de empezar, escrito en una carpeta: Contexto, Skills, Memoria, Proyectos y un manual con dos reglas. Pregunta en vez de inventar. Apunta lo que convenga recordar.

Crea la carpeta hoy, copia la plantilla y dale tu primera tarea real. A la tercera corrección ya notarás que trabaja como tú.

Sigue aprendiendo

• 7 agentes de IA gratis para tu negocio: las instrucciones completas de 7 agentes, para meter en tu carpeta como recetas.
• 🦾Agentes de IA para empresas: la diferencia entre el agente que trabaja para ti y el que habla con tus clientes.
• 🐳DeepSeek Harness: crea agentes de IA para tu empresa por céntimos (guía 2026): la misma idea de skills en carpetas, con un modelo muy barato.
• 📱Claude para gestionar tu Instagram: 13 skills gratis, cómo instalarlas y usarlas (guía 2026): skills ya hechas para llevar tus redes con Claude.

Fuentes revisadas

• AGENTS.md: web oficial del formato (Agentic AI Foundation, Linux Foundation)
• Agent Skills: especificación del formato SKILL.md
• Claude Code: cómo recuerda tu proyecto (CLAUDE.md, AGENTS.md, imports con @ y auto memoria)
• Anthropic: Cowork y trabajo con carpetas de tu ordenador
• OpenAI: cómo lee Codex los archivos AGENTS.md
• OpenAI: planes que incluyen Codex
• Ayuda de OpenAI: proyectos en ChatGPT (archivos por plan, instrucciones y memoria)
• OpenAI Academy: skills en ChatGPT
• Ayuda de Google: la transición de Gems a skills
• Gemini CLI: archivos de contexto y cómo usar AGENTS.md

Sobre los enlaces: algunos de los enlaces a herramientas de esta guía son de afiliado. Si te das de alta a través de ellos, IAEmpresa puede recibir una comisión sin coste adicional para ti. No cambia lo que recomendamos: aquí solo hay herramientas que usamos de verdad, y cuando hay una alternativa más barata o gratuita, la decimos.

Autor: Arti, consultor de IA aplicada a negocios en IAEmpresa.

Última revisión: 5 de noviembre de 2026.