handoff-update

Automate session handoff document updates by resolving an existing handoff file and applying structured merge rules. The tool appends Work Done entries, replaces Status and Next Steps, and merges Files and Discoveries sections to preserve history.

When no source handoff document is found, a new handoff file is automatically created at claudedocs/handoffs/handoff_YYYYMMDD_HHMMSS.md. This fallback ensures seamless handoff generation without manual file setup.

Update an existing handoff document by providing the target file path or relying on session history. The tool applies append-only logic to Work Done, replaces Status and Next Steps, and merges Files and Discoveries, returning the merged document and a summary of changes.

Merge session discoveries without losing previous context using structured merge rules. The tool combines new items into existing Files and Discoveries sections while preserving the complete historical activity log in the Work Done section.

Updating handoff documents supports append-only version history for the Work Done section to maintain a complete activity log. Status and Next Steps sections are fully replaced, while Files and Discoveries are merged to keep all context intact.

Maintain version history across multiple workflow handoffs by applying structured merge rules. Append new session progress to Work Done, replace current Status and Next Steps, and merge Files and Discoveries to ensure no previous context is lost during transitions.