Elk project verzamelt beslissingen: waarom een bepaalde database, waarom deze API-vorm of waarom een prestatiecompromis aanvaardbaar was. Zonder verslag betaalt het volgende team om de context opnieuw te ontdekken.
Ons formaat blijft bewust klein. Eén kort document beschrijft context, afgewezen opties, reden en bekende gevolgen. Het is gedateerd, heeft een eigenaar en blijft beperkt tot twee pagina’s.
Het voordeel verschijnt snel. Nieuwe teamleden begrijpen het product in dagen in plaats van weken. Een leverancierswissel wordt minder riskant en de klant blijft niet afhankelijk van één persoon of van ons.
Beslissingsdocumenten verouderen samen met de code. Een achterhaalde keuze wordt gemarkeerd en gekoppeld aan haar vervanger. De geschiedenis blijft zichtbaar zonder te doen alsof de oorspronkelijke context nooit bestond.
Het is een stille discipline die kwetsbare software verandert in een product dat een ander team veilig kan beheren en verder ontwikkelen.
