Write down why, while you still know.
Architecture Decision Records, popularised by Michael Nygard, capture a decision's context and consequences in about a page. Memory fades fast; records don't. Delivery practice for these lives in Agile & Delivery.
Context
What Was True Then
- The problem and the constraints
- The forces pulling different ways
Decision
What We Chose
- Stated plainly
- Including the options rejected
Consequences
What Follows
- Good, bad and neutral
- What becomes easier or harder
Status
Still True?
- Proposed, accepted or superseded
- Linked to what replaced it
Source: Cognitect ↗
Write down why, while you still know.