Architecture Decision Records
ADR template
Context
What problem and constraints exist?
Decision
What architecture was selected?
Alternatives
What credible alternatives were considered?
Consequences
What improves and what becomes harder?
Evidence
Which tests, benchmarks, product capabilities, or business requirements support the decision?
Revisit trigger
What future condition would cause the decision to be reconsidered?
Mandatory ADRs
Your capstone should create ADRs for at least:
- space topology
- integration pattern
- persistence strategy
- semantic ownership
- security model
- data product strategy
- migration strategy
- resilience
- capacity
- operating model
Architect test
If an ADR cannot explain why an alternative was rejected, it is probably a configuration note rather than an architecture decision.