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 posible que hayas encontrado 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 Memories para darle a Codex una memoria persistente, permitiéndole entender realmente tus intenciones y lograr ganancias de 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 cada vez: no conoce tus hábitos de trabajo, el contexto del proyecto ni los límites para ejecutar operaciones.

Una vez que se configuran las reglas relevantes, estos contextos se vuelven permanentemente efectivos, y nunca más tendrás que explicar el mismo problema repetidamente.

2. Cómo configurarlo y usarlo

1️⃣ Capa global: Almacenada en el directorio ~/.codex/AGENTS.md de tu computadora local, aplica a todos tus proyectos. 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 mostrada arriba, y luego ajustar continuamente según tus necesidades:

1# AGENTS.md
2
3## Comportamiento básico
4
5- Por defecto, responde en español a menos que el usuario solicite explícitamente otro idioma.
6- Las respuestas deben ser concisas y directas, evitando rellenos y repeticiones innecesarias.
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 solicita.
9
10## Límites de seguridad
11
12- Por defecto, solo lectura; no modifiques ni elimines archivos 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 cambios explícitamente requeridos o obviamente necesarios para la tarea, manteniendo la solución simple.
19- No agregues funciones, refactorices código ni realices optimizaciones adicionales a menos que se solicite.
20- No agregues comentarios, anotaciones de tipo ni docstrings al código que no ha sido modificado.
21- Agrega comentarios solo cuando la lógica no sea autoexplicativa.
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 se usen solo una vez.
24- Elimina directamente el código confirmado como inútil; no dejes comentarios explicativos.

2️⃣ Capa de proyecto: Almacenada en el directorio del proyecto, 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:

• Antecedentes 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 u operar el proyecto.
• Estándares y restricciones: estándares que deben seguirse 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 de 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️⃣ Capas de reglas, responsabilidades claras

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

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

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 específicas de ese proyecto, como comandos de compilación, convenciones de código y descripciones de módulos.

Ambas cumplen sus respectivas funciones sin interferir entre sí, y no surgirán conflictos al fusionarse.

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

AGENTS.md no necesita escribirse de una sola vez. Empieza con las reglas más centrales. Cuando Codex repita el mismo error, haz que revise y actualice las reglas directamente, por ejemplo:

"Acabas de cometer el mismo error que la última vez. Por favor, resume la razón y agrega la experiencia relevante a AGENTS.md."

3️⃣ Mantenlo ligero, divide el contenido complejo por separado

A medida que el uso se profundiza, el contenido de AGENTS.md puede aumentar. En este punto, no es necesario amontonar 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 solo una referencia de una línea en AGENTS.md:

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

2. Función de Memories

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

Después de activar el botón, Codex resumirá activamente la información efectiva y las 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 la memoria añadido por tu Codex. A continuación, el mío:

Finalmente

Construir un sistema de memoria es un proceso que evoluciona con el tiempo. Créeme, mientras persistas en mejorar y actualizar las reglas de acción y acumules recuerdos continuamente, Codex se convertirá rápidamente en la herramienta de productividad hardcore que mejor te entiende y es la más conveniente de usar.