parcadei-create-handoff

To create a handoff document, the skill generates a YAML file at a standardized path using the target session name and timestamp, then populates the body with goals, context, artifacts, decisions, and next steps for the next agent.

The best way to structure session transfers is using a standardized YAML format that captures goals, context, artifacts, decisions, and next steps, ensuring the next agent receives complete workflow continuity.

Session management determines the target handoff folder by auto-detecting the most recently modified handoff folder within the thoughts/shared/handoffs/ directory, defaulting to 'general' if none exists.

You do not need to manually name handoff files. The skill automatically generates a kebab-case description title and appends the current date and time in a YYYY-MM-DD_HH-MM format to the filename.

You can use YAML frontmatter to track session metadata by automatically populating the date and session_name fields, which supports artifact indexing and organizes workflow documentation for future retrieval.

A key limitation is that auto-detection relies entirely on existing folder modification times within the handoffs directory, meaning it will default to a generic session name if no prior handoff folders are present.