handoff — Session-End Handoff Writer

Overview

HANDOFF.yaml is split in two: items are the committed short-lived context layer for still-open work, while log is the durable one-line history of finished work. GitHub issues, reconciled through valerie and doob, are the active-work source of truth. Non-Valerie skills should use the local SQLite database via handoff-db plus HANDOFF YAML, never doob directly. The scripted bridge from HANDOFF into the backlog is handoff-reconcile; use that instead of reconstructing doob commands by hand. Project state (build, tests, branch) lives separately in .ctx/HANDOFF.<name>.<base>.state.yaml — generated, never committed. A rendered reference doc is also written to .ctx/HANDOFF.md.

See references/schema.md for the full YAML schema, immutability rules, priority guide, and file layout.

File Discovery

Use handoff-detect to resolve the HANDOFF.yaml path if available: