handofflisted

# Handoff Skill > **Quick Ref:** Create structured handoff for session continuation. Output: `.agents/handoff/YYYY-MM-DD-<topic>.md` + continuation prompt. **YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.** Create a handoff document that enables seamless session continuation. ## Execution Steps Given `$handoff [topic]`: ### Step 1: Create Output Directory ```bash mkdir -p .agents/handoff ``` ### Step 2: Identify Session Context **If topic provided:** Use it as the handoff identifier. **If no topic:** Derive from recent activity: ```bash # Recent commits git log --oneline -5 --format="%s" | head -1 # Check current issue bd current 2>/dev/null | head -1 # Check ratchet state ao ratchet status 2>/dev/null | head -3 ``` Use the most descriptive source as the topic slug. **Topic slug format:** 2-4 words, lowercase, hyphen-separated (e.g., `auth-refactor`, `api-validation`). **Fallback:** If no good topic found, use `session-$(date +%H%M)` (e.g., `session-1430`). ### Step 3: Gather Session Accomplishments **Review what was done this session:** ```bash # Recent commits this session (last 2 hours) git log --oneline --since="2 hours ago" 2>/dev/null # Recent file changes git diff --stat HEAD~5 2>/dev/null | head -20 # Research produced ls -lt .agents/research/*.md 2>/dev/null | head -3 # Plans created ls -lt .agents/plans/*.md 2>/dev/null | head -3 # Issues closed bd list --status closed --since "2 hours ago" 2>/dev/null | head -5 ``` ### Step 4: Identi