Cómo lograr que Codex te entienda mejor: Domina estas técnicas de memoria para aumentar tu eficiencia en un 90%

Después de usar la aplicación Codex por un tiempo, es probable que hayas tenido frustraciones similares: tener que repetir preferencias básicas cada vez que inicias una nueva conversación, o que ejecute accidentalmente comandos del sistema más allá de lo esperado.

La esencia de estos puntos débiles de alta frecuencia es que tu Codex carece de una memoria estable a largo plazo. Para resolver por completo estas comunicaciones repetitivas e ineficaces, debes construir un sistema de memoria completo para él.

Este artículo te explicará cómo configurar AGENTS.md y la función de Memorias para dotar a Codex de una memoria persistente, haciendo que realmente entienda tus intenciones y logres una mayor eficiencia.

1. AGENTS.md

1. ¿Qué es?

AGENTS.md es un conjunto de instrucciones de reglas preescritas que Codex lee automáticamente cada vez que se inicia.

Sin AGENTS.md, Codex comienza desde cero en cada ocasión: no conoce tus hábitos de trabajo, el contexto del proyecto ni los límites para ejecutar operaciones.

Una vez configuradas las reglas correspondientes, estos contextos se vuelven efectivos de forma permanente y nunca más tendrás que explicar el mismo problema repetidamente.

2. Cómo configurarlo y usarlo

1️⃣ Capa global: Se almacena en el directorio ~/.codex/AGENTS.md de tu computadora local y se aplica a todos tus proyectos. Es adecuada para escribir preferencias personales globales y reglas generales.

En la aplicación Codex, esto corresponde a la sección "Instrucciones personalizadas" en la página de configuración de Personalización.

Aquí tienes una plantilla básica recomendada que puedes copiar y pegar directamente en la ubicación indicada arriba, y luego ajustar continuamente según tus necesidades:

1# AGENTS.md
2
3## Comportamiento básico
4
5- Por defecto, responder en español a menos que el usuario solicite explícitamente otro idioma.
6- Las respuestas deben ser concisas y directas, evitando relleno innecesario y repeticiones.
7- Si la descripción de la tarea no es clara, pide confirmación antes de comenzar la ejecución.
8- No especules activamente sobre necesidades fuera de la intención del usuario; solo haz lo que se te pida.
9
10## Límites de seguridad
11
12- Por defecto, solo lectura; no modifiques ni elimines archivos activamente a menos que el usuario lo indique explícitamente.
13- Antes de realizar operaciones irreversibles (como eliminar, sobrescribir o llamar a APIs externas para escribir), primero debes obtener confirmación.
14- No imprimas ninguna clave, token o credencial sensible en la salida.
15
16## Estándares de ingeniería
17
18- Evita el sobreingeniería; solo realiza los cambios explícitamente requeridos o claramente necesarios para la tarea, manteniendo la solución simple.
19- No agregues funciones, refactorices código ni realices optimizaciones adicionales a menos que se te solicite.
20- No agregues comentarios, anotaciones de tipo ni cadenas de documentación al código que no haya sido modificado.
21- Agrega comentarios solo cuando la lógica no sea evidente por sí misma.
22- No agregues manejo de errores ni lógica de respaldo para escenarios que sean poco probables.
23- No crees funciones de utilidad ni capas de abstracción que solo se usen una vez.
24- Elimina directamente el código que se confirme que es inútil; no dejes comentarios explicativos.

2️⃣ Capa de proyecto: Se almacena en el directorio del proyecto y se utiliza principalmente para personalizar reglas según el tema y las características del proyecto.

Un buen AGENTS.md a nivel de proyecto debería cubrir típicamente los siguientes aspectos:

• Contexto y estructura del proyecto: qué es el proyecto y dónde se encuentran los directorios importantes.
• Métodos de ejecución: cómo iniciar, ejecutar o operar el proyecto.
• Estándares y restricciones: estándares que se deben seguir y cosas que explícitamente no se pueden hacer.
• Criterios de finalización: cómo determinar si una tarea está terminada.

3. Mejores prácticas para AGENTS.md

Configurar un AGENTS.md básico es solo el primer paso. Los siguientes principios prácticos determinan el límite superior de tu sistema de memoria:

1️⃣ Reglas en capas, responsabilidades claras

En Codex, AGENTS.md sigue el principio de proximidad: Subdirectorio > Directorio raíz > Global. Es decir, las reglas del directorio donde se encuentra el trabajo actual tienen la máxima prioridad.

Esto significa que las reglas a nivel de proyecto sobrescribirán directamente la configuración global del mismo tipo. Si todas las reglas se mezclan, las reglas locales de alta prioridad pueden contaminar o destruir accidentalmente la lógica global subyacente.

Por lo tanto, un sistema de memoria de reglas razonable debe seguir el principio de "separación de preocupaciones": la capa global solo contiene reglas generales, como preferencias de idioma, límites de seguridad y hábitos de comportamiento básicos; la capa de proyecto contiene especificaciones propias de ese proyecto, como comandos de compilación, convenciones de código y descripciones de módulos.

Ambas cumplen sus funciones sin interferir entre sí, y no surgen conflictos al fusionarse.

2️⃣ Empieza desde lo básico, itera según sea necesario

AGENTS.md no necesita escribirse todo de una vez. Comienza con las reglas más esenciales. Cuando Codex cometa el mismo error, pídele directamente que revise y actualice las reglas, por ejemplo:

"Acabas de cometer el mismo error que la última vez. Por favor, resume el motivo y añade la experiencia relevante a AGENTS.md."

De esta manera, las reglas siempre surgen de fricciones reales de uso, y AGENTS.md evolucionará continuamente con el uso.

3️⃣ Mantenlo ligero, separa el contenido complejo

A medida que se profundiza en el uso, el contenido de AGENTS.md puede aumentar. En ese caso, no es necesario acumular todo en un solo archivo. En su lugar, escribe el contenido de temas específicos en archivos independientes y luego haz referencia a ellos en el archivo principal.

Por ejemplo, escribe la descripción de la arquitectura del proyecto por separado como ARCHITECTURE.md, e incluye una referencia de una línea en AGENTS.md:

"Para la arquitectura principal y las especificaciones de directorio de este proyecto, consulta el archivo ARCHITECTURE.md en el directorio actual."

2. Función de Memorias

Además de configurar activamente las reglas correspondientes, Codex también admite una función de memoria activa, que debe activarse en Configuración - Personalización - Memoria, como se muestra a continuación:

Después de activar el botón, Codex resumirá automáticamente información útil y preferencias clave de la conversación en la memoria. Si quieres ver qué recuerdos ha añadido tu Codex, puedes abrir el archivo Memory.md en ~/.codex/memory para ver el contenido de memoria añadido por tu Codex. A continuación, el mío:

Para finalizar

Construir un sistema de memoria es un proceso que evoluciona con el tiempo. Créeme, si perseveras en mejorar y actualizar las reglas de acción y acumulas recuerdos continuamente, Codex se convertirá rápidamente en la herramienta de productividad imprescindible que mejor te entiende y es más cómoda de usar.