> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AGENTS.md

> Crea archivos AGENTS.md para proporcionar a Cascade instrucciones por directorio. Las instrucciones se aplican automáticamente según la ubicación del archivo en tu proyecto.

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.

<div id="how-it-works">
  ## Cómo funciona
</div>

Cuando creas un archivo `AGENTS.md` (o `agents.md`), Devin Desktop lo detecta automáticamente y lo integra en el mismo motor de [Rules](/es/desktop/cascade/memories#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.

Este ámbito basado 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.

<div id="creating-an-agentsmd-file">
  ## Cómo crear un archivo AGENTS.md
</div>

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.

<div id="example-structure">
  ### Estructura de ejemplo
</div>

```
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
```

<div id="example-content">
  ### Contenido de ejemplo
</div>

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

```markdown theme={null}
# 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
```

<div id="discovery-and-scoping">
  ## Detección y ámbito
</div>

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`

<div id="automatic-scoping">
  ### Determinación automática del ámbito
</div>

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 trabajo | Se 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.

<div id="best-practices">
  ## Buenas prácticas
</div>

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

<div id="content-guidelines">
  ### Pautas de contenido
</div>

```markdown theme={null}
# 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
```

<div id="comparison-with-rules">
  ## Comparación con Rules
</div>

Aunque tanto `AGENTS.md` como [Rules](/es/desktop/cascade/memories#rules) proporcionan instrucciones a Cascade, tienen propósitos distintos:

| Característica | AGENTS.md                                   | Rules                                                                  |
| -------------- | ------------------------------------------- | ---------------------------------------------------------------------- |
| Ubicación      | En los directorios del proyecto             | `.devin/rules/` (o el directorio heredado `.windsurf/rules/`) o global |
| Ámbito         | Automático según la ubicación del archivo   | Manual (glob, activo, decisión del modelo, manual)                     |
| Formato        | Markdown simple                             | Markdown con frontmatter                                               |
| Ideal para     | Convenciones específicas de cada directorio | Aspectos 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.