MÓDULO 3.1
AGENTS, Skills y memoria
Crear instrucciones de proyecto y una capacidad reutilizable con criterio de revisión.
Qué es
AGENTS.md es el archivo de instrucciones que Codex descubre en el ámbito aplicable. Describe cómo trabajar: archivos iniciales, comandos de verificación, límites y formato de entrega. No es necesario explicar toda la historia de la organización; prefiera reglas cortas que alteren una decisión real.
Por qué aprender
Las instrucciones objetivas evitan repetir los mismos detalles en cada conversación. El archivo debe ayudar al agente a elegir una acción concreta, como verificar el informe antes de considerarlo finalizado.
Conceptos clave
Instrucción operativa; alcance; regla observable; concisión.
Qué es
Por defecto, ~/.codex/AGENTS.md guarda instrucciones globales. En el proyecto, AGENTS.md añade reglas específicas; los archivos en carpetas más cercanas pueden prevalecer en el ámbito correspondiente. AGENTS.override.md tiene prioridad sobre AGENTS.md en el mismo nivel. Esto no supera instrucciones del sistema, permisos o la solicitud explícita de la sesión.
Por qué aprender
La ruta importa. Una regla local puede no aplicarse a otra carpeta, y un archivo override olvidado puede explicar un comportamiento inesperado. Mantenga lo global pequeño y deje los detalles locales en el proyecto.
Conceptos clave
Descubrimiento; jerarquía; alcance de directorio; override.
Qué es
Una Skill reúne instrucciones de una actividad recurrente, con nombre y descripción al inicio de SKILL.md. Puede incluir recursos y programas de apoyo. Las Skills personales quedan en ~/.agents/skills; las del proyecto pueden quedar en .agents/skills dentro del repositorio. La carpeta ~/.codex sigue siendo la configuración de Codex.
Por qué aprender
Una regla indica qué respetar; una Skill enseña un procedimiento que puede activarse cuando sea necesario. Separar estos papeles evita cargar todo el manual en todas las tareas.
Conceptos clave
Nombre; descripción de activación; procedimiento; entrada y salida; validación.
Qué es
La memoria operativa del curso es un conjunto de archivos consultables, no un cambio en los pesos del modelo. Funciona cuando el agente lee la información relevante y cuando alguien mantiene esa información actualizada. Guarde hechos estables, decisiones y causas de fallas; no preserve cada frase de cada conversación.
Por qué aprender
Copiar todo el historial aumenta el volumen y puede reintroducir instrucciones antiguas. Una memoria pequeña, datada y revisada ayuda más que un archivo inmenso que nadie puede validar.
Conceptos clave
Memoria externa; consulta explícita; resumen; validez; fuente.
Qué es
Registre el síntoma, la causa observada, la corrección mínima y cómo verificar. Diferencie falla de solicitud, como objetivo ambiguo, de falla de infraestructura, como proceso terminado. El registro solo genera aprendizaje operativo cuando altera el procedimiento siguiente.
Por qué aprender
Rehacer todo el proyecto puede enmascarar un problema simple. Una pequeña protección, como verificar la existencia de un archivo antes de leerlo, suele ser más fácil de probar y mantener.
Conceptos clave
Síntoma no es causa; corrección mínima; prevención; evidencia.
Qué es
Prueba la Skill con una entrada normal, otra incompleta y una fuera de alcance. Observa si el resultado preserva datos, señala incertidumbre y se detiene cuando debería. La prueba debe medir comportamiento, no solo buscar el nombre de la Skill en la respuesta.
Por qué aprender
Un procedimiento que funciona una vez puede estar dependiendo de un contexto accidental. Variar entradas ayuda a descubrir lo que necesita quedar explícito en las instrucciones.
Conceptos clave
Caso normal; caso incompleto; límite de alcance; criterio de aceptación.