Design

The design tier is where the reasoning lives: the choices the architecture rests on, and an account of where the implementation sits against them. It is the home for the why-we-built-it-this-way narrative the source comment policy keeps out of the code.

DecisionsThe load-bearing architectural choices, recorded with their reasoning so they are decided once and not re-argued.

LearningsWhat the design got right, what is still partial in this beta, and what we would tell the next builder.