# Regole di piano (/it/docs/verdent-for-vscode/core-features/plan-rules)

> Personalizza il modo in cui chiarimenti e piani vengono presentati in base al tuo ruolo e al tuo background professionale



Le Regole di piano supportano la fase **Plan** personalizzando il modo in cui Verdent presenta requisiti, chiarimenti e piani di implementazione. Usa i modelli integrati basati sui ruoli come punto di partenza oppure crea regole completamente personalizzate che rispecchino il tuo stile di pensiero e le tue abitudini di lavoro.

### Cosa imparerai [#cosa-imparerai]

* Come le Regole di piano personalizzano la presentazione del piano
* Modelli di ruolo integrati (Frontend, Test, Product Manager)
* Come creare regole di piano personalizzate
* Quando vengono applicate le regole di piano

***

## Cosa possono personalizzare le Regole di piano [#cosa-possono-personalizzare-le-regole-di-piano]

Le Regole di piano controllano come Verdent presenta i piani in Plan Mode:

<Tabs>
  <Tab title="Formato di presentazione">
    * **Riassunto-dettaglio-riassunto** - Sintesi esecutiva all'inizio, passaggi dettagliati al centro, riepilogo dell'impatto alla fine
    * **Diagramma prima** - La rappresentazione visiva guida, il testo fornisce i dettagli di supporto
    * **Tabellare vs narrativo** - Tabelle strutturate per dati facili da consultare, prosa per spiegazioni contestuali
    * **Ordinamento delle sezioni** - Personalizza quali sezioni appaiono per prime e definisci la gerarchia

    <Tip>
      Usa riassunto-dettaglio-riassunto per le revisioni con gli stakeholder, dove conta una comprensione rapida. Usa diagramma prima quando la comprensione architetturale è fondamentale prima di passare all'implementazione.
    </Tip>
  </Tab>

  <Tab title="Livello di dettaglio dei contenuti">
    * **Strategico ad alto livello** - Si concentra su "cosa" e "perché" con dettagli tecnici minimi
    * **Tecnico dettagliato** - Include specifiche di implementazione, pattern di codice, decisioni architetturali
    * **Esempi di codice** - Controlla se il codice appare (includi/escludi, completo vs frammenti, formato diff)
    * **Contenuti di test** - Inclusi per impostazione predefinita nei flussi di lavoro di QA, omessi nei piani orientati al PM

    <Tip>
      Adatta il livello di dettaglio dei contenuti al tuo pubblico. Usa lo strategico ad alto livello per la collaborazione tra team e il tecnico dettagliato quando implementi da solo o con sviluppatori senior.
    </Tip>
  </Tab>

  <Tab title="Elementi visivi">
    * **Diagrammi Mermaid** - Diagrammi di flusso, diagrammi di sequenza, macchine a stati (generati automaticamente o esplicitamente)
    * **Alberi della gerarchia DOM** - Struttura dei componenti in formato ad albero a cartelle
    * **Wireframe** - Mockup dell'interfaccia e schizzi di layout
    * **Tabelle di stile** - Specifiche CSS con celle unite, organizzate per componente

    <Tip>
      I diagrammi Mermaid vengono generati automaticamente dal contenuto del piano quando richiesto. Richiedi esplicitamente tipi di diagramma specifici nelle tue regole di piano se li vuoi per impostazione predefinita.
    </Tip>
  </Tab>

  <Tab title="Comportamenti predefiniti">
    * **Ometti per impostazione predefinita** - Test, stili, compatibilità con le versioni precedenti (riduce la lunghezza del piano)
    * **Elementi obbligatori** - Criteri di accettazione, casi limite, KPI (garantisce la pronta disponibilità per la produzione)
    * **Preferenze di chiarimento** - Più round vs conferma singola vs nessuna conferma

    <Tip>
      Inizia con le omissioni per mantenere i piani concisi, poi aggiungi elementi obbligatori solo per ciò di cui hai davvero bisogno. Puoi sempre richiedere i contenuti omessi in sessioni di piano specifiche.
    </Tip>
  </Tab>

  <Tab title="Specifico per ruolo">
    * **Frontend** - Architettura visiva con diagrammi, alberi DOM, tabelle di stile, omette i test per impostazione predefinita
    * **QA/Test** - Tabelle di casi di test con matrici di copertura, analisi dei valori limite, tracciabilità
    * **Product Manager** - Solo requisiti di business, diagrammi/wireframe, nessun frammento di codice

    <Tip>
      Inizia con un modello di ruolo e personalizza a partire da lì. La maggior parte degli sviluppatori usa i modelli Frontend o QA come base e adatta sezioni specifiche al proprio flusso di lavoro.
    </Tip>
  </Tab>
