session-handofflisted

# Session Handoff Persist only the context a fresh agent needs to continue safely. Prefer the repository's existing handoff convention; otherwise use `docs/work/handoffs/YYYY-MM-DD-<slug>.md`. ## Create Or Refresh Inspect the current branch, status, recent commits, changed files, canonical plan, and executed verification. Write: ```markdown # Handoff: <outcome> ## Objective And Boundary ## Canonical Sources ## Current Repository State ## Completed Work And Evidence ## Decisions And Rationale ## Blockers And Limitations ## Immediate Next Actions ## Verification Commands ## Delivery Metadata ``` Delivery metadata includes the repository path, branch, base or checkpoint commit, retained commits, PR, dirty files, and date. Use stable spec or task IDs where available. Record what failed and why so the next task does not repeat dead ends. Never include secrets, credential bytes, private tokens, or unnecessary raw logs. ## Validate Before Handoff Confirm that: - referenced files and commits exist; - reported status matches the current worktree and executed checks; - dirty or uncommitted work is named explicitly; - the first next action is concrete and safe; - decisions that affect the product or architecture are also in canonical specs or ADRs; - the handoff does not pretend to be a source of product truth. ## Resume 1. Read applicable `AGENTS.md` and the handoff completely. 2. Verify repository, branch, commit, worktree state, and referenced paths. 3. Inspect commits an