# Regole (/it/docs/verdent-manager/configuration/rules)

> Controllare il comportamento di Verdent tramite file di regole



I file di regole sono documenti Markdown che definiscono come si comporta Verdent durante le sessioni di programmazione. Guidano il comportamento dell'agente AI, la formattazione dell'output e l'aderenza agli standard del progetto.

## Cosa imparerai [#cosa-imparerai]

* Comprendere le regole utente e le regole di progetto
* Quando usare ciascun tipo di regola
* Scrivere regole efficaci

***

## Tipi di regole [#tipi-di-regole]

| Tipo di regola         | File       | Ambito                     | Scopo                                       |
| ---------------------- | ---------- | -------------------------- | ------------------------------------------- |
| **Regole utente**      | VERDENT.md | Globale (tutti i progetti) | Preferenze di programmazione personali      |
| **Regole di progetto** | AGENTS.md  | Progetto corrente          | Convenzioni del team, standard del progetto |

**Posizione:**

* Regole utente: `~/.verdent/VERDENT.md`
* Regole di progetto: `<project>/AGENTS.md`

***

## Regole utente (VERDENT.md) [#regole-utente-verdentmd]

Le regole utente ti permettono di personalizzare il comportamento di Verdent in tutti i progetti.

**Accesso:** Settings → User Rules

**Salvataggio automatico:** le modifiche si salvano automaticamente dopo 500ms

<Tabs>
  <Tab title="Scopo">
    * **Preferenze di stile del codice:** indentazione, convenzioni di denominazione
    * **Convenzioni dei framework:** React, Vue, standard del linguaggio
    * **Formattazione delle risposte:** livello di dettaglio, stile delle spiegazioni
    * **Preferenze di flusso di lavoro personali:** tono, stile di comunicazione
  </Tab>

  <Tab title="Esempio">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

***

## Regole di progetto (AGENTS.md) [#regole-di-progetto-agentsmd]

Le regole di progetto definiscono standard specifici del progetto corrente. Salvale nel controllo di versione per condividerle con tutto il team.

**Accesso:** pannello Project Settings

**Posizione:** radice del progetto (`<project>/AGENTS.md`)

<Tabs>
  <Tab title="Casi d'uso">
    * **Convenzioni del team:** standard di codifica condivisi
    * **Architettura:** pattern di progettazione, gestione dello stato
    * **Test:** requisiti di copertura, framework
    * **Flussi di lavoro:** comandi di build, linee guida per le PR
  </Tab>

  <Tab title="Esempio">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
  Condividi AGENTS.md con il tuo team tramite il controllo di versione per garantire un comportamento coerente dell'AI tra tutti i membri del team.
</Tip>

***

## Scrivere regole efficaci [#scrivere-regole-efficaci]

**Sii specifico:**

```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**Buone pratiche:**

* Usa un linguaggio chiaro e direttivo ("Sempre...", "Mai...", "Preferisci...")
* Raggruppa le regole correlate sotto intestazioni di sezione
* Mantieni le regole concise (un concetto per punto)
* Rivedi e aggiorna le regole man mano che il progetto evolve

***

## Domande frequenti [#domande-frequenti]

<AccordionGroup>
  <Accordion title="Come creo i file di regole?">
    Vai su Settings → User Rules per modificare `VERDENT.md` per le preferenze personali. Crea `AGENTS.md` nella radice del progetto per le regole specifiche del progetto. Usa semplice Markdown con elenchi puntati.
  </Accordion>

  <Accordion title="Quando hanno effetto le modifiche alle regole?">
    Le modifiche alle regole si applicano immediatamente nelle nuove conversazioni e influenzano le risposte della conversazione corrente.
  </Accordion>

  <Accordion title="Posso ignorare temporaneamente le regole?">
    Puoi fornire istruzioni specifiche nel tuo prompt per ignorare le regole per una singola richiesta.
  </Accordion>
</AccordionGroup>