Architecture Decision Record

Problem

You discover: "We use Kafka here." Nobody remembers why. Was it scalability? Replay? Ordering? A temporary constraint? Without the reasoning, future engineers may reverse a decision without understanding its context.

Solution — ADR

Record the decision together with its context and consequences.

Problem

Constraints Decision Alternatives Consequences

Core idea: ADRs preserve the reasoning behind important architectural decisions.