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

# AGENTS.md

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

Los archivos `AGENTS.md` proporcionan una forma sencilla de darle a Cascade instrucciones sensibles al contexto que se aplican automáticamente según dónde se encuentre el archivo dentro de tu proyecto. Esto es especialmente útil para definir guías de codificación 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`), Windsurf lo detecta automáticamente y lo incorpora al mismo motor de [Rules](/es/windsurf/cascade/memories#rules) que impulsa `.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 trata como una regla **siempre activa** — el contenido completo se incluye en el prompt del sistema de Cascade en cada mensaje.
* **Subdirectorios**: Se tratan como 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 alcance basado en la ubicación hace que `AGENTS.md` sea ideal para proporcionar instrucciones específicas sin sobrecargar un único archivo de configuración global.

<div id="creating-an-agentsmd-file">
  ## Creación de un archivo AGENTS.md
</div>

Basta con crear un archivo llamado `AGENTS.md` o `agents.md` en el directorio deseado. El archivo usa Markdown normal y no requiere ningún *frontmatter* especial.

<div id="example-structure">
  ### Ejemplo de estructura
</div>

```
my-project/
├── AGENTS.md                    # Instrucciones globales para todo el proyecto
├── frontend/
│   ├── AGENTS.md                # Instrucciones específicas para el código del frontend
│   └── src/
│       └── components/
│           └── AGENTS.md        # Instrucciones específicas para los componentes
├── backend/
│   └── AGENTS.md                # Instrucciones específicas para el código del 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}
# Component Guidelines

When working with components in this directory:

- Use functional components with hooks
- Follow the naming convention: ComponentName.tsx for components, useHookName.ts for hooks
- Each component should have a corresponding test file: ComponentName.test.tsx
- Use CSS modules for styling: ComponentName.module.css
- Export components as named exports, not default exports

## File Structure

Each component folder should contain:
- The main component file
- A test file
- A styles file (if needed)
- An index.ts for re-exports
```

<div id="discovery-and-scoping">
  ## Descubrimiento y definición del alcance
</div>

Windsurf detecta automáticamente archivos `AGENTS.md` en todo tu workspace:

* **Escaneo del workspace**: Se detectan todos los archivos `AGENTS.md` dentro de tu workspace y sus subdirectorios
* **Compatibilidad con repositorios Git**: Para repositorios Git, Windsurf también busca en los directorios padre 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">
  ### Alcance automático
</div>

El beneficio principal de `AGENTS.md` es el alcance automático basado en la ubicación de los archivos:

| Ubicación del archivo   | Alcance                                                         |
| ----------------------- | --------------------------------------------------------------- |
| Raíz del workspace      | 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 varios archivos `AGENTS.md` en distintos niveles, cada uno proporcionando instrucciones cada vez más específicas para sus respectivos directorios.

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

Para aprovechar al máximo los archivos `AGENTS.md`:

* **Mantén las instrucciones bien enfocadas**: Cada `AGENTS.md` debe contener instrucciones relevantes para el propósito de su directorio
* **Usa un formato claro**: Las viñetas, encabezados y bloques de código hacen que a Cascade le resulte más fácil seguir las instrucciones
* **Sé específico**: Los ejemplos concretos y las convenciones explícitas funcionan mejor que las pautas vagas
* **Evita la redundancia**: No repitas instrucciones globales en los archivos de subdirectorios; estos las heredan de los directorios padre

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

```markdown theme={null}
# Good Example
- Use TypeScript strict mode
- All API responses must include error handling
- Follow REST naming conventions for endpoints

# Less Effective Example
- Write good code
- Be careful with errors
- Use best practices
```

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

Si bien tanto `AGENTS.md` como [Rules](/es/windsurf/cascade/memories#rules) proporcionan instrucciones a Cascade, tienen propósitos diferentes:

| Característica | AGENTS.md                                 | Rules                                                      |
| -------------- | ----------------------------------------- | ---------------------------------------------------------- |
| Ubicación      | En los directorios del proyecto           | `.windsurf/rules/` o global                                |
| Alcance        | Automático según la ubicación del archivo | Manual (glob, siempre activo, decisión del modelo, manual) |
| Formato        | Markdown sin metadatos                    | Markdown con frontmatter                                   |
| Mejor para     | Convenciones específicas de un directorio | Aspectos transversales, lógica de activación compleja      |

Usa `AGENTS.md` cuando quieras instrucciones simples basadas en la ubicación. Usa Rules cuando necesites más control sobre cuándo y cómo se aplican las instrucciones.