ADR-XXXX — Short title
- Status: Proposed / Accepted / Superseded by ADR-YYYY
- Date: YYYY-MM-DD
- Deciders: names or roles
Context
What is the situation and the problem? What forces are at play (technical, product, security, cost, team)? State facts, not opinions. Link to any relevant audit docs or prior ADRs.
Decision
The choice we are making, stated in one or two clear sentences. Then the specifics of how it works.
Consequences
What becomes easier, what becomes harder, and what new obligations this creates (secrets to rotate, steps someone must remember, follow-ups to schedule).
Alternatives considered
Each option we did not pick, and the one-line reason we rejected it.