Sviluppo & Tech Word Avanzato

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.

#adr #architettura #decisioni #trade-off #governance
Claude · Anthropic
<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>
DeepSeek · DeepSeek
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.
Gemini · Google
## 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.
Grok · xAI
## 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.
Mistral · Mistral AI
## 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.
ChatGPT · OpenAI
## 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.
Perplexity · Perplexity
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

Segue un formato ADR riconosciuto?

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).

Inventa requisiti o numeri di performance?

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.

Confronta davvero le alternative?

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.

Crea il tuo prompt