ADR <number>: <title>

Ratification

After discussion in a GitHub Issue (ADR template; title starts with [ADR] — see ADR 0018), record the outcome here: link to the discussion Issue, link to the merge PR, acceptance date, and optional list of participants.

• Discussion Issue: <URL>
• Merge PR: <URL>
• Accepted: <YYYY-MM-DD>

Context

<What problem or pressure requires a decision?>

Decision

<What is being decided?>

Scope

• In scope: <systems/modules/processes>
• Out of scope: <what this ADR does not cover>

Alternatives considered

1. <Alternative A>
   • Pros: <...>
   • Cons: <...>
2. <Alternative B>
   • Pros: <...>
   • Cons: <...>

Consequences

Positive

• <benefit 1>
• <benefit 2>

Trade-offs

• <trade-off 1>
• <trade-off 2>

Compatibility and migration

• Backward-compatibility impact: <none/low/medium/high>
• Migration plan (if needed): <steps>
• Rollback strategy: <steps>

Implementation plan

1. <step 1>
2. <step 2>
3. <step 3>

Validation

• Technical checks: <commands/tests>
• Operational checks: <runbooks/monitoring>
• Documentation updates: <README/docs/index/runbooks>

References

• Related ADRs: <links/files>
• Related runbooks: <links/files>
• Related PR/issues: <links>

Page history