Package a finished change so its reviewers never reconstruct intent from the diff. Write for a\nreviewer holding the diff and nothing else — no planning docs, no session, no knowledge that\neither exists.
\nThe input is any partial reference — ticket id, slug, a planning artifact's path — or nothing,\nmeaning the session's task; in a fresh session, infer it from branch name and recent commits.\nResolve it to the task's planning home: its <id>-<slug>/ directory in the project's planning\ndirectory, or its flat <id>-<slug>.* files in a shared family directory. One clear match →\nproceed, stating the home and artifacts found. Inferred, or several candidates (-vN, …) →\nconfirm first. An explicit reference matching nothing local → stop and ask; never guess.
Read these, skipping what doesn't exist:
\n<id>-<slug>*.md in the planning home: ticket, requirements, plan,\ndecisions log, prior review and handover rounds, whatever else matches..TICKET.mds first; fetch from the tracker only when a relation has no local\nfile and looks load-bearing for a why — in doubt whether to fetch, ask.An earlier artifact — a ticket review, a prior round — counts only where nothing later settled the\npoint.
\nEach source once, no deeper than the artifact needs: skim the diff whole, deep-read only the files\nyou will name in the Review guide, and never rebuild history commit by commit — which commit\nchanged what is the diff's job, not yours.
\nThen match the plan's steps and acceptance criteria against the diff both ways — planned but\nabsent, present but unplanned. Done when every source is read or confirmed absent and every planned\nitem is matched.
\nState a \"why\" only where a source gives it. A deviation nothing explains is asked of the author\nonce; unanswered or unaskable, it ships flagged in plain words (\"nothing records why — worth\nconfirming\"), since it may be an unintentional gap rather than a decision. Sourcing is your gate,\nnot the reviewer's reading: it decides what you may write, and never appears in the text.\nWhen not sure, always ask. Never guess.
\n<slug>.HANDOVER.md in the planning home; already taken → <slug>.HANDOVER-2.md, -3, … —\nnever overwrite. No planning home → present the content and ask where to save it. Its body is\npaste-ready as the PR description, and stands alone:
Sections, skipped only when truly empty:
\nDone when every section is filled or knowingly skipped, nothing reads as verified that wasn't, and\nnothing in the text points at something the reviewer cannot open.
\n