Verdent Docs
Funzionalità principali

Regole di piano

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

  • 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

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

  • 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

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.

  • 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

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.

  • 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

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.

  • 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

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.

  • 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

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.


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:

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

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

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


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

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

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