Title, e.g. name of the feature

Why-statement: In the context of [use case/user story], facing [concern], we decided to [do thing X] to achieve [system qualities/desired consequences]. We considered [thing Y] and accept [downsides / undesired consequences].

Context

What is motivating this decision or change? Describe the context and problem statement, in free form.

You might want to add a list of drivers, forces, concerns

• [driver 1, e.g., a force, facing concern, ...]
• [driver 2, e.g., a force, facing concern, ...]

Decision

What is the change that we're proposing and/or doing?

We chose option X because [justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force force | ... | comes out best (see below)].

Consequences

What it now easier to do? What becomes more difficult with this change?

Describe the positive (e.g., improvement of quality attribute satisfaction, follow-up decisions required, ...) as well as the negative (e.g., compromising quality attribute, follow-up decisions required, ...) outcomes of this decision.

Alternatives considered

Alternative 1

example | description | pointer to more information

• Good, because ...
• Bad, because ...
• ...

Alternative 2

example | description | pointer to more information

• Good, because ...
• Bad, because ...
• ...

References

If it helps, add references e.g. to issues and/or other planning documents.