session-summarize

Session Summarizer Command

When invoked, generate a session summary in markdown format suitable for pasting into a fresh Claude Code session.

Execution Steps

1. Gather session state:

   • Check .claude/plans/ for active plan files
   • Look for active todos in CLAUDE.md or .claude/projects/[workspace]/memory/ directory
   • Scan recent memory files (decision, feedback, project, reference files) for non-obvious decisions
   • Run git status --short to list changed files
   • Run git log --oneline -5 to show recent commits this session

2. Extract from conversation (this session only):

   • Identify key decisions made ("decided to", "will use", "approach:")
   • Identify blockers or open questions ("blocked on", "pending", "need to", "stuck on")
   • Do NOT include completed work or routine back-and-forth

3. Build preamble text:

## Session Context

**Date**: [today's date]
**Branch**: [git branch]

### Active Todos
[Copy from .claude/plans or CLAUDE.md if exists; format as list. Skip section if none.]

### Current Plan
[Extract first 20-30 lines from active plan file if exists. Skip if none.]

### Key Decisions This Session
- [Each decision as bullet]

### Blockers / Open Questions
- [Anything blocking progress or pending decision]

### Files Changed
[Git status output, just filenames]

### Recent Commits
[Last 5 commits]

---

### How to Resume

Paste entire block above into new session opening prompt. Continue from **Current Plan** section or latest blocker. Git will load modified files automatically.

4. Output constraints:

   • Skip sections with no content (except Date/Branch/How to Resume)
   • Only include active todos (not completed ones)
   • Decisions/blockers: 1-2 lines each, no verbosity
   • No full diffs, conversation history, or verbose explanations
   • Total output should fit in ~500 words max

5. Deliver summary:

   • Display markdown block in response
   • Add note: "Copy entire block above to clipboard for new session"