ADR-XXXX:

• Status: Proposed
• Date: YYYY-MM-DD
• Deciders:
• Tags:

Context

Describe the current state, constraints, and why a decision is required.

Decision

State the chosen option clearly.

Alternatives Considered

1. Option A
2. Pros:

3. Cons:

4. Option B

5. Pros:
6. Cons:

Consequences

Positive:

Negative:

Compatibility Impact

• Classification: none | additive | breaking
• Affected contracts:
• Migration guidance:

Test and Validation Plan

1. Contract tests:
2. Regression tests:
3. Runtime verification:

Rollout and Rollback

• Rollout steps:
• Rollback strategy:

References

• Related PR(s):
• Related issue(s):
• Related docs/changelog entries: