> ## 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 file AGENTS.md per fornire a Cascade istruzioni specifiche per directory. Le istruzioni si applicano automaticamente in base alla posizione del file nel progetto.

I file `AGENTS.md` offrono un modo semplice per fornire a Cascade istruzioni contestuali che si applicano automaticamente in base alla posizione del file nel progetto. Questo è particolarmente utile per definire linee guida di codice specifiche per directory, decisioni architetturali o convenzioni di progetto.

<div id="how-it-works">
  ## Come funziona
</div>

Quando crei un file `AGENTS.md` (o `agents.md`), Devin Desktop lo rileva automaticamente e lo passa allo stesso motore di [Regole](/it/desktop/cascade/memories#rules) che usa `.devin/rules/` (e il legacy `.windsurf/rules/`) — ma con la modalità di attivazione dedotta dalla posizione del file anziché dal frontmatter:

* **Directory radice**: viene trattata come una regola **sempre attiva** — l'intero contenuto è incluso nel prompt di sistema di Cascade in ogni messaggio.
* **Sottodirectory**: vengono trattate come una regola **glob** con un pattern generato automaticamente del tipo `<directory>/**` — il contenuto viene applicato solo quando Cascade legge o modifica file all'interno di quella directory.

Questa definizione dell'ambito basata sulla posizione rende `AGENTS.md` ideale per fornire indicazioni mirate senza appesantire un unico file di configurazione globale.

<div id="creating-an-agentsmd-file">
  ## Creare un file AGENTS.md
</div>

Ti basta creare un file chiamato `AGENTS.md` o `agents.md` nella directory desiderata. Il file usa markdown semplice e non richiede alcun frontmatter speciale.

<div id="example-structure">
  ### Struttura di esempio
</div>

```
my-project/
├── AGENTS.md                    # Istruzioni globali per l'intero progetto
├── frontend/
│   ├── AGENTS.md                # Istruzioni specifiche per il codice frontend
│   └── src/
│       └── components/
│           └── AGENTS.md        # Istruzioni specifiche per i componenti
├── backend/
│   └── AGENTS.md                # Istruzioni specifiche per il codice backend
└── docs/
    └── AGENTS.md                # Istruzioni per la documentazione
```

<div id="example-content">
  ### Contenuto di esempio
</div>

Ecco un esempio di file `AGENTS.md` per una directory di componenti 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">
  ## Rilevamento e definizione dell'ambito
</div>

Devin Desktop rileva automaticamente i file `AGENTS.md` in tutto il tuo workspace:

* **Scansione del workspace**: vengono rilevati tutti i file `AGENTS.md` presenti nel tuo workspace e nelle relative sottodirectory
* **Supporto per i repository Git**: per i repository Git, Devin Desktop cerca anche nelle directory padre fino alla radice del repository
* **Senza distinzione tra maiuscole e minuscole**: vengono riconosciuti sia `AGENTS.md` che `agents.md`

<div id="automatic-scoping">
  ### Definizione automatica dell'ambito
</div>

Il vantaggio principale di `AGENTS.md` è la definizione automatica dell'ambito in base alla posizione del file:

| File Location           | Scope                                                             |
| ----------------------- | ----------------------------------------------------------------- |
| Radice del workspace    | Si applica a tutti i file (sempre attivo)                         |
| `/frontend/`            | Si applica quando si lavora con file in `/frontend/**`            |
| `/frontend/components/` | Si applica quando si lavora con file in `/frontend/components/**` |

Ciò significa che puoi avere più file `AGENTS.md` a diversi livelli, ciascuno con indicazioni sempre più specifiche per la directory corrispondente.

<div id="best-practices">
  ## Best practice
</div>

Per ottenere il massimo dai file `AGENTS.md`:

* **Mantieni le istruzioni mirate**: ogni `AGENTS.md` dovrebbe contenere istruzioni pertinenti allo scopo della directory corrispondente
* **Usa una formattazione chiara**: elenchi puntati, intestazioni e blocchi di codice rendono le istruzioni più facili da seguire per Cascade
* **Sii specifico**: esempi concreti e convenzioni esplicite funzionano meglio di linee guida vaghe
* **Evita le ridondanze**: non ripetere le istruzioni globali nei file delle sottodirectory; vengono ereditate dalle directory padre

<div id="content-guidelines">
  ### Linee guida per i contenuti
</div>

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

# Esempio Meno Efficace
- Write good code
- Be careful with errors
- Use best practices
```

<div id="comparison-with-rules">
  ## Confronto con le Regole
</div>

Sebbene sia `AGENTS.md` sia [Regole](/it/desktop/cascade/memories#rules) forniscano istruzioni a Cascade, hanno scopi diversi:

| Funzionalità            | AGENTS.md                                  | Regole                                                              |
| ----------------------- | ------------------------------------------ | ------------------------------------------------------------------- |
| Posizione               | Nelle directory del progetto               | `.devin/rules/` (o il percorso legacy `.windsurf/rules/`) o globale |
| Definizione dell'ambito | Automatico in base alla posizione del file | Manuale (glob, sempre attivo, decisione del modello, manuale)       |
| Formato                 | Markdown semplice                          | Markdown con frontmatter                                            |
| Ideale per              | Convenzioni specifiche della directory     | Esigenze trasversali, logica di attivazione complessa               |

Usa `AGENTS.md` quando vuoi istruzioni semplici basate sulla posizione. Usa le Regole quando ti serve un maggiore controllo su quando e come vengono applicate le istruzioni.