Template per ADR in Word
Serve a software architect e tech lead che devono tracciare e motivare le scelte architetturali in modo durevole. Concreto: fornisci la decisione da prendere, le opzioni e i vincoli e ottieni un ADR strutturato (Contesto, Driver, Opzioni con pro/contro, Decisione, Conseguenze, Stato) con tabella comparativa delle alternative, pronto da incollare in Word e mettere sotto versionamento.
Inserisci i tuoi dati: il prompt si completa qui sotto, pronto da copiare.
<role> Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. </role> <task> Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. </task> <context> Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. </context> <output_format> Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. </output_format> <constraints> Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. </constraints> <tone> Professionale, tecnico, neutrale e orientato alla tracciabilita. </tone>
Ruolo: Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. Obiettivo: Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. Contesto: Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. Formato output: Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. Vincoli & regole: Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. Tono & stile: Professionale, tecnico, neutrale e orientato alla tracciabilita.
## Ruolo Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. ## Contesto Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. ## Obiettivo Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. ## Tono & stile Professionale, tecnico, neutrale e orientato alla tracciabilita. ## Formato output Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. ## Vincoli & regole Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni.
## Ruolo Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. ## Obiettivo Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. ## Contesto Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. ## Formato output Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. ## Vincoli & regole Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. ## Tono & stile Professionale, tecnico, neutrale e orientato alla tracciabilita. ## Verbosità Fornisci una risposta completa e dettagliata, coerente con il formato richiesto.
## Ruolo Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. ## Obiettivo Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. ## Contesto Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. ## Formato output Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. ## Vincoli & regole Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. ## Tono & stile Professionale, tecnico, neutrale e orientato alla tracciabilita. ## Verbosità Fornisci una risposta completa e dettagliata, coerente con il formato richiesto.
## Ruolo Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. ## Obiettivo Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. ## Contesto Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. ## Formato output Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. ## Vincoli & regole Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. ## Tono & stile Professionale, tecnico, neutrale e orientato alla tracciabilita. ## Verbosità Fornisci una risposta completa e dettagliata, coerente con il formato richiesto.
Redigi un Architecture Decision Record completo per la decisione indicata: descrivi il contesto e il problema, esplicita i driver decisionali, confronta le opzioni considerate in una tabella e nel dettaglio (pro/contro), motiva la decisione scelta in funzione dei driver ed elenca le conseguenze positive, negative e le assunzioni da validare. Ruolo: Agisci come un software architect senior esperto di documentazione architetturale, valutazione di trade-off tecnici e redazione di Architecture Decision Record (ADR) secondo i template MADR/Nygard. Contesto: Sistema/servizio interessato: [nome sistema e ruolo nell'architettura]. Decisione da prendere: [questione architetturale, es. scelta del data store, pattern di comunicazione]. Driver decisionali e requisiti: [es. scalabilita, latenza target, costo, competenze del team, vincoli normativi]. Opzioni candidate: [elenco delle alternative tecniche da valutare]. Vincoli e contesto attuale: [stack esistente, debito tecnico, scadenze]. Numero ADR e stato: [es. ADR-0007, Proposto]. Formato output: Restituisci un documento Word strutturato a sezioni con heading, pronto da incollare. H1 '1. Stato' (numero ADR, stato Proposto/Accettato/Sostituito, data, autore come ruolo); H1 '2. Contesto' (problema e situazione attuale); H1 '3. Driver decisionali' (elenco puntato dei criteri); H1 '4. Opzioni considerate' con una tabella markdown che incrocia ogni opzione con i driver, seguita da sottosezioni H2 per ciascuna opzione con pro/contro; H1 '5. Decisione' (opzione scelta e motivazione esplicita legata ai driver); H1 '6. Conseguenze' con tre blocchi: positive, negative/debito tecnico, assunzioni da validare. Vincoli & regole: Valuta solo le opzioni fornite; non aggiungerne di tua iniziativa salvo segnalarle separatamente come 'opzione non richiesta'. NON inventare metriche quantitative (latenza, costo, throughput, SLA): dove mancano usa [DA MISURARE] e inseriscile tra le assunzioni. La tabella comparativa deve usare gli stessi driver elencati nella sezione 3. La motivazione della decisione deve riferirsi esplicitamente ai driver, non a preferenze generiche. Massimo 2 pagine. Tutto in italiano. Nessun nome di prodotto commerciale o fornitore inventato oltre a quelli indicati nelle opzioni. Tono & stile: Professionale, tecnico, neutrale e orientato alla tracciabilita.
Esempio di output
ADR-0007: Adozione di un message broker per la comunicazione tra servizi 1. Stato (H1) Proposto - 11/06/2026 - Autore: [ruolo, es. Principal Architect] 2. Contesto (H1) Descrizione del problema architetturale e del sistema attuale. 3. Driver decisionali (H1) - Disaccoppiamento tra [servizio A] e [servizio B] - Resilienza a picchi di carico - Costo operativo sostenibile 4. Opzioni considerate (H1) Tabella comparativa (markdown): Opzione | Disaccoppiamento | Resilienza | Costo gestione | Maturita team A. RabbitMQ | Alto | Alto | Medio | Media B. Kafka | Alto | Molto alto | Alto | Bassa C. Chiamate REST sincrone | Basso | Basso | Basso | Alta 4.1 Opzione A - RabbitMQ Pro: ...; Contro: ... 4.2 Opzione B - Kafka Pro: ...; Contro: ... 5. Decisione (H1) Scegliamo l'Opzione A perche ... (motivazione legata ai driver). 6. Conseguenze (H1) Positive: ...; Negative/debito: ...; Assunzioni da validare: throughput atteso [DA MISURARE].
Domande frequenti
Si: produce la struttura ADR classica (Titolo, Stato, Contesto, Driver decisionali, Opzioni considerate, Decisione, Conseguenze positive/negative) compatibile con i template MADR/Nygard, con numerazione e stato (Proposto/Accettato/Sostituito).
No: usa solo i driver e i vincoli che fornisci. Dove un dato quantitativo (latenza, costo, SLA) non e disponibile lo marca con [DA MISURARE] invece di inventarlo, e lo elenca tra le assunzioni da validare.
Si: produce una tabella comparativa delle opzioni rispetto ai driver decisionali con valutazione esplicita (pro/contro per opzione) e motiva perche l'opzione scelta prevale, senza scartare le altre in modo arbitrario.
Vuoi un prompt su misura?
Costruiscine uno in poche domande — e adattalo a ogni modello.