Decision Record Template

Copy this file into your docs/architecture/decisions/ directory, rename it with a sequential number (for example, 003-use-postgresql.md), and fill in every section.

Field	Value
title	[Short, descriptive title for the decision]
status	proposed
impact	low / medium / high
Driver	[Name and role of the person driving the decision]
Approver	[Name and role of the person with approval authority]
created	[YYYY-MM-DD]
Outcome	[Fill in once resolved: Accepted, Rejected, or Deferred]

Context and Problem Statement

Describe the situation that prompted this decision. What is the problem, and why does it need to be addressed now? Include any relevant background that a reader would need to understand the decision without further context.

Decision Drivers

List the key factors that influenced this decision. These might include technical constraints, business requirements, team capabilities, cost, or timeline pressures.

[Driver one]
[Driver two]
[Driver three]

Considered Options

List every option that was seriously evaluated. For each one, include a brief description and note the main advantages and disadvantages.

Option 1: [Name]

Pros: [List advantages.]
Cons: [List disadvantages.]

Option 2: [Name]

Pros: [List advantages.]
Cons: [List disadvantages.]

Option 3: [Name]

Pros: [List advantages.]
Cons: [List disadvantages.]

Decision Outcome

State the chosen option clearly and explain why it was selected over the alternatives. Include any immediate actions that must be taken as a result.

Chosen option: [Option name]

Reason: [Brief justification.]

Consequences

Describe what this decision means in practice -- both the benefits and the trade-offs. Be specific about any risks.

Positive

[Positive consequence]
[Positive consequence]

Negative

[Negative consequence or risk]
[Negative consequence or risk]