{{work item title}}

Background

{{the problem space, delta-only: what the reader does not already know}}

Intuition

{{the approach, and what becomes true if the spec is approved}}

Walkthrough of the spec

{{the spec in approval order: requirements, then design, then the testing plan}}

When you are done, go back to the ticket and tick the box in the-loop's comment.

Background

{{the touched components and their prior behaviour}}

Intuition

{{the core idea with a toy example; old vs new}}

Code

1 · {{first conceptual group, in execution order}}

{{why this group exists and what it does}}

{{path/to/file.py:LINE — an excerpt, escaped}}

Risks & limits

{{what could break, what was deliberately not done, sharp edges}}

When you are done, go back to the pull request and tick the box in the-loop's comment.