Cómo hacer que el agente de Warp realmente use las reglas de tu proyecto (2026)

El nombre del archivo distingue entre mayúsculas y minúsculas, y solo funciona una opción

Las Reglas del Proyecto "viven en tu base de código y se aplican automáticamente al trabajar dentro de ese proyecto", almacenadas en "un archivo AGENTS.md (o WARP.md para compatibilidad con versiones anteriores)". La guía de Warp para nuevos proyectos es AGENTS.md.

El requisito de mayúsculas se marca como una Advertencia (Caution) en la documentación, lo cual es la gravedad adecuada. Falla silenciosamente, y falla exactamente de la manera que te hace dudar de la funcionalidad en lugar del nombre del archivo: escribes una regla, nada cambia y concluyes que el agente ignora las reglas.

WARP.md sigue funcionando, pero está documentado como compatibilidad con versiones anteriores. Si heredaste un repositorio con uno, se está cargando; si estás empezando de cero, usa AGENTS.md.

Las reglas de subdirectorios solo se cargan de forma condicional

Esta es la causa más sutil, y se indica claramente una vez. "Warp aplica automáticamente el AGENTS.md (o WARP.md) en la raíz y en el directorio actual". Luego: "Si editas archivos en otro subdirectorio, Warp hace un intento de mejor esfuerzo (best-effort) para incluir también el archivo de reglas de ese subdirectorio".

Automático para dos ubicaciones. Mejor esfuerzo para todo lo demás.

El propio ejemplo práctico de Warp aclara la estructura. Con el directorio actual establecido en ui/, las reglas aplicadas automáticamente son project/AGENTS.md y project/ui/AGENTS.md, mientras que project/api/AGENTS.md es de mejor esfuerzo, es decir, se incluye solo si editas archivos allí. Cambia el directorio actual a api/ y los roles se invierten.

Por lo tanto, un monorrepo con reglas por paquete tiene un nivel confiable y otro no confiable, y cuál es cuál depende de dónde iniciaste la sesión. Si una regla es importante para todo el repositorio, el archivo raíz es el único lugar donde se garantiza que se cargará.

La regla más específica gana, lo cual no siempre es lo que querías decir

Warp resuelve los conflictos en un orden documentado: reglas en el archivo del subdirectorio actual, luego reglas en el archivo raíz y, por último, Reglas Globales (Global Rules). La intención declarada es que "las reglas más específicas y relevantes para el proyecto tengan prioridad sobre las más generales".

Eso es razonable y también es la forma en que una norma a nivel de raíz deja de aplicarse silenciosamente. Un archivo de subdirectorio escrito hace dieciocho meses para un paquete ahora tiene prioridad sobre la convención que agregaste a la raíz la semana pasada, solo en ese directorio, razón por la cual parece intermitente.

Las Reglas Globales van al final. Cualquier cosa que pongas allí es lo primero que se sobrescribe.

Es posible que la regla esté en un archivo que nunca se le indicó leer a Warp

Warp es inusualmente generoso aquí, y la generosidad es opcional. Ejecutar /init puede "vincular un archivo de reglas existente a AGENTS.md", y la lista de soporte es más larga que la de cualquier herramienta comparable: "CLAUDE.md, .cursorrules, AGENT.md, GEMINI.md, .clinerules, .windsurfrules, .github/copilot-instructions.md".

Ten en cuenta que AGENT.md en singular está en esa lista y no es el mismo archivo que AGENTS.md. Si tu repositorio tiene la forma en singular, es un archivo externo vinculable en lugar del nativo de Warp.

La trampa es asumir la detección automática donde hay vinculación. Un repositorio lleno de archivos CLAUDE.md no alimenta automáticamente a Warp; debes vincularlo. Los equipos que migran desde otro agente se topan con esto constantemente; la parte de la conversión de archivos se cubre en cómo migrar tu CLAUDE.md a AGENTS.md.

Y es posible que tengas reglas que no escribiste

Una línea que vale la pena conocer: "Warp también puede sugerir Reglas Globales basadas en tus patrones de uso para hacer que las interacciones futuras sean más inteligentes y consistentes". Las reglas sugeridas son una comodidad, pero si nunca has abierto el panel de Reglas Globales, no sabes qué hay en él. Verifica antes de concluir que una regla está siendo ignorada; podría estar siendo sobrescrita por algo que nunca leíste.

