ADR-XXXX Title Placeholder
⚠️ INTERNAL ONLY — Architecture Decision Governance
Not intended for public distribution.
When to Raise an ADR
Section titled “When to Raise an ADR”Create an ADR for any change that affects platform architecture boundaries, security posture, deployment models, compliance obligations, data classification, or operational guardrails. Use this template before implementing the change so stakeholders can review the proposal asynchronously.
Status
Section titled “Status”Describe the current state of this decision: Proposed, Accepted, Rejected, or Superseded.
Context
Section titled “Context”Detail the problem statement, constraints, and forces driving the decision.
Decision
Section titled “Decision”Summarize the chosen path as a clear, affirmative statement.
Rationale
Section titled “Rationale”Explain why this decision is the best option compared to alternatives.
Consequences
Section titled “Consequences”List positive and negative outcomes that follow from adopting this decision.
Security / Privacy Impact
Section titled “Security / Privacy Impact”Assess how the decision alters threat posture, data exposure, or privacy obligations.
Operational Impact
Section titled “Operational Impact”Describe effects on runbooks, deployment workflows, observability, or SLAs.
Alternatives Considered
Section titled “Alternatives Considered”Summarize other options evaluated and why they were declined.
Implementation Steps
Section titled “Implementation Steps”Outline the actions required to realize the decision, including ownership.
Verification Method
Section titled “Verification Method”Define how success will be measured or validated after implementation.
Rollback Plan
Section titled “Rollback Plan”Describe how to revert if the decision proves unsuitable or introduces regressions.
References
Section titled “References”Link to supporting documents, diagrams, issue trackers, or external standards.