handover

Session Handover + Wisdom Capture

Phase 1: Gather Context

Run in parallel:

git log --oneline -15 --decorate
git status --short --branch
git diff --stat origin/main...HEAD

Also check:

• What the user asked for this session (scan conversation for key requests)
• What decisions were made and why
• What surprised you (unexpected complexity, elegant solutions, things that just worked)

Phase 2: Write Handover Doc

Create docs/ops/HANDOVER_{today's date}_{2-word-slug}.md:

# Handover — {date}

## What Landed
{bullet list of commits on main}

## What Changed This Session
{files changed, features added, bugs fixed}

## Current Blockers
{external dependencies, manual steps, unresolved issues}

## Recommended Next Stack
{ordered list of what to work on next, with WHY for each}

## Verification Evidence
{which gates passed, build status, deploy status}

---

## Session Wisdom

### Prompts That Worked
{List the user's most effective prompts this session — what did they ask that produced great results? Quote the prompt pattern, not the full text. These are reusable techniques.}

### Technical Choices Validated
{Decisions made this session that proved right (or wrong). Architecture, library, pattern choices. Include the reasoning — WHY it worked, not just WHAT.}

### Patterns Discovered
{Any repeatable patterns, shortcuts, or approaches worth remembering. Things that would help a future session start faster.}

### What Was Built (Gratitude)
{A brief, genuine reflection on what was accomplished. Not metrics — meaning. What's better about the project now? What creative leaps happened?}

Phase 3: Route to Starlight Vaults

Extract insights from the wisdom section and append to appropriate vaults. Each vault entry is one JSONL line:

{"id":"TYPE_YYYYMMDD_N","insight":"...","category":"...","confidence":"high|medium","source":"session-handover","session":"SLUG","createdAt":"ISO_DATE"}

Route by content:

• Code/architecture/tooling insights → ~/.starlight/vaults/technical.jsonl
• Business/product/strategy insights → ~/.starlight/vaults/strategic.jsonl
• Design/style/voice insights → ~/.starlight/vaults/creative.jsonl
• Workflow/process/ops insights → ~/.starlight/vaults/operational.jsonl
• Cross-domain meta-patterns → ~/.starlight/vaults/wisdom.jsonl (create if missing)
• Benevolent human-AI collaboration insights → ~/.starlight/vaults/horizon.jsonl