Architecture decision records

Short records of the decisions that shape the package, kept so the "why" is recoverable later.