Architecture Decision Records

This directory captures long-lived architectural decisions using MADR-style records. Add a new ADR when a decision affects the shape of future work (new conventions, tooling choices, breaking layout changes); routine changes belong in commits and pull requests, not here.

To start a new ADR, copy template.md, give it the next sequential number, and follow the existing files as examples.