I fileDocumentation 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 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.
Come funziona
AGENTS.md (o agents.md), Devin Desktop lo rileva automaticamente e lo passa allo stesso motore di Regole 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.
AGENTS.md ideale per fornire indicazioni mirate senza appesantire un unico file di configurazione globale.
Creare un file AGENTS.md
AGENTS.md o agents.md nella directory desiderata. Il file usa markdown semplice e non richiede alcun frontmatter speciale.
Struttura di esempio
Contenuto di esempio
AGENTS.md per una directory di componenti React:
Rilevamento e definizione dell’ambito
AGENTS.md in tutto il tuo workspace:
- Scansione del workspace: vengono rilevati tutti i file
AGENTS.mdpresenti 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.mdcheagents.md
Definizione automatica dell’ambito
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/** |
AGENTS.md a diversi livelli, ciascuno con indicazioni sempre più specifiche per la directory corrispondente.
Best practice
AGENTS.md:
- Mantieni le istruzioni mirate: ogni
AGENTS.mddovrebbe 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
Linee guida per i contenuti
Confronto con le Regole
AGENTS.md sia Regole 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 |
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.