Si usas ChatGPT para preparar propuestas, investigar o trabajar en una página web, probablemente repites indicaciones: quién es tu público, qué fuentes consultar o cómo entregar el resultado.
AGENTS.md es un archivo de texto donde puedes reunir instrucciones estables para orientar el trabajo de un agente. Para aprovecharlo necesitas escribir reglas útiles, colocarlas en el contexto adecuado y comprobar que se aplican.
En esta guía aprenderás a crearlo en Windows y macOS, adaptar su contenido a Work y Codex y probarlo con una tarea concreta.
Documentación oficial consultada: 15 de octubre de 2026.
Qué es AGENTS.md y para qué sirve
Es un documento escrito en Markdown: texto sencillo que utiliza símbolos como # para los títulos y guiones para las listas. Puedes abrirlo y modificarlo con un editor de texto.
Su función es conservar acuerdos de trabajo. Por ejemplo:
Escribe en español latino neutro. Usa el catálogo aprobado para describir servicios. Si falta un precio, pregúntalo antes de preparar una cotización.
La documentación oficial explica cómo Codex descubre y combina estos archivos antes de trabajar. learn.chatgpt.com
Conviene separar tres elementos:
| Instrucciones estables | “Distingue datos confirmados de propuestas”. |
| Información de consulta | Catálogo, guía de marca o documentación del proyecto. |
| Encargo puntual | “Prepara una propuesta para este cliente”. |
El archivo ayuda a definir comportamientos. Las herramientas, conexiones, permisos y datos disponibles determinan qué puede ejecutar el agente. Escribir “consulta mi CRM” no conecta un CRM.
Tampoco equivale a crear un GPT personalizado, instalar una automatización o desplegar un agente independiente. Es una pieza de su configuración.
ChatGPT Desktop, Work y Codex: dónde encaja el archivo
Primero identifica dónde trabajarás. Desktop es la aplicación de escritorio; Work y Codex son opciones que puedes utilizar desde esa aplicación. La guía oficial explica cómo elegir ChatGPT o Codex y cómo cambiar entre Chat y Work. learn.chatgpt.com
| Contexto | Cómo abordar las instrucciones |
|---|---|
| ChatGPT Work en un proyecto de ChatGPT | Coloca las reglas esenciales en las instrucciones del proyecto y agrega los documentos de apoyo como fuentes. |
| Aplicación de escritorio | Revisa Personalización y el proyecto o carpeta seleccionados antes de decidir dónde guardar las reglas. |
| Codex en una carpeta o repositorio | Utiliza AGENTS.md en las ubicaciones documentadas para su descubrimiento automático. |
En escritorio, Configuración > Personalización permite editar instrucciones personales en AGENTS.md para la máquina seleccionada. ChatGPT Learn
Por su parte, los proyectos de ChatGPT reúnen instrucciones y fuentes compartidas. Adjuntar un documento no debe confundirse con configurar instrucciones globales. learn.chatgpt.com
La decisión práctica es sencilla: usa reglas personales para preferencias generales y reglas del proyecto para lo que pertenece a un negocio o trabajo específico.
Qué debes definir antes de escribirlo
Empieza con un proceso que ya conozcas: preparar propuestas, elaborar informes o mantener una página web. Define estos seis puntos:
- Propósito: qué trabajo debe ayudar a resolver.
- Contexto: para quién trabaja y qué necesita saber.
- Fuentes: dónde están los datos autorizados.
- Forma de trabajo: cuándo preguntar y cómo manejar información faltante.
- Acciones y límites: qué puede preparar y qué acciones externas debe realizar únicamente cuando estén autorizadas.
- Entregables y revisión: qué resultado esperas y cómo comprobarlo.
Transforma deseos generales en conductas observables:
| Instrucción vaga | Alternativa concreta |
|---|---|
| “Sé profesional”. | “Explica la recomendación con lenguaje claro y evita promesas sin respaldo”. |
| “Investiga bien”. | “Usa fuentes identificables e indica cuándo un dato no pudo verificarse”. |
| “Haz buenas propuestas”. | “Incluye necesidad, alcance, inversión confirmada y siguiente paso”. |
| “Ten cuidado con la web”. | “Conserva los cambios existentes y reporta qué comprobaciones realizaste”. |
Mantén precios, contactos y registros operativos en sus documentos correspondientes. Así evitas que una actualización del catálogo deje instrucciones contradictorias.
Cómo crear AGENTS.md paso a paso
El contenido es el mismo en Windows y macOS. Cambia la forma de guardarlo y, cuando corresponda, la ruta utilizada.
En Windows
- Abre el Bloc de notas u otro editor de texto.
- Escribe las instrucciones con títulos y listas.
- Selecciona Guardar como.
- Introduce el nombre exacto
AGENTS.md. Si el cuadro ofrece un tipo de archivo, elige Todos los archivos. - Guarda con codificación UTF-8 cuando puedas seleccionarla.
- Comprueba el nombre completo en el Explorador de archivos.
El archivo debe llamarse AGENTS.md, sin una extensión .txt adicional. Activa la visualización de extensiones si no puedes comprobarlo.
En macOS
- Abre un editor de texto. Si utilizas TextEdit, selecciona el modo de texto sin formato antes de guardar.
- Escribe o pega las instrucciones.
- Guarda el documento como
AGENTS.md. - Si el editor propone añadir
.txt, conserva la extensión.md. - Revisa el nombre y la extensión en Finder.
Evita guardar un documento de Word o RTF y cambiarle el nombre: la extensión no transforma el contenido en texto plano.
Una estructura inicial
Puedes comenzar con este esquema:
# AGENTS.md — Nombre del proyecto
## Propósito
Describe el trabajo que debe ayudar a resolver.
## Contexto
Indica el público y las decisiones estables del proyecto.
## Fuentes
Identifica los documentos autorizados y cuándo consultarlos.
## Forma de trabajo
Explica cuándo preguntar y cómo tratar datos faltantes.
## Acciones y límites
Define el alcance de las acciones permitidas.
## Entregables y revisión
Indica qué entregar y qué comprobar antes de terminar.Estas secciones son una propuesta práctica. Elimina lo que no aporte y sustituye las explicaciones por instrucciones propias antes de utilizarla.
Cómo utilizar sus instrucciones en ChatGPT Work
Para un proceso profesional que continuará en varios chats, conviene organizar un proyecto.
En un proyecto de ChatGPT
- Crea o abre el proyecto correspondiente.
- Coloca las reglas esenciales en sus instrucciones.
- Agrega el catálogo, la guía de marca u otras fuentes necesarias.
- Si incluyes AGENTS.md como documento de apoyo, indica expresamente cuándo consultarlo.
- Inicia un chat dentro del proyecto y realiza una tarea de prueba.
Por ejemplo, puedes incorporar esta indicación:
Para preparar propuestas, consulta el archivo AGENTS.md del proyecto y el catálogo vigente. Si falta alguno, explica qué parte del encargo queda limitada y continúa con lo que puedas sustentar.
Este uso permite conservar una estructura reutilizable sin asumir que el nombre del archivo activa por sí solo una configuración.
En escritorio y con archivos locales
Comprueba qué máquina, proyecto y carpeta están seleccionados. Un documento guardado en tu computadora debe estar disponible para la tarea antes de poder utilizarse.
La documentación de proyectos distingue la sincronización de las conversaciones del acceso a archivos: sincronizar un chat no sube automáticamente toda su carpeta local. Revisa las fuentes accesibles al continuar desde otro equipo. learn.chatgpt.com
Si una regla corresponde a todos tus trabajos, considera las instrucciones personales. Si pertenece a un cliente, mantenla en su proyecto para evitar aplicarla a otros negocios.
Cómo utilizar AGENTS.md en Codex
Codex admite instrucciones globales y del proyecto. Según su documentación, utiliza normalmente ~/.codex para las globales y busca archivos desde la raíz del proyecto hasta el directorio de trabajo. Las instrucciones más cercanas prevalecen cuando existe un conflicto. learn.chatgpt.com
Instrucciones globales
Úsalas para preferencias que se repiten entre proyectos: idioma, forma de reportar resultados o tratamiento de información privada.
La ubicación habitual es:
| Entorno | Ruta habitual, si no se personalizó la configuración |
|---|---|
| macOS | ~/.codex/AGENTS.md |
| Windows nativo | %USERPROFILE%\.codex\AGENTS.md |
| Windows con WSL | ~/.codex/AGENTS.md dentro del entorno Linux |
En PowerShell, la carpeta del usuario también se expresa como $HOME. Verifica el entorno activo: Windows y WSL pueden tener carpetas de configuración distintas.
La documentación de Windows distingue la ejecución nativa de la ejecución mediante WSL2. learn.chatgpt.com
Instrucciones del proyecto
Guarda otro AGENTS.md en la raíz de la carpeta o repositorio del trabajo. Aquí corresponden las fuentes del proyecto, sus restricciones y las comprobaciones pertinentes.
En escritorio, revisa la carpeta principal: la documentación indica que Codex la utiliza para el descubrimiento automático. Agregar una carpeta secundaria no garantiza que sus instrucciones se descubran del mismo modo. learn.chatgpt.com
Para comenzar, utiliza un archivo global breve y otro por proyecto solo si lo necesitas. Deja las configuraciones avanzadas para un problema concreto.
Dos ejemplos explicados para profesionales
Los siguientes casos son didácticos. Adapta los documentos y condiciones a tu trabajo.
Ejemplo para Work: preparar propuestas comerciales
# AGENTS.md — Propuestas comerciales
## Propósito
Ayuda a preparar propuestas para clientes de una consultora.
## Contexto y fuentes
Utiliza el catálogo vigente y el brief del cliente.
No inventes precios, plazos ni resultados.
## Forma de trabajo
Lee los archivos disponibles antes de preguntar.
Pregunta solo por datos que cambien el alcance o la inversión.
Distingue requisitos del cliente de recomendaciones propias.
## Acciones y límites
Prepara borradores dentro del encargo.
Envía propuestas únicamente si el usuario solicita ese envío
e identifica al destinatario.
## Entregables y revisión
Entrega necesidad, solución, alcance, inversión y próximo paso.
Comprueba que las condiciones corresponden al catálogo.
Deja los datos pendientes fuera del texto para el cliente.Su valor está en definir una fuente comercial autorizada y un criterio de revisión. “Haz una propuesta convincente” deja esas decisiones abiertas.
Ejemplo para Codex: trabajar en una página web
# AGENTS.md — Sitio profesional
## Propósito
Ayuda a mantener el sitio y a implementar cambios solicitados.
## Fuentes y forma de trabajo
Revisa la estructura y la documentación del proyecto.
Usa textos y recursos aprobados cuando estén disponibles.
No inventes testimonios ni condiciones comerciales.
## Cambios
Conserva cambios existentes ajenos al encargo.
Sigue los componentes y estilos del proyecto.
## Verificación
Identifica los comandos reales antes de ejecutarlos.
Aplica comprobaciones pertinentes al cambio.
Si verificas la interfaz, revisa móvil y escritorio.
Informa qué comprobaste y qué quedó pendiente.
## Acciones externas
Publica o despliega únicamente dentro de una autorización
que cubra esa acción y su alcance.
## Entrega
Resume el resultado, la validación y las limitaciones.Este ejemplo evita imponer comandos que podrían no existir. Cuando conozcas los del proyecto, incorpóralos con su directorio de ejecución.
Cómo comprobar que las instrucciones funcionan
Prueba tanto la lectura como el comportamiento.
Primero, pregunta:
¿Qué instrucciones del proyecto puedes consultar? Indica sus fuentes y cualquier limitación de acceso.
En Codex, esto puede ayudarte a detectar una ubicación incorrecta. En Work, permite comprobar si los documentos necesarios están disponibles. La respuesta es una señal inicial; contrástala con una tarea.
Después utiliza un encargo representativo:
- Work: solicita una propuesta con un precio deliberadamente ausente del material de prueba. Comprueba si lo pregunta o lo identifica como pendiente.
- Codex: solicita un cambio pequeño y comprueba si conserva lo existente y reporta las verificaciones realizadas.
Trabaja con datos ficticios durante estas pruebas. Si modificas las instrucciones de Codex, inicia una nueva sesión para verificar su carga. learn.chatgpt.com
El criterio es el resultado observable: si aplica las fuentes, respeta los límites y entrega lo esperado. Un resumen correcto de las reglas no demuestra que siempre las cumplirá.
Errores frecuentes y mantenimiento
Los problemas más comunes aparecen al acumular instrucciones sin revisarlas:
- Reglas contradictorias: “no preguntes nunca” y “confirma cualquier detalle”.
- Datos que envejecen: precios o fechas copiados en varios lugares.
- Fuentes inexistentes: documentos nombrados que no se incorporaron.
- Reglas demasiado generales: “hazlo perfecto”.
- Documentación excesiva: manuales completos dentro del archivo principal.
También evita guardar contraseñas, claves de acceso o registros personales innecesarios.
Mantén el archivo breve y referencia materiales específicos cuando hagan falta. Revisa las instrucciones cuando cambien una fuente, un proceso o una herramienta, y vuelve a probar una tarea representativa.
Si quieres profundizar en la organización de procesos reutilizables, puedes explorar la guía para crear skills en Claude. Sus pasos corresponden a otra plataforma y deben seguirse en ese contexto.
Descarga las plantillas para Work y Codex
Puedes comenzar con las dos estructuras editables que acompañan esta guía:
- Plantilla para Work: propósito, fuentes, forma de trabajo y entregables.
- Plantilla para Codex: contexto del proyecto, cambios, verificación y entrega.
Descarga las plantillas de AGENTS.md para Work y Codex y adáptalas a tu trabajo.
Elige un proceso, completa las secciones que necesites y prueba el resultado antes de incorporar más reglas.
