Una decisione tecnica dimenticata torna spesso come domanda, dubbio o modifica rischiosa. Documentarla non richiede un documento lungo: richiede il contesto essenziale.
Scrivi il problema prima della soluzione
Spiega quale vincolo, rischio o necessità ha portato alla scelta. Senza questo passaggio, chi legge in futuro vede solo una tecnologia e non sa se la decisione sia ancora valida.
Registra alternative e conseguenze
Due o tre opzioni considerate, la scelta fatta e ciò che comporta sono sufficienti. L’obiettivo è rendere la decisione discutibile, non immutabile.
Tieni la nota vicino al lavoro
Una decisione è utile se il team la trova quando serve: accanto al repository, alla documentazione del prodotto o al progetto in corso.