Skip to content

ADR-XXXX: Title

Status: Proposed

Date: YYYY-MM-DD


Context

Describe the situation that requires a decision.

Questions to answer:

  • What problem exists?
  • Why does it matter?
  • What constraints apply?

Decision

Describe the selected solution.

Be explicit.

Document:

  • chosen approach
  • scope
  • assumptions

Alternatives Considered

Alternative A

Description.

Pros:

  • ...

Cons:

  • ...

Alternative B

Description.

Pros:

  • ...

Cons:

  • ...

Consequences

Document expected results.

Positive:

  • ...

Negative:

  • ...

Trade-offs:

  • ...

Implementation Notes

Optional section.

Include:

  • migration strategy
  • rollout plan
  • dependencies

List related documents.

Examples:

  • System Blueprint
  • Governance & Evolution
  • Engine Contracts
  • Release Process

Approval

Role Name Date
Architect
Reviewer