ADR-XXXX: Short, descriptive title
Date: DD-MM-YYYYAuthor(s): Names or handles
Status
Proposed | Accepted | Deprecated | Superseded by ADR-XXXX
Context
Describe the context and problem statement objectively. What is the issue we are facing? What are the business requirements, technical constraints, budget limits, or historical factors driving the need for a decision?
Decision
State the actual decision clearly and definitively. What are we going to do? E.g., "We will use...", "We will build...", "We are migrating to..."
Consequences
List the resulting trade-offs of this decision. Be honest about both the good and the bad.
Positive
- e.g., Simplifies the deployment process
- e.g., Reduces database read load
Negative
- e.g., Introduces a new third-party dependency to monitor
- e.g., Requires migrating legacy data to the new schema