Specifiche
La scheda Specifiche raccoglie le specifiche di sviluppo — descrizioni normalizzate e versionate di uno sviluppo da cui lavorano sia l'agente sia le persone del team. Una specifica è la fonte di verità condivisa per un pezzo di lavoro: cosa si sta costruendo, perché e secondo quali regole. Le specifiche sono prodotte dal ruolo Specifica nella Chat — vedi Ruoli Developer.
A cosa serve una specifica#
Una specifica trasforma un requisito vago in una descrizione normalizzata e versionata contro cui l'agente può implementare e che un umano può esaminare. Ogni specifica è una famiglia con uno spec_id stabile che resta lo stesso in ogni versione — così, man mano che la specifica evolve, la sua cronologia è un unico filo continuo e i link a essa non si rompono mai. Quando affidi all'agente una specifica da implementare (anche in Modalità autonoma), lavora a partire da quella definizione stabile e versionata invece che da un singolo messaggio di chat.
L'elenco delle specifiche#
Il lato sinistro elenca le tue famiglie di specifiche. Ogni voce mostra:
- Il titolo della specifica.
- Un badge di stato.
- v{version} — la versione corrente.
- {n} versioni — quante versioni esistono.
Quando un progetto non ha ancora specifiche, l'elenco mostra:
Ancora nessuna specifica — usa il ruolo Specifica nella Chat per crearne una.
Scegli una famiglia a sinistra per aprirla.
La vista della famiglia#
Aprendo una famiglia si mostrano tre sotto-schede:
| Sotto-scheda | Cosa mostra | Quando è disponibile |
|---|---|---|
| Corrente | La versione corrente, resa da Markdown | Sempre |
| Versioni (N) | Ogni versione, con i riepiloghi delle modifiche per versione | Sempre |
| Confronta | Un diff affiancato tra due versioni | Solo con 2 o più versioni (altrimenti disabilitato) |
Corrente#
La sotto-scheda Corrente rende l'ultima versione della specifica come Markdown formattato. Gli amministratori dispongono di controlli per gestire la specifica:
| Controllo | Cosa fa |
|---|---|
| Modifica | Apre la versione corrente per la modifica. |
| Salva | Salva le tue modifiche. |
| Annulla | Scarta le tue modifiche ed esce dalla modalità di modifica. |
| Rinomina famiglia | Cambia il titolo della specifica. Lo spec_id resta lo stesso. |
| Elimina | Elimina l'intera famiglia e tutte le sue versioni. |
Elimina rimuove l'intera famiglia di specifiche — ogni versione, non solo quella corrente. Non c'è eliminazione per versione; è tutto-o-niente.
Versioni (N)#
La sotto-scheda Versioni mostra l'intera cronologia:
- Una barra delle versioni che elenca ogni versione per tag. Una versione che ha un riepilogo delle modifiche è contrassegnata con un puntino.
- Un riquadro «Modifiche in v{v}» che descrive cosa è cambiato nella versione selezionata.
- Il contenuto della versione selezionata.
Usala per leggere qualsiasi versione passata esattamente com'era e per vedere il racconto di come la specifica è evoluta.
Confronta#
La sotto-scheda Confronta mostra un diff tra due versioni qualsiasi. Servono almeno due versioni perché sia disponibile.
| Controllo | Cosa fa |
|---|---|
| Da | Seleziona la versione base da cui confrontare. |
| A | Seleziona la versione con cui confrontare. |
| Vista diff | Mostra aggiunte e rimozioni con una guida + / −. |
| Riquadro «Cosa è cambiato» | Un riepilogo delle differenze tra le due versioni selezionate. |
Come vengono create le specifiche#
Non scrivi le specifiche a mano da zero qui — le generi con il ruolo Specifica nella Chat. Descrivi il requisito all'agente in quel ruolo ed esso produce una specifica normalizzata, che poi compare come famiglia in questa scheda. Gli amministratori possono raffinarla in seguito con Modifica / Salva, e ogni modifica significativa diventa una nuova versione con il proprio riepilogo delle modifiche.
Dove andare dopo#
- Ruoli Developer — incluso il ruolo Specifica che produce le specifiche.
- Chat — dove scegli un ruolo e crei una specifica.
- Modalità autonoma — affida all'agente una specifica e lascialo lavorare senza supervisione.
- Metodologia — le regole e la conoscenza che l'agente applica mentre implementa una specifica.