Architecture Decision Records

This directory holds the durable record of architecture decisions that should not be re-litigated from scratch every time the same question comes up.

Use ADRs for decisions that are:

structural rather than incidental
likely to be questioned again
expensive to reverse
cross-cutting across runtime, product, and extensions

Relationship to the other docs:

../architecture.md: what the system is now
../roadmap.md: where the system is going
../whitepaper.md: why this category should exist
adr-*.md: why a specific architecture choice was made instead of an alternative

Current ADRs: