Initial commit

commands/session-end.md

@@ -0,0 +1,128 @@
+---
+description: End session with comprehensive handoff generation
+---
+
+# Session End Workflow
+
+Execute the session-management skill's finish workflow to create a comprehensive handoff.
+
+## Step 1: Create Final Checkpoint
+
+First, automatically create a final checkpoint to capture the current state:
+
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}/skills/session-management/scripts
+python session.py checkpoint --label "session-end"
+```
+
+This captures all uncommitted work and current metrics.
+
+## Step 2: Gather Handoff Information
+
+Use `AskUserQuestion` to collect information for the handoff document:
+
+### Question 1: What Did You Accomplish?
+
+Ask: "What did you accomplish in this session?"
+
+Options:
+- Analyze the session checkpoints and git commits to suggest:
+  - **"Completed [feature/task from objectives]"**
+  - **"Fixed [issues addressed]"**
+  - **"Implemented [components created]"**
+  - **"Refactored [areas improved]"**
+- **Other** - Let user type custom accomplishments
+
+### Question 2: What Decisions Were Made?
+
+Ask: "Were there any important decisions or trade-offs made during this session?"
+
+Options:
+- **"Chose [technology/approach] because [reason]"** - Technical decision
+- **"Decided to defer [feature] due to [constraint]"** - Scope decision
+- **"No major decisions"** - Skip this section
+- **Other** - Let user type custom decisions
+
+### Question 3: What Should Next Session Remember?
+
+Ask: "What context or next steps should be documented for the next session?"
+
+Options:
+- **"Continue with [specific task]"** - Next task note
+- **"Watch out for [potential issue]"** - Warning note
+- **"Remember to [action item]"** - Action reminder
+- **"Review [code/docs] before proceeding"** - Review reminder
+- **Other** - Let user type custom notes
+
+### Question 4: Git Push Options
+
+Ask: "Should we push commits to the remote repository?"
+
+Options:
+- **Yes, push to remote** - Push all commits (proceed with confirmation)
+- **No, keep local** - Don't push (useful for WIP)
+- **Ask for confirmation first** - Show what will be pushed, then confirm
+
+## Step 3: Generate Handoff Document
+
+Based on collected inputs, execute the session end command:
+
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}/skills/session-management/scripts
+
+# Generate handoff and push
+python session.py end --push
+
+# Generate handoff without push
+python session.py end --no-push
+
+# With merge to main
+python session.py end --merge-to main --push
+```
+
+The script will:
+- Generate comprehensive handoff document with:
+  - Session summary (start time, duration, objectives)
+  - Accomplishments (from collected inputs)
+  - Decisions made (from collected inputs)
+  - Context for next session (from collected inputs)
+  - Metrics (commits, files changed, tests added)
+  - Git status (branch, uncommitted changes)
+- Save to `.sessions/handoffs/handoff_[timestamp].md`
+- Optionally push commits to remote
+- Update session state to "ended"
+
+## Step 4: Confirm and Finalize
+
+Report to user:
+- Handoff document location
+- Session summary (time spent, accomplishments)
+- Git status (commits pushed, branch state)
+- Next session recommendations
+
+Optionally ask:
+
+Ask: "Would you like to merge this branch?"
+
+Options:
+- **Merge to main** - Merge current branch to main
+- **Merge to develop** - Merge to develop branch
+- **Create pull request** - Guide PR creation
+- **Keep branch** - Don't merge, keep for next session
+
+---
+
+## Use This Command
+
+When ending a work session:
+- End of day or before extended break
+- After completing feature or fix
+- Before context switching to different project
+- When wrapping up and need handoff for future you or teammates
+
+## Integration Notes
+
+- Integrates with **tdd-workflow** for test metrics in handoff
+- Uses checkpoint system for comprehensive state capture
+- Handoffs saved to `.sessions/handoffs/` directory
+- Session state preserved in `.sessions/state.json`