session-wrap

Overview

Combines decision capture and session handoff into a single end-of-session workflow. Produces two outputs:

1. Decisions appended to .claude/memory/decisions.jsonl
2. Handoff document at .context/session-handoff-{date}.md

Step 1: Gather Context

Git State

1. Run git status to get current branch and working tree state
2. Run git diff --stat for a summary of changed files
3. Run git log --oneline -20 for recent commit history

Task State

1. Call TaskList to get current task state
2. For each in-progress or pending task, call TaskGet for full details

Memory Context

1. Check if .claude/memory/decisions.jsonl exists — create if missing
2. Read last 5 entries from decisions.jsonl (if any) to avoid duplicates
3. Check if .claude/memory/sessions/ has recent summaries — read the latest

Key Files

1. Identify the most important files from the git diff and task descriptions

Step 2: Extract Decisions

Review the session and identify decisions in these categories:

Category	Examples
Architecture	Chose pattern X over Y, added new module, restructured
Technology	Added dependency, chose library, configured tool
Convention	Established naming rule, coding standard, file structure
Trade-off	Accepted limitation, deferred work, chose simpler approach
Bug fix	Root cause identified, fix strategy chosen

For each decision, capture:

• what: One-line summary (under 80 characters)
• why: Rationale (1-2 sentences, under 200 characters)
• context: Files or areas affected
• category: One of architecture, technology, convention, trade-off, bugfix

Append each as a single JSON line to .claude/memory/decisions.jsonl:

{"date":"2026-03-08","category":"architecture","what":"Added schema-audit skill","why":"Prompt analysis showed DB schema review as top uncovered workflow","context":"skills/schema-audit/"}

If pixl is available (command -v pixl), also persist each decision as a pixl artifact:

pixl artifact put --name "decision-<category>-$(date +%s)" --type decision --content '<json>'