AGENTS.md ofrecen una forma sencilla de darle a Cascade instrucciones según el contexto que se aplican automáticamente en función de dónde esté ubicado el archivo en tu proyecto. Esto resulta especialmente útil para definir directrices de código específicas de un directorio, decisiones de arquitectura o convenciones del proyecto.
Cómo funciona
AGENTS.md (o agents.md), Devin Desktop lo detecta automáticamente y lo integra en el mismo motor de Rules que utiliza .devin/rules/ (y el anterior .windsurf/rules/), solo que con el modo de activación inferido a partir de la ubicación del archivo en lugar del frontmatter:
- Directorio raíz: Se considera una regla activa: todo el contenido se incluye en el prompt del sistema de Cascade en cada mensaje.
- Subdirectorios: Se consideran una regla glob con un patrón generado automáticamente de
<directory>/**: el contenido se aplica solo cuando Cascade lee o edita archivos dentro de ese directorio.
AGENTS.md sea ideal para proporcionar orientación específica sin recargar un único archivo de configuración global.
Cómo crear un archivo AGENTS.md
AGENTS.md o agents.md en el directorio deseado. El archivo usa Markdown simple y no requiere ningún frontmatter especial.
Estructura de ejemplo
Contenido de ejemplo
AGENTS.md para un directorio de componentes de React:
Detección y ámbito
AGENTS.md en todo tu espacio de trabajo:
- Escaneo del espacio de trabajo: Se detectan todos los archivos
AGENTS.mddentro de tu espacio de trabajo y sus subdirectorios - Compatibilidad con repositorios Git: En los repositorios Git, Devin Desktop también busca en los directorios superiores hasta la raíz del repositorio
- Sin distinción entre mayúsculas y minúsculas: Se reconocen tanto
AGENTS.mdcomoagents.md
Determinación automática del ámbito
AGENTS.md es la determinación automática del ámbito en función de la ubicación del archivo:
Esto significa que puedes tener múltiples archivos
AGENTS.md en distintos niveles, cada uno con instrucciones cada vez más específicas para sus respectivos directorios.
Buenas prácticas
AGENTS.md:
- Mantén las instrucciones centradas: Cada
AGENTS.mddebe incluir instrucciones relevantes para el propósito de su directorio - Usa un formato claro: Las viñetas, los encabezados y los bloques de código facilitan que Cascade siga las instrucciones
- Sé específico: Los ejemplos concretos y las convenciones explícitas funcionan mejor que las pautas vagas
- Evita la redundancia: No repitas las instrucciones globales en los archivos de subdirectorios; se heredan de los directorios padre
Pautas de contenido
Comparación con Rules
AGENTS.md como Rules proporcionan instrucciones a Cascade, tienen propósitos distintos:
Usa
AGENTS.md cuando quieras instrucciones sencillas basadas en la ubicación. Usa Rules cuando necesites más control sobre cuándo y cómo se aplican las instrucciones.