~linuxgoose/engineering-templates

f97ba688267c4dfe53620b9cf9dc15a2006f36c9 — Jordan Robinson 3 months ago 9ea8624
add architecture decision record template
2 files changed, 67 insertions(+), 0 deletions(-)

M README.md
A templates/architecture-decision-record.md
M README.md => README.md +1 -0
@@ 7,3 7,4 @@ Comprehensive collection of templates for solutions design, architecture decisio
* Feature Request
* Bug Fix
* Performance Optimisation
* Architecture Decision Record (ADR)

A templates/architecture-decision-record.md => templates/architecture-decision-record.md +66 -0
@@ 0,0 1,66 @@
# Architecture Decision Record (ADR)

## Header
**ADR Number:** [ADR-XXX]  
**Title:** [Brief title of architectural decision]  
**Status:** [Proposed/Accepted/Deprecated/Superseded by ADR-XXX]  
**Date:** [Created date]  
**Last Updated:** [Date]  
**Author:** [Name]  
**Stakeholders:** [List of stakeholders involved]

## Context
Describe the issue or problem that motivated this decision. What circumstances made this decision necessary? Include relevant background, constraints, and business drivers.

## Decision
State the architectural decision clearly and concisely. What exactly are we deciding to do?

## Rationale
Explain why this decision was made:
- Why this approach over alternatives
- How it addresses the context/problem
- Technical and business justifications
- Long-term implications

## Alternatives Considered
List other options evaluated:

**Alternative 1: [Name]**
- Pros
- Cons
- Why not chosen

**Alternative 2: [Name]**
- Pros
- Cons
- Why not chosen

## Consequences

### Positive
- Benefits of this decision
- What improves

### Negative
- Trade-offs and compromises
- Future constraints
- Maintenance burden

### Neutral
- No significant impact areas

## Implementation Notes
- How will this be implemented?
- Which teams are responsible?
- Timeline considerations
- Dependencies

## Related ADRs
- References to related decisions
- Supersedes (if applicable)
- Is superseded by (if applicable)

## References
- Links to relevant documentation
- External resources
- Design documents
\ No newline at end of file