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