Capture Both Logic and Sentiment in Decisions

Capture Both Logic and Sentiment in Decisions

Augment formal decision records, like ADRs, with qualitative data about the human element. Include fields for the team's sentiment, confidence level, or readiness to commit to the decision. This provides crucial context for future reviews and helps gauge the true...
Capture Both Logic and Sentiment in Decisions

Treat Decisions as Immutable Historical Records

Document each decision as a distinct, immutable record, such as an Architectural Decision Record (ADR). A subsequent choice that alters a previous one should be a new, separate record that explicitly supersedes the original. This maintains a clear historical log and...
Capture Both Logic and Sentiment in Decisions

Write Down Decisions Early and Often

Context Rather than writing a decision record after a decision has already been made, which can feel bureaucratic and less useful, teams should start the document early in the decision-making process. This makes the process more useful and collaborative. The ADR...