129 lines
3.8 KiB
Markdown
129 lines
3.8 KiB
Markdown
---
|
|
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`
|