[One-line summary — what was done]
[What and why. The problem and the intent. Big picture first; name the top P1 findings in one line.]
[What was decided / why / rejected alternatives / tradeoffs]
[What this change is for. Mark suspicious spots with a footnoteP1.]
Before
[before]
After
[after]
[Tests added + manual scenarios. Commands must be copy-pasteable.]
[verification command — the project's test/run command]
[Other modules touched, external API contracts, migrations, backward compat. "N/A" if none.]
⚠️ TODO [What's not done]