Skip to content

ADR-[NUMBER]: [Decision Title] ​

Status: Completed/Superseded
Date: [YYYY-MM-DD]
Deciders: [List of decision makers]
Consulted: [List of people consulted]
Informed: [List of people informed]

Context ​

What is the issue that we're seeing that is motivating this decision or change?

Decision ​

What is the change that we're proposing or have agreed to implement?

Rationale ​

Why did we choose this option over alternatives?

Consequences ​

What becomes easier or more difficult to do and any risks introduced by this change?

Positive Consequences ​

Negative Consequences ​

Neutral Consequences ​

Implementation ​

How will this decision be implemented?

  • [ ] Code changes required
  • [ ] Documentation updates
  • [ ] Team training
  • [ ] Process changes

Alternatives Considered ​

Alternative 1: [Name] ​

  • Description:
  • Pros:
  • Cons:
  • Reason for rejection:

Alternative 2: [Name] ​

  • Description:
  • Pros:
  • Cons:
  • Reason for rejection:
  • REQ-XXX: Requirement Name (add links as needed)
  • SPEC-XXX: Specification Name (add links as needed)
  • ADR-XXX: Previous Decision (add links as needed)

References ​

  • External documentation
  • Industry standards
  • Research papers

Template Usage: Copy this template to decisions root: adr-[number]-[kebab-case-title].md

Frontmatter: Update domain and tags for categorisation instead of using folders.

Internal use only