Índice del artículo
Qué es
Es un archivo de texto corto que vive en la carpeta principal de tu proyecto y que el agente lee solo antes de empezar: con qué está hecho, cómo se comprueba que algo quedó bien y qué no se toca. Es el contexto que dejas de repetirle cada mañana.
Explicado fácil
Piensa en el manual de bienvenida de un empleado nuevo: una ficha en la primera página —con qué trabajas, cómo se arranca, qué no se toca— y el resto lo aprende trabajando. El que entra la lee y deja de interrumpirte. El archivo de instrucciones es esa ficha, para el agente.
Ejemplo práctico
Una clínica trabaja con un agente sobre su sistema de recordatorios. Cada mañana le explicaba dónde están los archivos y qué carpeta no tocar. Lo escribió una vez en el archivo de instrucciones y, desde entonces, el agente lo lee solo al arrancar. Lo que antes era una explicación diaria ahora es una línea que el agente carga solo.
Por qué te importa
Porque pagas dos veces lo que no está escrito: tu tiempo y las explicaciones. El archivo orienta al agente, pero no garantiza que cumpla cada instrucción: comprueba el resultado y configura permisos para limitar lo que puede hacer. Lo que no está escrito, el agente lo infiere —y a veces infiere mal.
El error típico
Llenarlo de deseos en vez de reglas. «Escribe código limpio» no se puede comprobar; «toda función nueva lleva su prueba» sí. Como punto de partida, una regla clara y comprobable orienta mejor; revisa que no se contradiga con otras. La versión completa, con plantilla, está en el artículo CLAUDE.md y AGENTS.md.
No lo confundas con
El encargo. El encargo es lo que pides en una sesión; el archivo de instrucciones es lo que vale para todas las sesiones del proyecto.
CLAUDE.md y AGENTS.md. Son archivos de instrucciones que pueden compartir reglas; qué nombres se cargan y cómo se aplican depende de la herramienta. Está en CLAUDE.md y AGENTS.md.