Write or update Architecture Decision Records (ADRs) under docs/adr/ using the repo template — context, options, decision, consequences. Use when a choice is hard to reverse, spans modules, or will be questioned later. Trigger phrases — "ADR", "architecture decision", "写 ADR", "记录决策", "docs/adr".
