Qué poner en el archivo de instrucciones de tu agente cuando trabajas con datos

Cada sesión con un agente empieza en blanco. El archivo de instrucciones es lo que el arnés le da al empezar: lo que tú le explicarías a alguien nuevo en el equipo antes de dejarlo tocar los datos.

Supuestos: usas un agente de terminal en una carpeta de proyecto. Claude Code lee CLAUDE.md; Codex, Antigravity y muchos otros leen AGENTS.md. Revisa en la documentación de tu agente cuál busca.

Una plantilla para empezar#

# Proyecto: ventas mensuales## Los datos- `datos/pedidos.csv`: una fila es un pedido. `cliente` identifica a la persona.- `datos/clientes.csv`: una fila es un cliente. Se une a pedidos por `cliente`.- Fuente: exportación del sistema de ventas, el día 1 de cada mes.## Definiciones- Cliente recurrente: cliente con 2 o más pedidos distintos en el mes.- Ventas: suma de `total` de pedidos no cancelados, en pesos, sin IVA.## Rarezas conocidas- Un `total` vacío es un pedido cancelado.- Antes de marzo de 2026, `cliente` venía en mayúsculas. Normaliza a minúsculas.## Cómo trabajar- Antes de calcular, escribe qué es una fila en cada tabla que uses.- Cada porcentaje va con su numerador y su denominador ("2 de 5").- Di cuántas filas excluiste y por qué.- No modifiques nada en `datos/`. Escribe resultados en `salidas/`.

Por qué cada sección#

• Los datos: el agente solo sabe de tus tablas lo que está en su contexto. La granularidad es lo primero que se equivoca.
• Definiciones: "cliente recurrente" tiene varias definiciones razonables. Si no escribes la tuya, el agente escoge una y no siempre te lo dice.
• Rarezas conocidas: lo que sabes de tus datos y no está escrito en ningún lado. Es lo que un agente nunca va a adivinar.
• Cómo trabajar: pide evidencia, no promesas. Que imprima los conteos te deja revisar sin rehacer el trabajo.

Cómo saber que lo leyó#

Abre una sesión nueva y, antes de pedir nada, pregúntale: "¿Qué es una fila en pedidos.csv y cómo defines cliente recurrente?". Si responde con tus palabras, el archivo se cargó. Si no, revisa el nombre del archivo y que estés en la carpeta del proyecto.

Lo que este archivo no hace#

• No obliga. El modelo lo lee como contexto: casi siempre lo sigue, pero puede no hacerlo. Lo que no debe pasar nunca, como escribir en datos/ o tocar producción, se configura en los permisos del arnés, no solo aquí.
• No reemplaza revisar. Reduce los errores que ya conoces; los nuevos los sigues encontrando tú.
• No es para secretos. No pongas contraseñas ni datos personales: el archivo suele vivir en el repositorio y entra completo al contexto del modelo.

Mantenlo vivo#

Cuando corrijas al agente dos veces por lo mismo, esa corrección va al archivo. Que sea corto ayuda: según la documentación de Claude Code, entre más específicas y concisas sean las instrucciones, con más consistencia las sigue.

Fuentes: How Claude remembers your project (Claude Code) y AGENTS.md.

Para hacerlo con tus propios datos#

En IA agéntica para datos escribes las reglas de tus propios datos y tu vara de calidad, y tu Maestro las revisa contigo.