Skip to content

Archivo de instrucciones del agente

Un archivo de texto en tu proyecto que el arnés del agente carga al empezar cada sesión, para que el agente sepa desde el inicio lo que siempre tiene que saber: reglas, datos y cómo revisar su trabajo.

Cada arnés busca su propio nombre: Claude Code lee CLAUDE.md, y Codex, Antigravity y muchos otros leen AGENTS.md. Claude Code también puede leer el AGENTS.md de un proyecto. Es Markdown normal, en la carpeta del proyecto.

Ejemplo, para un proyecto de datos:

markdown
# Ventas

- Una fila de `pedidos.csv` es un pedido, no un cliente.
- "Cliente recurrente" = cliente con 2 o más pedidos en el periodo.
- Los vacíos en `total` son pedidos cancelados: exclúyelos y di cuántos fueron.
- Antes de reportar un porcentaje, imprime el numerador y el denominador.

Lo que no hace: no obliga a nada. El modelo lo lee como contexto y casi siempre lo sigue, pero puede no hacerlo. Lo que no debe pasar nunca va en los permisos del arnés.

Señal de que le falta algo: si corriges al agente dos veces por lo mismo, esa corrección va al archivo.

Para saber más

  • Contexto (ventana de contexto)

    Todo lo que un modelo de lenguaje tiene enfrente en un momento dado: tu instrucción, los archivos que leyó y los resultados de sus herramientas. Lo que no está en el contexto, el modelo no lo puede usar.

  • Arnés (de un agente)

    El programa que envuelve al modelo de lenguaje y lo convierte en agente: le da herramientas, pide tus permisos, guarda la sesión y decide qué entra en su contexto.

  • Agente de IA

    Un programa que combina un modelo de lenguaje con herramientas, como comandos de terminal y archivos, para cumplir una tarea en varios pasos: lee su contexto, actúa, observa el resultado y repite.

  • Granularidad (de una tabla)

    Lo que representa una fila de una tabla: una persona, una transacción, un planeta, una persona por lenguaje. Contar filas solo cuenta lo que quieres si conoces la granularidad.

Todo el glosario