add_adrlisted

Record an architectural decision record (ADR). ## When an ADR is warranted - The choice is hard to reverse, or expensive to re-derive - Multiple plausible options existed and one was deliberately picked - A future agent or developer would ask "why is it like this?" Not warranted: formatting choices, renames, anything fully explained by code. ## Steps 1. Find the next free number: list `.agents/docs/adr/adr-*.md` and take the highest `NNN` + 1. 2. Copy `.agents/docs/adr/adr-template.md` to `.agents/docs/adr/adr-NNN-<kebab-slug>.md`. 3. Fill every section. Keep it short — context (2-5 sentences), the options actually considered, the decision with its justification, and honest consequences (including the bad ones). Delete the template's comments. 4. Set Status to `accepted` if the decision is already in effect, otherwise `proposed`. 5. If the ADR supersedes an older one, mark the old ADR `superseded by ADR-NNN` — do not delete it. 6. Mention the new ADR in the commit/PR that implements the decision.