Sviluppo guidato dalle specifiche per agenti IA
SpecScore è un formato di file aperto e verificabile con un linter per le specifiche, scritto in Markdown e YAML (YAML Ain't Markup Language), con un'interfaccia a riga di comando (CLI) che le controlla. Lo sviluppo guidato dalle specifiche (SDD) è una metodologia in cui una specifica scritta e verificabile — requisiti e criteri di accettazione — funge da fonte di verità rispetto alla quale il codice viene costruito e verificato. Invece di passare direttamente da un prompt o un ticket al codice, si concorda prima cosa deve fare il software e poi si costruisce in base a tale specifica. Ora che gli agenti IA scrivono gran parte del codice, la specifica è ciò che assicura che costruiscano la cosa giusta.
- La specifica è la fonte di verità; il codice ne deriva e viene verificato a fronte di essa.
- I requisiti sono accompagnati da criteri di accettazione espliciti, così "fatto" è verificabile, non soggettivo.
- Gli agenti IA interrogano la specifica per comprendere l'intento anziché tirarlo a indovinare dal codice — meno codice errato.
- È complementare allo sviluppo guidato dai test (TDD), non un sostituto.
Cos'è lo sviluppo guidato dalle specifiche?
L'approccio ribalta il consueto ordine di lavoro. Anziché considerare la specifica come documentazione scritta a posteriori — o saltarla del tutto — l'SDD rende la specifica l'artefatto primario. Codice, test e revisioni fanno tutti riferimento ad essa.
Una specifica in questo senso non è un muro di testo. È strutturata: un insieme direquisiti, ciascuno con criteri di accettazioneespliciti che indicano, in termini verificabili, cosa deve essere vero affinché il requisito sia considerato soddisfatto. Questa struttura è ciò che permette a un revisore, a una suite di test e a un agente IA di interpretare lo stesso documento nello stesso identico modo.
La specifica è inoltre un artefatto vivente. Quando i requisiti cambiano, la specifica cambia per prima e il codice segue di conseguenza — così la specifica non diventa mai finzione.
Perché è fondamentale adesso: l'IA ha alzato la posta
Gli agenti IA di programmazione generano codice molto più velocemente di quanto un essere umano possa leggerlo. Questo sposta il collo di bottiglia. La parte difficile non è più scrivere l'implementazione — èspecificare l'intento con sufficiente chiarezza affinché il codice generato sia effettivamente quello desiderato. Un agente a cui viene fornito un prompt vago produrrà inevitabilmente qualcosa di plausibile ma errato, alla velocità della macchina.
La specifica è il guardrail. Quando il comportamento atteso e i criteri di accettazione sono messi per iscritto, l'agente ha un obiettivo chiaro verso cui costruire e una checklist con cui verificare — e un revisore umano ha un punto fermo da approvare prima ancora che esista una sola riga di codice. L'SDD è il modo con cui i team evitano che la velocità dell'IA si trasformi in ore di correzioni e rilavorazioni.
Come funziona lo sviluppo guidato dalle specifiche
Il flusso di lavoro è un ciclo, non un documento statico:
- Cattura l'intento. Registra la direzione iniziale — il problema, l'obiettivo, le domande aperte — prima di impegnarti in una soluzione.
- Specifica il comportamento. Trasforma la direzione concordata in requisiti, ciascuno con criteri di accettazione espliciti e verificabili.
- Scomponi in un piano. Suddividi la specifica in task ordinati, ciascuno citando i criteri di accettazione che soddisfa.
- Implementa. Costruisci task per task — un essere umano o un agente IA — in base alla specifica.
- Verifica rispetto ai criteri. Controlla il risultato rispetto ai criteri di accettazione, non in base all'intuito.
- Mantieni viva la specifica. Quando i requisiti cambiano, aggiorna prima la specifica; il codice seguirà.
Vantaggi dello sviluppo guidato dalle specifiche
- I disaccordi emergono durante la revisione della specifica — costo minimo — anziché dopo l'implementazione — costo elevato.
- "Fatto" è un concetto oggettivo, perché i criteri di accettazione sono verificabili con test.
- La specifica è il contesto condiviso per tutti: prodotto, ingegneria e agenti IA.
- I cambiamenti sono tracciabili — ogni task fa riferimento ai criteri che soddisfa.
Perché aiuta specificamente gli agenti IA
- Intento leggibile dalla macchina: l'agente legge direttamente i requisiti anziché dedurli dal codice.
- Meno contesto da caricare: l'agente interroga la sezione rilevante della specifica anziché l'intero repository.
- Output verificabile: i criteri di accettazione offrono all'agente un obiettivo concreto di successo/fallimento.
- Tracciabilità: il codice generato può essere ricollegato al requisito che lo ha originato.
Sviluppo guidato dalle specifiche a confronto con altre pratiche
| Pratica | Fonte di verità | Relazione con l'SDD |
|---|---|---|
| Sviluppo guidato dai test (TDD) | Test a livello di codice che falliscono | Complementare — i criteri di accettazione diventano i test. |
| PRD tradizionale | Prosa scritta per esseri umani | Meno strutturato; non direttamente verificabile con test né leggibile da macchine. |
| Solo prompt ("vibe coding") | Il prompt e le congetture del modello | Nessun obiettivo duraturo e revisionabile — ciò che l'SDD è nato per risolvere. |
Per un confronto dettagliato tra SpecScore e altri strumenti per specifiche, consultale pagine di confronto.
Vedi anche i confronti con Kiro, Tessl, BMAD Method, Task Master AI.
Per gli strumenti nel loro insieme — GitHub Spec Kit, OpenSpec, Kiro e gli altri — vedii migliori strumenti di sviluppo guidato dalle specifiche nel 2026.
Per scrivere criteri di accettazione che un agente IA possa verificare, vedicome scrivere i criteri di accettazione.
I modelli di frase EARS usati dai requisiti di Kiro sono spiegati in sintassi dei requisiti EARS.
Per eseguire quel linter di specifiche nell’integrazione continua, vedi fare il lint delle specifiche in CI.
Per un modello di specifica di funzionalità in Markdown — un documento di requisiti di prodotto (PRD) con requisiti, criteri di accettazione, un piano e task — vedi modello di PRD in Markdown.
Per lo sviluppo guidato dalle specifiche con Claude Code e Cursor — cosa va nel file di funzionalità, cosa scrive specscore agent setup e come specscore spec lint gira nel ciclo e in CI — vedi sviluppo guidato dalle specifiche con Claude Code e Cursor.
Compromessi e quando non usarlo
Lo sviluppo guidato dalle specifiche non è gratuito. Sposta l'impegno a monte nel pensare e scrivere prima che qualsiasi codice venga eseguito, il che è una scelta errata per uno script usa-e-getta o un esperimento rapido. E una specifica è utile solo se viene mantenuta aggiornata — una specifica abbandonata diventa fuorviante, peggiore di nessuna specifica. L'SDD ripaga l'investimento quando il lavoro è abbastanza ampio da richiedere pianificazione, deve essere mantenuto nel tempo, o viene affidato a un agente IA per la costruzione su larga scala.
Praticare lo sviluppo guidato dalle specifiche con agenti IA
Per fare SDD con agenti IA servono due cose: un formato di specifica leggibile dalla macchina che sia il tuo team che i tuoi agenti comprendano, e un modo per consentire agli agenti di leggere, scrivere e convalidare tali specifiche.
SpecScore è un'implementazione mirata esattamente a questo. È un formato aperto Markdown + YAML per feature, requisiti e criteri di accettazione — semplici file nel tuo repository — affiancato da una CLI che i tuoi agenti invocano per interrogarli, modificarli ed eseguirne il lint. Poiché la struttura è leggibile dalla macchina, un agente può chiedere "su cosa dovrei lavorare adesso?" e ricevere i requisiti aperti con i rispettivi criteri di accettazione, per poi verificare il proprio lavoro a fronte di essi. È indipendente dagli strumenti e open source.
Inizia con le Skill IA per il tuo agente di programmazione oinstalla la CLI.
Domande frequenti
Lo sviluppo guidato dalle specifiche è la stessa cosa dello sviluppo guidato dai test (TDD)?
No. Il TDD guida l'implementazione partendo da test che falliscono, a livello di codice. Lo sviluppo guidato dalle specifiche opera a un livello superiore: fissa prima il comportamento previsto e i criteri di accettazione in una specifica scritta. Sono complementari — i criteri di accettazione di una specifica diventano spesso i test che guidano il TDD.
Lo sviluppo guidato dalle specifiche ti rallenta?
Aggiunge tempo prima di scrivere codice ed elimina il tempo sprecato a rifare ciò che era sbagliato. Per script usa-e-getta il costo non conviene. Per qualsiasi cosa generata su larga scala da un agente IA, o che un team debba mantenere, scrivere prima la specifica è quasi sempre più veloce dall'inizio alla fine.
Qual è la differenza tra una specifica e un PRD?
Un PRD è in genere prosa discorsiva per persone. Una specifica nello sviluppo guidato dalle specifiche è strutturata e verificabile con test — requisiti discreti con criteri di accettazione espliciti — in modo che sia i revisori umani sia gli agenti IA possano operare su di essa con precisione.
Come utilizzano una specifica gli agenti di programmazione IA?
Quando la specifica è leggibile dalla macchina, l'agente la interroga per ottenere i requisiti e i criteri di accettazione rilevanti per il suo task corrente invece di caricare l'intero codebase, e poi confronta il proprio risultato con tali criteri — una salvaguardia contro codice plausibile ma errato.
Che cos'è SpecScore?
SpecScore è un formato di file aperto e lintabile per le specifiche, scritto in Markdown e YAML, con un'interfaccia a riga di comando (CLI) che le interroga, modifica e linta. Il formato è nel repository pubblico specscore/specscore.
Con quale licenza è distribuito SpecScore?
La specifica e la documentazione nel repository pubblico specscore/specscore sono CC BY 4.0. L'interfaccia a riga di comando (CLI) di riferimento in specscore/specscore-cli è Apache-2.0.
Lo sviluppo guidato dalle specifiche richiede un fornitore di IA?
No. Le specifiche sono file di testo nel repository. La CLI è un binario locale. Le AI Skills di questo sito avvolgono quella CLI per gli agenti che possono eseguire skill. Il formato non richiede un fornitore.
Come installo la CLI?
Segui /it/cli/install/, oppure parti dalle AI Skills. Il binario della CLI è pubblicato da specscore/specscore-cli.