# Sviluppo guidato dalle specifiche per agenti IA

Canonical: https://specscore.md/it/spec-driven-development/

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.

Ultimo aggiornamento: 30 ottobre 2026

## 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 di**requisiti**, ciascuno con **criteri di accettazione**espliciti 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, consulta[le pagine di confronto](/it/vs/).

Vedi anche i confronti con [Kiro](/it/vs/kiro/), [Tessl](/it/vs/tessl/), [BMAD Method](/it/vs/bmad-method/), [Task Master AI](/it/vs/task-master-ai/).

Per gli strumenti nel loro insieme — GitHub Spec Kit, OpenSpec, Kiro e gli altri — vedi[i migliori strumenti di sviluppo guidato dalle specifiche nel 2026](/it/spec-driven-development/tools/).

Per scrivere criteri di accettazione che un agente IA possa verificare, vedi[come scrivere i criteri di accettazione](/it/articles/acceptance-criteria/).

I modelli di frase EARS usati dai requisiti di Kiro sono spiegati in [sintassi dei requisiti EARS](/it/articles/ears-requirements/).

Per eseguire quel linter di specifiche nell’integrazione continua, vedi [fare il lint delle specifiche in CI](/it/articles/lint-specs-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](/it/articles/feature-spec-template/).

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](/it/articles/claude-code-specs/).

## 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](https://github.com/specscore/specscore).

Inizia con le [Skill IA per il tuo agente di programmazione](/it/ai/) o[installa la CLI](/it/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](https://github.com/specscore/specscore).

Con quale licenza è distribuito SpecScore?

La specifica e la documentazione nel repository pubblico [specscore/specscore](https://github.com/specscore/specscore) sono [CC BY 4.0](https://github.com/specscore/specscore/blob/main/LICENSE). L'interfaccia a riga di comando (CLI) di riferimento in [specscore/specscore-cli](https://github.com/specscore/specscore-cli) è [Apache-2.0](https://github.com/specscore/specscore-cli/blob/main/LICENSE).

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/](/it/cli/install/), oppure parti dalle [AI Skills](/it/ai/). Il binario della CLI è pubblicato da [specscore/specscore-cli](https://github.com/specscore/specscore-cli).