Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Los archivos 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

Cuando creas un archivo AGENTS.md (o agents.md), Devin Desktop lo detecta automáticamente y lo integra en el mismo motor de Rules que utiliza .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.
Esta delimitación basada en la ubicación hace que 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

Solo tienes que crear un archivo llamado AGENTS.md o agents.md en el directorio deseado. El archivo usa Markdown simple y no requiere ningún frontmatter especial.

​
Estructura de ejemplo

my-project/
├── AGENTS.md                    # Instrucciones globales para todo el proyecto
├── frontend/
│   ├── AGENTS.md                # Instrucciones específicas para el código frontend
│   └── src/
│       └── components/
│           └── AGENTS.md        # Instrucciones específicas para los componentes
├── backend/
│   └── AGENTS.md                # Instrucciones específicas para el código backend
└── docs/
    └── AGENTS.md                # Instrucciones para la documentación

​
Contenido de ejemplo

Aquí tienes un ejemplo de archivo AGENTS.md para un directorio de componentes de React: 
# Directrices de componentes

Al trabajar con componentes en este directorio:

- Usa componentes funcionales con hooks
- Sigue la convención de nomenclatura: ComponentName.tsx para componentes, useHookName.ts para hooks
- Cada componente debe tener un archivo de prueba correspondiente: ComponentName.test.tsx
- Usa módulos CSS para los estilos: ComponentName.module.css
- Exporta los componentes como exportaciones con nombre, no como exportaciones predeterminadas

## Estructura de archivos

Cada carpeta de componente debe contener:
- El archivo principal del componente
- Un archivo de prueba
- Un archivo de estilos (si es necesario)
- Un index.ts para re-exportaciones

​
Detección y ámbito

Devin Desktop detecta automáticamente los archivos AGENTS.md en todo tu espacio de trabajo:
  • Escaneo del espacio de trabajo: Se detectan todos los archivos AGENTS.md dentro 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.md como agents.md

​
Determinación automática del ámbito

El principal beneficio de AGENTS.md es la determinación automática del ámbito en función de la ubicación del archivo:
Ubicación del archivoÁmbito
Raíz del espacio de trabajoSe aplica a todos los archivos (siempre activo)
/frontend/Se aplica al trabajar con archivos en /frontend/**
/frontend/components/Se aplica al trabajar con archivos en /frontend/components/**
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

Para sacar el máximo partido a los archivos AGENTS.md:
  • Mantén las instrucciones centradas: Cada AGENTS.md debe 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

# Buen ejemplo
- Use TypeScript strict mode
- All API responses must include error handling
- Follow REST naming conventions for endpoints

# Ejemplo menos efectivo
- Write good code
- Be careful with errors
- Use best practices

​
Comparación con Rules

Aunque tanto AGENTS.md como Rules proporcionan instrucciones a Cascade, tienen propósitos distintos:
CaracterísticaAGENTS.mdRules
UbicaciónEn los directorios del proyecto.windsurf/rules/ o global
ÁmbitoAutomático según la ubicación del archivoManual (glob, siempre activado, decisión del modelo, manual)
FormatoMarkdown simpleMarkdown con frontmatter
Ideal paraConvenciones específicas de cada directorioAspectos transversales y lógica de activación compleja
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.