</Tabs>

***

## Modelli di piano basati sui ruoli [#modelli-di-piano-basati-sui-ruoli]

Verdent offre modelli per ruoli professionali che adattano automaticamente la struttura del piano, il livello di dettaglio dei contenuti e lo stile di presentazione:

<Tabs>
  <Tab title="Frontend">
    **Focus:** Piani di implementazione tecnica con struttura visiva

    **Caratteristiche principali:**

    * Ricerca approfondita nel codebase prima della pianificazione
    * Diagrammi di flusso e di stato Mermaid per i flussi di interazione
    * Gerarchia DOM in formato ad albero a cartelle
    * Tabelle di stile con celle unite per le proprietà CSS
    * **Omette:** contenuti di test e stili per impostazione predefinita (a meno che non vengano richiesti)
    * **Fornisce:** soluzioni definitive senza opzioni multiple

    **Ideale per:** sviluppatori frontend che hanno bisogno di un'architettura visiva e di percorsi di implementazione chiari
  </Tab>

  <Tab title="Test">
    **Focus:** Generazione completa di casi di test e garanzia della qualità

    **Caratteristiche principali:**

    * Progettazione dei test orientata agli obiettivi (logica di business, sicurezza, stabilità)
    * Casi di test strutturati con tabelle Markdown a 9 colonne
    * Classi di equivalenza, valori limite e parametri chiave
    * Copertura completa: casi normali, alternativi, di eccezione e limite
    * Focus sull'eseguibilità con supporto all'automazione
    * Tracciabilità rispetto ai punti dei requisiti

    **Ideale per:** ingegneri QA e specialisti dell'automazione dei test che necessitano di una copertura di test sistematica
  </Tab>

  <Tab title="Product Manager (PM)">
    **Focus:** Requisiti di prodotto dal punto di vista del business

    **Caratteristiche principali:**

    * **Nessun frammento di codice o implementazione tecnica**
    * Si concentra su **cosa** e **perché**, non su **come**
    * Diagrammi di sequenza, diagrammi di flusso e wireframe
    * Elenchi di requisiti con priorità e confronti Before/After
    * Casi limite con strategie di gestione
    * Specifiche dei dati con KPI e tracciamento degli eventi

    **Ideale per:** product manager che definiscono i requisiti di business senza contaminazione tecnica
  </Tab>
</Tabs>

***

## Regole di piano personalizzate [#regole-di-piano-personalizzate]

Crea regole di piano personalizzate definendo:

**Componenti della regola:**

* **Stile di presentazione** - Formato riassunto-dettaglio-riassunto, diagramma prima o tabellare
* **Livello di dettaglio dei contenuti** - Panoramica ad alto livello vs implementazione dettagliata
* **Omissioni** - Cosa escludere per impostazione predefinita (test, stili, compatibilità con le versioni precedenti)
* **Elementi obbligatori** - Sezioni indispensabili (diagrammi, criteri di accettazione, specifiche dei dati)
* **Preferenze di interazione** - Approccio ai chiarimenti, requisiti di conferma

<Tip>
  In Plan Mode, seleziona il pulsante **Plan Rules** nella casella di input per accedere rapidamente alle tue regole di piano e modificarle.
</Tip>

**Applicazione delle regole:**

* Si applica a tutte le sessioni Plan Mode
* Persiste tra le sessioni del workspace
* Può essere sovrascritta con direttive inline
* Funziona con sottoagenti personalizzati

**Scopri di più:** Crea o modifica `Plan.md` nel tuo workspace per definire regole di piano personalizzate in formato Markdown.

***

## Vedi anche [#vedi-anche]

<CardGroup cols="3">
  <Card title="Piano professionale" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    Trasforma le idee in piani di implementazione
  </Card>

  <Card title="Ciclo di chiarimento" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    Perfezionamento interattivo dei requisiti
  </Card>
</CardGroup>
