Decision records¶

Who is this page for?

Contributors and reviewers who want to know why GAME is built the way it is. Each record captures one architectural decision - the context that forced it, what was chosen, and what that costs - so a decision has a single home instead of being rediscovered from the code.

These are lightweight architecture decision records (MADR-style): short and numbered. A record is not a promise that a decision is permanent; it is an honest note of what was decided and why, at the time. Where a decision also has a richer prose home elsewhere in this manual, the record links to it rather than duplicating it.

All records below are Accepted and describe the current behavior on main. If a decision is later superseded, its own page records that.