Session Wrap-up

Goal: Ensure nothing important is lost when this session is cleared. Commits preserve what changed. Sessionlogs preserve why and how — but only when that context isn't already captured in committed artifacts.

CRITICAL: Restore Full Session History First

Nothing proceeds until full history is reconstructed. Context compaction hides earlier work — you must recover it or the sessionlog will be incomplete.

1. Use a subagent to analyze the session file (see subagent-tasks.md)
2. Follow the tool-specific restoration guide:
   • Claude Code: claude-code-session-restoration.md
   • Cursor: cursor-session-restoration.md
3. Combine restored history with current context before continuing

If restoration finds no prior work beyond current context, proceed — but log that restoration was attempted.

Parallel session safety: The user may have multiple sessions running. Filter by $CLAUDE_SESSION_ID and timestamp correlation. Never combine work from other sessions. If uncertain, ASK.

Session Type Detection

After restoring history, classify the session:

Signal	Type	Action
"isSidechain": true or in subagents/ dir	Subagent	STOP — do not run /bye
messageCount <= 2, first msg contains "Context: This summary"	Metadata session	SKIP — not a real work session
First messages reference executing a plan; recent file in ~/.claude/plans/	Plan execution	Read plan file; sessionlog documents execution vs plan
System message contains "Plan mode is active"	Plan creation	Plan file is the deliverable — usually skip sessionlog (see step 3)
None of above	Normal	Continue with checklist

Session Wrap-up Checklist

1. Determine scope — everything between last /bye (or session start) and now. Verify each item was discussed in THIS conversation.

2. Assess work — files created, files modified, decisions made, research done, tasks completed, tasks remaining.

3. Sessionlog needed? Would anything important be lost if we clear this session now? Commits already capture what changed and when. A sessionlog is only worth creating for context not in the committed artifacts.

   Session produced...	Sessionlog?	Why
   Plan file only	Skip	Plan file captures everything
   Q&A only, no file changes	Skip	Nothing to preserve
   Code/doc changes with clear commits	Skip	Git history tells the story
   Feature with decisions, alternatives tried, non-obvious rationale	Create	Context not in the code
   Single file, but research/intent/sources behind it	Create	Log captures the why
   Plan execution with deviations or partial completion	Create	Plan-vs-reality delta is valuable

   If skipping, note **Sessionlog:** Skipped — [reason] in the final summary.

4. Sessionlog — check if a sessionlog directory exists (see sessionlog-template.md). If no directory found, skip this step entirely — do NOT create directories. If found, create or update the sessionlog per the template.

5. Update project status — if work relates to projects/*/, update its status.md.

6. Handle git — see git decision table below.

7. Print final summary — see template below.

Git Decision Table

Situation	Action
Files I created/edited THIS session	Auto-commit
Untracked files from before	ASK
Modified files I didn't touch	ASK — likely parallel session
.env, credentials, secrets	NEVER, warn user

Commit message: [Brief description]\n\nSession wrap-up: YYYY-MM-DD

Push if remote tracking exists.

Final Summary Template

## Session Complete

**Accomplished:**
- [item 1]
- [item 2]

**Committed:** [hash]
- [file list]

**Pending:**
- [ ] [task 1]

**Session:** Reconstructed from N compaction(s) · ~Xk input / ~Yk output tokens
           ↑ only include if compactions > 0; round tokens to nearest k

**Sessionlog:** `sessionlogs/[file].md`

Ready to clear context.