> ## 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ți fișiere AGENTS.md pentru a oferi instrucțiuni la nivel de director pentru Cascade. Instrucțiunile se aplică automat în funcție de locația fișierului în proiectul dvs.

Fișierele `AGENTS.md` oferă o modalitate simplă de a furniza instrucțiuni sensibile la context pentru Cascade, care se aplică automat în funcție de locul în care se află fișierul în proiect. Acest lucru este deosebit de util pentru a specifica ghiduri de scriere a codului specifice unui director, decizii de arhitectură sau convenții ale proiectului.

<div id="how-it-works">
  ## Cum funcționează
</div>

Când creați un fișier `AGENTS.md` (sau `agents.md`), Windsurf îl detectează automat și îl transmite către același motor de [Rules](/ro/windsurf/cascade/memories#rules) care stă la baza `.windsurf/rules/` — doar că modul de activare este dedus în funcție de locația fișierului, în loc să fie definit în frontmatter:

* **Directorul rădăcină**: Este tratat ca o regulă **mereu activă** — întregul conținut este inclus în promptul de sistem al Cascade la fiecare mesaj.
* **Subdirectoare**: Sunt tratate ca o regulă **glob**, cu un tipar generat automat de forma `<directory>/**` — conținutul este aplicat doar atunci când Cascade citește sau editează fișiere din acel director.

Această delimitare în funcție de locația fișierului face ca `AGENTS.md` să fie ideal pentru a oferi îndrumări specifice, fără a încărca un singur fișier global de configurare.

<div id="creating-an-agentsmd-file">
  ## Crearea unui fișier AGENTS.md
</div>

Creați pur și simplu un fișier numit `AGENTS.md` sau `agents.md` în directorul dorit. Fișierul folosește markdown simplu, fără să fie necesară vreo secțiune specială de frontmatter.

<div id="example-structure">
  ### Exemplu de structură
</div>

```
my-project/
├── AGENTS.md                    # Instrucțiuni globale pentru întregul proiect
├── frontend/
│   ├── AGENTS.md                # Instrucțiuni specifice pentru codul frontend
│   └── src/
│       └── components/
│           └── AGENTS.md        # Instrucțiuni specifice pentru componente
├── backend/
│   └── AGENTS.md                # Instrucțiuni specifice pentru codul backend
└── docs/
    └── AGENTS.md                # Instrucțiuni pentru documentație
```

<div id="example-content">
  ### Exemplu de conținut
</div>

Iată un exemplu de fișier `AGENTS.md` pentru un folder de componente React:

```markdown theme={null}
# Ghid pentru Componente

Când lucrați cu componente în acest director:

- Utilizați componente funcționale cu hooks
- Respectați convenția de denumire: ComponentName.tsx pentru componente, useHookName.ts pentru hooks
- Fiecare componentă trebuie să aibă un fișier de test corespunzător: ComponentName.test.tsx
- Utilizați module CSS pentru stilizare: ComponentName.module.css
- Exportați componentele ca export-uri cu nume, nu export-uri implicite

## Structura Fișierelor

Fiecare folder de componentă trebuie să conțină:
- Fișierul principal al componentei
- Un fișier de test
- Un fișier de stiluri (dacă este necesar)
- Un index.ts pentru re-export-uri
```

<div id="discovery-and-scoping">
  ## Descoperire și delimitare
</div>

Windsurf descoperă automat fișierele `AGENTS.md` în întregul workspace:

* **Scanarea workspace-ului**: Toate fișierele `AGENTS.md` din workspace și din subdirectoarele sale sunt detectate
* **Suport pentru repository-uri Git**: Pentru repository-urile Git, Windsurf caută și în directoarele părinte până la rădăcina repository-ului Git
* **Ignorarea diferențelor între majuscule și minuscule**: Atât `AGENTS.md`, cât și `agents.md` sunt recunoscute

<div id="automatic-scoping">
  ### Delimitare automată
</div>

Principalul beneficiu al fișierului `AGENTS.md` este delimitarea automată pe baza locației fișierului:

| Locația fișierului      | Domeniu de aplicare                                                   |
| ----------------------- | --------------------------------------------------------------------- |
| Rădăcina workspace-ului | Se aplică tuturor fișierelor (activ permanent)                        |
| `/frontend/`            | Se aplică atunci când lucrați cu fișiere în `/frontend/**`            |
| `/frontend/components/` | Se aplică atunci când lucrați cu fișiere în `/frontend/components/**` |

Aceasta înseamnă că puteți avea mai multe fișiere `AGENTS.md` la niveluri diferite, fiecare oferind instrucțiuni din ce în ce mai specifice pentru directoarele respective.

<div id="best-practices">
  ## Cele mai bune practici
</div>

Pentru a profita la maximum de fișierele `AGENTS.md`:

* **Mențineți instrucțiunile bine focalizate**: Fiecare fișier `AGENTS.md` ar trebui să conțină instrucțiuni relevante pentru scopul directorului său
* **Folosiți o formatare clară**: Listele cu marcatori, titlurile și blocurile de cod fac instrucțiunile mai ușor de urmat pentru Cascade
* **Fiți specifici**: Exemplele concrete și convențiile explicite funcționează mai bine decât recomandările vagi
* **Evitați redundanța**: Nu repetați instrucțiunile globale în fișierele din subdirectoare; acestea sunt moștenite de la directoarele părinte

<div id="content-guidelines">
  ### Recomandări pentru conținut
</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">
  ## Comparație cu Rules
</div>

Deși atât `AGENTS.md`, cât și [Rules](/ro/windsurf/cascade/memories#rules) oferă instrucțiuni pentru Cascade, ele au scopuri diferite:

| Caracteristică          | AGENTS.md                            | Rules                                                   |
| ----------------------- | ------------------------------------ | ------------------------------------------------------- |
| Locație                 | În directoarele proiectului          | `.windsurf/rules/` sau global                           |
| Domeniu de aplicare     | Automat, pe baza locației fișierului | Manual (glob, mereu activ, decizie a modelului, manual) |
| Format                  | Markdown simplu                      | Markdown cu frontmatter                                 |
| Cel mai potrivit pentru | Convenții specifice directorului     | Aspecte transversale, logică de activare complexă       |

Utilizați `AGENTS.md` când doriți instrucțiuni simple, bazate pe locație. Utilizați Rules când aveți nevoie de mai mult control asupra momentului și modului în care sunt aplicate instrucțiunile.