[Clear problem title]

Problem

[1-2 sentence description of the issue and user-visible impact]

Symptoms

• [Observable symptom or error]

What Didn't Work

• [Attempted fix and why it failed]

Solution

[The fix that worked, including code snippets when useful]

Why This Works

[Root cause explanation and why the fix addresses it]

Prevention

• [Concrete practice, test, or guardrail]

Related Issues

• [Related docs or issues, if any]