Decision log

Append-only. Every decision that shaped this codebase, with its reasoning, so it can survive a context compaction and so nobody re-litigates a settled question from first principles six weeks later.

Read this file at the start of any working session. It is the durable memory of the project; the conversation that produced these decisions is not.