handoff-session

<decision_rules>

• Prefer precise session facts over general project descriptions.
• Include only items touched, created, decided, started, or made relevant in this session.
• If a required section has no information, write none; never omit required sections.
• Use absolute paths for files, directories, worktrees, plans, and memory artifacts when a path is known. If only a relative path is known, resolve it against the current working directory before writing it.
• If a plan or task list drove the session, list it first under Key files for next session.
• For running state, include how the next agent can stop or resume the process when that information is known.
• If evidence is uncertain or unavailable, say so briefly instead of inventing state. </decision_rules>

<output_format> Use exactly this structure every time:

# Session Handoff — <one-line title of what this session was about>

## Where it started
<2-3 sentences: what the user asked for, key framing or constraints that emerged>

## Decisions locked + what shipped
- <decision or change> — <why it matters, and where it lives if applicable>
- ...

## Key files for next session
- `<absolute path>` — <why the next agent should read this first>
- Plan file: `<absolute path>` — <if a plan drove the session, otherwise `none`>
- Notes or memory touched: `<absolute path>` — <if any, otherwise `none`>

## Key facts for next session
- <fact> — <why it matters>
- ...

## Deferred + open questions
- Deferred: <item> — <why pushed to later>
- Open: <question needing user input> — <context>

## Pick up here
<leave empty, will be filled by the user>

</output_format>

<completion_criteria> Before sending, verify that:

• Every required section is present.
• No section contains invented or assumed state.
• All known file paths are absolute.
• Running processes, ports, worktrees, and branches are explicit or marked none.
• Verification commands are specific and tied to expected or observed outcomes.
• Pick up here contains one focused next action. </completion_criteria>