Empieza por el negocio y su objetivo
Explica qué hace el proyecto, para quién existe y qué resultado debe conservar. Esa apertura da sentido a las instrucciones y ayuda a evaluar cambios propuestos por el agente. Utiliza información concreta, evitando una presentación extensa de la empresa que no modifique cómo se ejecuta la tarea o cómo se comprueba su resultado.
Un portal interno hipotético puede permitir preparar propuestas y obtener aprobación antes de enviarlas. Esa finalidad orienta permisos, estados y avisos. Describirlo únicamente como una aplicación moderna con IA no identifica a sus usuarios ni explica qué debe ocurrir para cumplir su objetivo.
Añade el alcance y las exclusiones. Si esta fase no incluye pagos ni acceso de clientes, regístralo. El agente puede sugerir ampliaciones, pero el documento debe distinguir la necesidad actual de funciones interesantes para un producto futuro más amplio.
Preparar el plan antes de desarrollar aporta la base. El archivo de instrucciones puede resumir decisiones estables y señalar requisitos detallados, en lugar de repetirlo todo. Así evitas mantener dos descripciones largas cuya coherencia resultaría más difícil de asegurar.
Para preparar el siguiente paso, consulta Desarrollar aplicaciones con IA.
Escribe límites aplicables a decisiones concretas
Convierte preferencias y restricciones en instrucciones que permitan elegir cómo actuar. Indica qué requiere aprobación y qué decisiones no deben reabrirse sin motivo. Una regla útil explica qué hacer en una situación real, además de expresar una intención general de calidad que cada agente podría interpretar de manera distinta según el contexto de la tarea.
En mi proyecto, registrar portugués de Portugal y distinguir sugerencias del asistente de decisiones confirmadas orienta la colaboración. Esas instrucciones siguen siendo pertinentes cuando cambia la tarea. No hace falta reconstruir la conversación original para entender cómo aplicarlas.
Puedes necesitar aclarar que redactar un mensaje no autoriza enviarlo o que modificar condiciones comerciales exige la decisión del responsable. Escribe el límite y quién decide. Las expresiones vagas dejan al agente interpretar por su cuenta qué considera demasiado importante para ejecutar.
Las reglas escritas deben corresponder a los controles de la aplicación. Prohibir en un documento el acceso a unos datos no sustituye restringirlo técnicamente. Guarda comportamiento esperado y referencias, pero conserva credenciales e información confidencial fuera de los documentos que acompañan al proyecto.
Conserva decisiones estables y enlaza los detalles
Incluye decisiones que seguirán condicionando el trabajo y remite los detalles a documentos propios. Idioma, aprobación o identidad visual pueden merecer presencia permanente; una ejecución concreta puede quedar en el historial. Selecciona según lo que ayuda a orientar la siguiente tarea, sin convertir cada resultado temporal en una regla para todo el proyecto.
Si utilizas una identidad visual definida, señala la referencia aprobada y los originales. Pedir coherencia sin mostrar con qué debe ser coherente resulta insuficiente. Tampoco necesitas incluir todas las imágenes y conversaciones de diseño dentro del documento principal.
Seleccionar contexto para la IA ayuda a elegir el detalle. Una instrucción breve puede enlazar una especificación extensa si la referencia es clara y accesible. El agente debe reconocer cuándo consultarla y cuál contiene la decisión vigente.
Explica el motivo si evita errores. Conservar una dirección utilizada en materiales distribuidos es distinto de mantener direcciones por costumbre. Ese contexto permite evaluar una modificación futura sin convertir la regla en una prohibición cuyo propósito nadie entiende.
Describe cómo trabajar y comprobar el resultado
Indica cómo localizar el proyecto, ejecutar comprobaciones pertinentes y presentar los cambios. Ajusta las instrucciones al entorno real y a la capacidad del equipo para verificarlas. El objetivo es hacer comprobable el trabajo, sin presentar una lista de pruebas sugeridas como si demostrara que ya se realizaron y que sus resultados fueron satisfactorios.
En un proyecto de software puede ser útil señalar los comandos de validación que ya existen y explicar qué modificaciones requieren pruebas de permisos o una revisión de la interfaz. Si no sabes cuáles son esos comandos, pide al agente que los identifique dentro del proyecto y confirme su funcionamiento antes de registrarlos. Copiar una lista genérica puede crear instrucciones que el equipo no tenga forma de cumplir en ese entorno.
Define también cómo debe describirse la conclusión del trabajo: qué se modificó, qué se verificó realmente y qué limitación sigue pendiente. Distingue una previsualización local de una versión puesta a disposición de otras personas en internet. Del mismo modo, separa una acción que se intentó de una acción cuyo resultado pudo confirmarse. Esos detalles hacen que el estado sea comprensible para quien necesita decidir el siguiente paso.
La preparación de la primera sesión permite localizar referencias de entorno y acceso que conviene documentar. Guarda dónde encontrar información y quién la facilita, sin copiar secretos. Las instrucciones deben facilitar trabajo autorizado y mostrar cuándo falta una condición para realizarlo.
Mantén una referencia principal y confirma su lectura
Elige una fuente principal de instrucciones y mantén coherentes los archivos utilizados por las distintas herramientas. Comprueba cómo se leen en el entorno instalado, sin asumir que los nombres son equivalentes. Revisa las reglas al cambiar decisiones o procesos, elimina contradicciones de la versión activa y conserva el historial cuando tenga utilidad para entender la evolución.
CLAUDE.md y AGENTS.md se utilizan en contextos de instrucciones para agentes, pero no todos los productos los cargan igual. Ubicación, configuración y soporte pueden variar. Antes de depender de una regla, confirma que el agente recibió el documento y entiende cómo se aplica al trabajo.
Si mantienes versiones para varios entornos, evita editarlas de forma independiente sin referencia común. Cambiar una aprobación en uno y dejar la anterior en otro puede generar comportamientos incompatibles. El mecanismo técnico para compartir instrucciones debe elegirse y probarse, sin dar por supuesta su compatibilidad.
Finalmente, lee el documento como si acabaras de llegar. Debe permitir entender objetivo, límites, decisiones actuales y comprobaciones. Si necesitas recorrer toda la historia para encontrar esas respuestas, reorganiza el archivo y devuelve los detalles a sus registros correspondientes.