# ADR Template - Copy This File to Create New ADRs Copy this file and rename to `NNN-short-title.md` where NNN is the next sequential number. --- ```yaml --- id: NNN title: Short, descriptive title of the decision date: YYYY-MM-DD author(s): Your Name status: Proposed | Accepted | Deprecated | Superseded by ADR-XXX principles: [List relevant principles from PRINCIPLES.md] related: - doc: Link to related documentation - adr: Link to related ADRs - ticket: Link to related issue/ticket --- ``` ## Context Describe the issue or problem that motivated this decision. Include: - What is the problem? - Why does it matter? - What constraints or requirements are we working under? - What alternatives were considered and why were they rejected? ## Decision State the decision clearly and concisely. - What did we decide to do? - Why this specific approach? Include implementation details if relevant: ```python # Example code or pseudocode here ``` ## Consequences Describe the implications of this decision. **Positive:** - List expected benefits - List advantages **Negative:** - List trade-offs - List expected costs ## Related Principles How does this decision support or reinforce the DSS Core Principles? - [Principle Name]: Explain connection - [Principle Name]: Explain connection