Escribir la regla de nuevo, con más fuerza. Mayúsculas en el cuerpo, más signos de exclamación. Si el nombre del archivo está en minúsculas o el archivo está en un subdirectorio no cargado, el énfasis no cambia nada.

Mover todo a un único archivo raíz gigante. Esto soluciona la carga, pero cambia un problema por otro: ahora cada regla se carga en cada solicitud, incluidas las veinte líneas sobre un paquete que ni siquiera estás tocando.

Pegar las reglas en el prompt. Confiable y manual, lo que significa que funciona hasta que te olvidas una vez.

Asumir que Warp ignora CLAUDE.md. No lo hace, pero necesita ser vinculado a través de /init, no simplemente estar presente.

Poner el conocimiento del proyecto en Warp Drive. Warp Drive es realmente útil y se sincroniza en tiempo real en todo un equipo, pero está documentado como un espacio de trabajo para "Flujos de trabajo, Notebooks, Prompts y Variables de entorno". No es un almacén de reglas o conocimiento, y el panel de Reglas que vive dentro de él es una comodidad de la interfaz de usuario en lugar de un cambio en lo que contiene Drive.

Convertir las reglas en un proyecto de documentación. El instinto correcto con el contenedor equivocado: un archivo de reglas guía el comportamiento, y el razonamiento detrás de las reglas no tiene cabida en él.

Warp te da algo que la mayoría de las herramientas no ofrecen: una forma de verificar. "Las reglas utilizadas en una interacción aparecerán en la conversación bajo References (Referencias) o marcadas como derivadas de una regla específica".

Usa eso antes de cambiar nada. Pídele al agente que haga algo que la regla controle, luego mira en References. Si la regla no aparece en la lista, el problema es de carga: primero verifica las mayúsculas y minúsculas del nombre del archivo, luego si el archivo está en la raíz o en tu directorio actual. Si la regla aparece en la lista y el agente aun así hizo otra cosa, el problema no es de carga, y reescribir el archivo no ayudará.

Luego, busca los paneles de reglas para ver el estado real, no lo que recuerdas haber escrito. Hay cinco puntos de entrada documentados: Warp Drive en Personal > Rules; la Paleta de comandos, buscando "Open AI Rules"; Settings > Agents > Knowledge > Manage Rules; la barra de menú en AI > Open Rules; y el comando de barra diagonal /open-project-rules, que abre las Reglas del Proyecto directamente en el editor de Warp. Usa /add-rule para crear una Regla Global y dale una descripción real; el prompt del campo de Warp es "qué hace la regla y cuándo aplicarla", y la descripción es lo que el agente lee para decidir su relevancia.

Eso soluciona la carga. No soluciona la segunda mitad, que es que un archivo de reglas tiene la estructura incorrecta para la mayor parte de lo que sabes. Las reglas son instrucciones que se aplican en el momento de la solicitud; son cortas por necesidad y compiten por el contexto. La razón por la que existe una convención, el enfoque que ya rechazaste, la restricción que hace que la respuesta obvia sea incorrecta... nada de eso es una instrucción, y ponerlo en AGENTS.md hace que el archivo sea más largo sin lograr que el agente lo siga más de cerca.

Eso es lo que almacena MemoryLake: el conocimiento duradero de tu proyecto en una capa que tus herramientas consultan, de modo que las reglas sigan siendo cortas y el razonamiento permanezca disponible. La configuración consta de tres pasos.

Paso 1: Crear una clave API

Inicia sesión y crea una clave API. Una sola credencial para todas las herramientas que conectes.

Paso 2: Subir tus primeros recuerdos

Entradas cortas, una sola afirmación cada una. La mejor fuente es el archivo de reglas que estabas a punto de hacer más largo:

La razón de cada regla. "Las migraciones son solo aditivas porque la réplica de lectura se retrasa bajo carga". La regla pertenece a AGENTS.md; esto pertenece aquí, y es lo que evita que la regla se revierta el próximo trimestre.

Enfoques ya rechazados en este repositorio. La categoría que no aparece en ningún archivo de reglas ni en ningún mensaje de commit, y que se vuelve a proponer en cada nueva sesión.

Hechos del entorno que nada anuncia. La prueba que solo falla en CI, el límite de tasa no documentado, la dependencia de orden entre dos tareas.

Aquello en lo que los archivos de subdirectorios no están de acuerdo. Si tus reglas por paquete entran en conflicto con la raíz, escribe cuál está vigente y por qué. Eso es un hecho, no una regla.

Paso 3: Conectar tu IA y agentes

