Índice del artículo
- En 30 segundos
- Una carpintería de Valladolid prepara presupuestos
- No lo confundas con el encargo o los permisos
- Qué merece estar dentro
- Cómo pasar de una intención a una regla útil
- El nombre y la carga dependen de la herramienta
- Mantén las instrucciones al día
- Dudas sobre el archivo de instrucciones, respuestas cortas
En 30 segundos
El archivo de instrucciones del proyecto es un documento de texto con el contexto y las reglas que un agente de IA puede cargar al trabajar en ese proyecto.
Tú aportas el conocimiento del negocio: para qué sirve el trabajo y qué necesitas recibir. Tu proveedor técnico concreta las carpetas y las comprobaciones. No necesitas rellenar nombres de tecnologías que desconoces.
Una carpintería de Valladolid prepara presupuestos
Ejemplo ilustrativo, con datos ficticios: no corresponde a un cliente ni a una prueba realizada por Ciade. El responsable de una carpintería de Valladolid quiere preparar borradores a partir de un catálogo de muestra y una solicitud inventada. Trabaja con un agente: un programa de IA que usa herramientas para realizar el encargo. Cada presupuesto cambia, pero el negocio mantiene su forma de trabajar. Quiere que las propuestas tengan el mismo estilo y que las dudas queden visibles. Ese contexto compartido puede quedar escrito para los siguientes encargos del proyecto.
Piensa en una hoja de bienvenida para quien empieza a trabajar contigo. Explica qué hace la empresa, dónde están los materiales y cómo se entrega el trabajo. El archivo cumple esa función para el agente. Aporta información para la tarea sin entrenar un modelo nuevo ni ejecutar un programa por sí mismo. El objetivo es dejar de reconstruir el contexto en cada conversación, no escribir un manual sobre todo lo que sabe la empresa.
No lo confundas con el encargo o los permisos
La hoja de bienvenida
El archivo guarda cómo se trabaja en ese proyecto. En la carpintería, conserva las instrucciones que deben servir para preparar distintos presupuestos, aunque cambie la solicitud del día.
La tarea de hoy
El encargo, o prompt, pide un resultado concreto. Por ejemplo, preparar el borrador de un armario a partir de la solicitud ficticia. No hace falta convertir cada pedido en una regla permanente.
Los accesos
Los permisos determinan qué puede hacer la herramienta. Tener acceso al catálogo de muestra y poder enviar una oferta son cosas distintas. Eso se configura fuera del documento de instrucciones.
Qué merece estar dentro
Propósito
Explica para qué existe el proyecto. En este ejemplo, se preparan borradores de presupuesto para revisión del responsable. Esa frase ayuda a entender qué clase de entrega se espera.
Materiales
Identifica las fuentes autorizadas. La regla puede indicar que se use solo el catálogo de muestra y las condiciones aprobadas de la carpeta. Un precio que no aparezca debe quedar pendiente.
Entrega
Define cómo revisar el resultado. Pide que se indiquen los archivos utilizados, los cambios y las comprobaciones realizadas. Adapta la comprobación al trabajo: un texto y un programa necesitan revisiones diferentes.
Cómo pasar de una intención a una regla útil
Describe lo que podrás mirar
Sustituye el deseo por una condición observable. «Haz un buen presupuesto» deja abierta la forma de evaluarlo. «Si falta una medida, señálala como pendiente» permite mirar el borrador y decidir si se ha seguido la instrucción. Haz lo mismo con el lenguaje: pide español de España y que se conserven los nombres comerciales. Elige reglas vinculadas a errores que te importarían en ese encargo. No copies obligaciones técnicas de otro negocio si no sabes qué resultado deberían producir.
Comprueba qué se ha cargado
Verifica qué se ha cargado antes de darlo por supuesto. Pide al responsable técnico que compruebe qué archivos de instrucciones están activos en la herramienta utilizada. En la prueba de la carpintería, abre una sesión con la solicitud ficticia y revisa qué contexto recibe. Si has añadido un archivo o cambiado su ubicación, comprueba cómo recoge ese cambio el agente. Una respuesta que diga «lo he leído» y un borrador correcto son comprobaciones distintas: revisa también la entrega.
Revisa el trabajo, no la promesa
Contrasta el borrador con el material de muestra. Comprueba medidas, condiciones y datos pendientes antes de utilizar la propuesta. Si aparece un precio que no está en el catálogo, el resultado no sirve aunque el agente afirme haber seguido las reglas. Distingue si faltaba contexto, había instrucciones incompatibles o se ha producido un error al trabajar. Así puedes corregir el problema concreto. Para definir qué debe estar listo al terminar, consulta el criterio de hecho.
El nombre y la carga dependen de la herramienta
El agente necesita reconocer el archivo. Los nombres CLAUDE.md y AGENTS.md identifican archivos de instrucciones reconocidos por determinadas herramientas. Son texto, no un botón que active funciones. El nombre, la ubicación y la configuración deciden si se incorporan al trabajo. Antes de cambiar de agente, confirma el mecanismo que utiliza. Que dos herramientas acepten el mismo nombre no significa que lean las mismas carpetas ni que resuelvan igual los conflictos entre instrucciones.
La compatibilidad depende de la configuración. Claude Code admite AGENTS.md en versiones compatibles, pero por defecto los archivos CLAUDE.md de la carpeta o sus superiores lo desplazan; la configuración puede permitir ambos. Codex busca una cadena de instrucciones desde la raíz del proyecto hasta la carpeta de trabajo, con preferencias por nivel. La guía de archivos de instrucciones desarrolla esos detalles y la plantilla. Esta definición te sirve para decidir qué quieres dejar escrito antes de ocuparte de la configuración.
Mantén las instrucciones al día
Antes de añadir otra regla, revisa las existentes. Cuando tengas que corregir algo, busca primero si la instrucción falta, está mal formulada o contradice otra. Retira lo que haya caducado y conserva una fuente compartida cuando las herramientas lo permitan. Si mantienes varias copias, comprueba que no terminen diciendo cosas distintas. El archivo de instrucciones tampoco equivale a la memoria automática que una herramienta pueda guardar: decide qué reglas humanas deben permanecer y qué material solo sirve de consulta.
El siguiente paso depende de qué necesitas resolver. Si el problema está en cómo pides la tarea de hoy, empieza por qué es un encargo. Si quieres practicar este trabajo con apoyo formativo, consulta el curso Claude Code a fondo. Para preparar las instrucciones, comienza con las decisiones de tu negocio y un ejemplo de entrega que puedas revisar. El archivo debería ayudarte a trabajar; no convertirse en una colección de correcciones que ya nadie entiende.
Dudas sobre el archivo de instrucciones, respuestas cortas
¿Necesito saber programar para escribirlo?
Puedes redactar la parte de negocio: propósito, tono, materiales autorizados y decisiones que te reservas. Tu proveedor técnico concreta dónde se guarda y qué comprobaciones necesita el proyecto. No copies nombres de tecnologías que desconoces; empieza por explicar cómo reconocerás una entrega útil para tu empresa.
¿Sirve el mismo archivo para cualquier IA?
Depende de la herramienta y de cómo esté configurada. Algunas admiten nombres compartidos, pero cambian las carpetas que leen, las preferencias y el momento de carga. Antes de reutilizarlo, comprueba qué instrucciones están activas. Copiar el documento no demuestra que el nuevo agente lo haya incorporado al trabajo.
¿Qué hago si el agente incumple una regla?
Revisa el fallo concreto antes de alargar el documento. Comprueba si recibió el archivo, si hay contradicciones y qué resultado te entregó. Si la regla afecta a enviar, publicar o modificar datos reales, revisa también los permisos y las aprobaciones.
¿Cuánto debería ocupar el archivo?
Busca instrucciones breves y vigentes, con condiciones que puedas comprobar. No hay un tamaño ideal universal: cada herramienta tiene recomendaciones y límites propios. Prioriza lo que debe orientar el trabajo, separa el material de consulta y elimina reglas caducadas. Más texto no demuestra que el resultado vaya a ser mejor.
Fuentes
Fuentes oficiales, consultadas el 4 de noviembre de 2026
- AGENTS.md: finalidad del formato
- Anthropic: instrucciones y memoria del proyecto
- OpenAI: instrucciones de proyecto en Codex
- Cursor: reglas del proyecto
- Anthropic: configuración de permisos
- OpenAI: aprobaciones y aislamiento
Cómo lo comprobamos. Fuentes consultadas el 4 de noviembre de 2026. Describen la finalidad, la carga de instrucciones y los controles de las herramientas. Antes de aplicarlo a tu negocio, comprueba la carga del archivo y los permisos con una copia de prueba.
Qué ha cambiado.
- 4 de noviembre de 2026: Reescritura v2: contexto, encargo y permisos separados; ejemplo ilustrativo, reglas comprobables, condiciones de carga y preguntas frecuentes.
Términos relacionados
Aprende a usar la IA en tu trabajo, con criterio.
El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.
