What's New
Summarise what the user can now see or do that they couldn't before this unit of work.
Scope
$since (optional) pins the start of the unit of work: measure from that ref with git log $since..HEAD and git diff $since...HEAD. Without it, infer the unit: typically the current branch's commits, or everything since the last merge or tag.
Rules
- Describe observable behaviour only: what appears on screen, what the user can interact with, what a command now outputs
- No implementation detail, no file names, no technical explanation
- Write in second person: "You can now..."
- If nothing user-visible changed (docs, tests, refactors only), say so in one sentence
- Keep it to 3–5 bullet points maximum
Format
Now you can:
- [observable behaviour 1]
- [observable behaviour 2]
- ...