[NUMBER]. [SHORT TITLE]
Date: YYYY-MM-DD
Status
[Proposed | Accepted | Deprecated | Superseded by TDR-XXXX]
Context
What is the issue we’re trying to address? What are the current challenges or pain points? Describe the team, workflow, or process forces at play.
Include relevant background:
- What’s the current situation?
- Why is this decision needed now?
- What problems are we trying to solve?
- What constraints or requirements exist?
Decision
What is the team decision? Use active voice.
Be specific and actionable:
- Who is responsible?
- What actions will be taken?
- When/how often will this happen?
- What tools or resources are needed?
- What are the concrete steps?
Consequences
What are the positive, negative, and neutral impacts of this decision?
Positive
- How does this improve our workflow?
- What problems does this solve?
- What new capabilities do we gain?
Negative
- What new overhead or complexity is introduced?
- What are the tradeoffs?
- What risks should we be aware of?
Neutral
- What existing practices will change?
- How does this relate to other team processes?
- What needs to be communicated to the broader team?
Review Schedule (Optional)
When should this decision be reviewed or revisited?
Examples:
- “Review quarterly”
- “Review after 3 sprints”
- “Review in 6 months”
- “Review when team size changes significantly”
Related Decisions (Optional)
List any TDRs that this decision builds upon or relates to. Link to older TDRs only.
Examples: