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

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

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)

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

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

# 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

Regole di progetto (AGENTS.md)

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)

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

# 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

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.

Scrivere regole efficaci

Sii specifico:

# 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

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.

Quando hanno effetto le modifiche alle regole?

Le modifiche alle regole si applicano immediatamente nelle nuove conversazioni e influenzano le risposte della conversazione corrente.

Posso ignorare temporaneamente le regole?

Puoi fornire istruzioni specifiche nel tuo prompt per ignorare le regole per una singola richiesta.

View as Markdown