Team practice

Decisions that keep their context

Decisions that keep their context

Decisions that keep their context

A short decision record can be more useful than a long trail of updates.

2 min read

Decision context — illustrative fictional Meridian interface

Capture the question

A decision makes more sense when the original question is visible. Summarize the choice that needed to be made, the people affected and the constraints that mattered at the time. A reader should not have to reconstruct the whole conversation to understand why the team moved in a particular direction.


Record the reason

Write the selected approach and the practical reason for choosing it. Include the important trade-off, especially when another option might look attractive later. Keep the record proportionate: a sentence or two can be enough for a small choice. Link to the supporting material rather than copying the same explanation into several places.


Know when to revisit it

Some decisions are provisional. State what would cause the team to reconsider the choice: new research, a changed requirement or a constraint being removed. Name the person who will notice that trigger and the place where an updated decision will be recorded.


Compare options somebody could choose

A useful comparison does not need to include every imaginable option. For a review workflow, the choice might be between requiring an owner immediately or allowing a request to enter a short triage queue first. Both approaches can be described plainly. Explain which problem each one addresses and what it makes harder. That gives the selected approach a reason that can still be understood after the original conversation is forgotten.

Separate an observation from a preference

An observed behavior and a preferred style are different kinds of input. A reader failing to find the next action can support a change in hierarchy. A preference for a particular layout may still be worth discussing, but it should not be presented as the same evidence. A concise decision note can state both without pretending the choice was determined by data that was never collected.

Record the condition, not a permanent verdict

A choice can fit the present constraint without being the only sensible answer forever. Write the condition that makes the approach appropriate and a practical trigger for reviewing it. A changed audience, an additional reviewer or a removed dependency might be enough. The next discussion can then begin with what changed, instead of treating a return to the question as proof that the earlier decision was careless.

Create a free website with Framer, the website builder loved by startups, designers and agencies.