Conecta lo que uses. MemoryLake es accesible a través de MCP y de una API, y Warp admite servidores MCP, con un detalle que vale la pena conocer: "La CLI mantiene su propia configuración de servidor MCP, independiente de la de la aplicación Warp", almacenada en macOS en ~/.warp_cli/.mcp.json. Configura ambos si usas ambos. Los agentes nativos de MCP como Claude, Codex y OpenClaw se conectan de la misma manera, y otros asistentes leen la misma memoria a través de la API.

Tres límites honestos. MemoryLake no escribe tu AGENTS.md ni tus Reglas Globales; esas son las formas en que diriges Warp, y el comportamiento de carga anterior es de Warp, no algo que una capa de memoria cambie. Solo contiene lo que tú o tus agentes ponen en ella, por lo que el Paso 2 es manual. And las reglas son contexto en lugar de una configuración forzada; cualquier cosa que deba cumplirse siempre necesita una verificación en CI, no una línea en un archivo markdown.

"¿Se está cargando la regla?" se convierte en una comprobación de dos segundos. Mira en References.

Las mayúsculas y minúsculas del nombre del archivo dejan de ser un error misterioso. AGENTS.md, todo en mayúsculas, o no existe.

Raíz frente a subdirectorio se convierte en una elección deliberada. La raíz está garantizada; en otros lugares es de mejor esfuerzo.

Los archivos de reglas se vuelven más cortos. El razonamiento se traslada fuera, por lo que lo que queda son instrucciones.

Migrar ya no significa reescribir. Se pueden vincular siete formatos externos con /init.

Tu CLI y tu aplicación se mantienen sincronizados en las partes que importan. La documentación de Warp señala que "Las reglas y habilidades no necesitan migración" entre ellas: ambas leen las mismas ubicaciones de archivos. La configuración de MCP es la excepción.

Verifica las mayúsculas y minúsculas primero, siempre. Es el diagnóstico más rápido posible y la causa más común.

Pon las reglas de todo el repositorio en el archivo raíz. Solo la raíz y el directorio actual se cargan automáticamente.

Audita los archivos de tus subdirectorios en busca de anulaciones obsoletas. El archivo más específico gana, y los archivos antiguos siguen siendo específicos.

Lee tu panel de Reglas Globales al menos una vez. Warp puede haber sugerido reglas que nunca has visto.

Vincula, no dupliques. /init vincula CLAUDE.md, .cursorrules, .clinerules y otros cuatro. Dos copias de las mismas reglas terminan desincronizándose.

Dale a las Reglas Globales una descripción real. Es lo que el agente lee para decidir la relevancia.

Verifica con References, no releyendo el archivo. Lo que se cargó es un hecho; lo que escribiste es una intención.

Mantén el razonamiento fuera del archivo de reglas. Las reglas se aplican en el momento de la solicitud y compiten por el contexto; la estructura general se detalla en qué es realmente la memoria de IA.

El sistema de reglas de Warp funciona bien una vez que conoces sus cuatro límites. El nombre del archivo debe estar en mayúsculas, y un agents.md en minúsculas falla silenciosamente. Solo el archivo raíz y el archivo del directorio actual se cargan automáticamente, y todo lo demás se maneja bajo un criterio de mejor esfuerzo que depende de qué archivos decidas tocar. Los conflictos se resuelven a favor del archivo más específico, por lo que una regla antigua de un subdirectorio tiene prioridad sobre una nueva norma de la raíz en ese directorio. And se pueden vincular siete formatos de reglas externos con /init: vinculados, no detectados automáticamente.

La parte realmente buena es la vía de verificación. Las reglas que se activaron aparecen en la conversación bajo References, lo que convierte la pregunta "¿se está cargando mi regla?" de un juego de adivinanzas a una simple mirada. La mayoría de las herramientas de esta categoría no ofrecen esa vista, y vale la pena adquirir el hábito de verificarla antes de editar cualquier cosa.

Lo que las reglas no pueden hacer es contener el razonamiento. Son cortas, se cargan en cada solicitud relevante y, en el momento en que comienzas a explicar por qué existe una convención, estás empeorando el archivo en su función real. Verifica las mayúsculas y minúsculas, pon las reglas de todo el repositorio en la raíz, audita las anulaciones de tus subdirectorios, verifica con References y coloca las decisiones, razones y enfoques rechazados en una capa que tu agente pueda consultar en lugar de un archivo que tenga que leer cada vez.