handofflisted

______________________________________________________________________ ## handoff **Skill metrics:** Emit a start event to the activity log: ```bash echo "{\"type\":\"skill\",\"event\":\"start\",\"skill\":\"handoff\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" >> docs/sessions/.activity-log.jsonl ``` Generate a comprehensive handoff for ending a development session: ## Phase 0: Validate Prerequisites Before starting, verify: - `docs/sessions/` directory exists (create if missing) - No conflicting session file for today's date If the directory is missing, create it silently and proceed. ## 1. Capture Current State Analyze: - Current branch: `git branch --show-current` - Git status (uncommitted changes?) - Open PRs: `gh pr list --author @me --state open` - Current sprint spec (if exists: `docs/sprints/sprint-*.md`) — extract sprint goal, capacity used, and any decisions logged this session - Last entries in @docs/progress.md ## 2. Document Progress If work was done this session, ensure it's captured: - Sprint spec updated with progress - Any decisions documented - Blockers noted ## 3. Generate Session File Save a structured session file to `docs/sessions/session-YYYY-MM-DD.md`. The file MUST start with YAML frontmatter for `/resume` searchability: ```markdown --- date: YYYY-MM-DD sprint: [current sprint number] sprint_goal: "[sprint goal — one sentence from sprint spec]" sprint_capacity: "[sessions used/total — e.g., 5/8]" branch: [branch-name] stories: [comma-s