## Problem

What breaks or what is missing. Link the issue if one exists (`Fixes #123`).

## Approach

Why this change solves the problem — the reasoning behind the approach, not a restatement of the diff.

## Scope

What changed. If anything outside the core fix was touched, explain why it was necessary. New tests are not expected by default — if any were added, justify why each is needed.