ADR Writing Architecture

An ADR (Architecture Decision Record) is a structured document capturing a significant technical decision, the context that led to it, alternatives considered, and consequences of the choice. ADRs live in version control (Git) as Markdown files, numbered sequentially (ADR-001, ADR-002, etc.). They're short (one page) and written after the decision is made, not as a pre-decision justification. The format is simple: Context → Decision → Consequences → Alternatives. The point is decision transparency and future onboarding.