Skip to main content

[NUMBER]. [Title]

Date: YYYY-MM-DD Status: Proposed | Accepted | Deprecated | Superseded by [ADR-XXXX] Deciders: [List of people involved in the decision] Tags: [e.g., architecture, security, infrastructure, dependencies]

Context​

[Describe the issue, problem, or opportunity that requires a decision. Include:]

  • What forces are at play (technical, business, organizational)?
  • What constraints exist?
  • Why is this decision important?

Decision​

[Describe the decision that was made. Use active voice: "We will..."]

Alternatives Considered​

Option 1: [Name]​

Pros:

  • [Advantage 1]
  • [Advantage 2]

Cons:

  • [Disadvantage 1]
  • [Disadvantage 2]

Option 2: [Name]​

Pros:

  • [Advantage 1]

Cons:

  • [Disadvantage 1]

Decision Rationale​

[Explain why the chosen option was selected over the alternatives]

Consequences​

Positive​

  • [What becomes easier]
  • [What benefits we gain]

Negative​

  • [What becomes harder]
  • [What we lose]

Neutral​

  • [Changes that are neither clearly positive nor negative]

Implementation Notes​

[Optional: Specific guidance for implementing this decision]

  • [ADR-XXXX]: [Brief description of relationship]
  • [ADR-YYYY]: [Brief description of relationship]

References​

  • [Link to relevant documentation]
  • [Link to discussion threads]
  • [Link to external resources]