Skip to main content

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 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.