context-passport

Solve context fragmentation across Claude sessions. Use when users mention re-explaining themselves, losing conversation context, starting over, "you forgot," context loss, session continuity, picking up where we left off, or wanting Claude to remember across chats. Also use when users want to create/update their passport, generate session summaries, or maintain project continuity.

Context Passport

Maintain user and project context across Claude sessions via a structured GitHub-hosted document.

Core Components

1. The Passport (`PASSPORT.md`)

Token-efficient markdown in user's GitHub repo. See references/passport-template.md.

Sections:

Identity: Name, timezone, communication preferences
Brain Manual: ADHD accommodations, learning style, energy patterns
Active Projects: Current focus, phase, blockers
Context Stack: Recent decisions, open questions, where we left off
Don't Make Me Repeat: Facts explained too many times

2. Session Summary

Run scripts/session-summary.py on conversation exports to extract updates.

3. Quick-Start Prompt

User pastes at session start: "Read my Context Passport at [URL] and continue where we left off."

Workflows

Creating a New Passport

Read references/passport-template.md
Interview user for core info (max 5 questions)
Generate PASSPORT.md
User commits to repo

End-of-Session Update

Export conversation (JSON preferred)
Run session-summary.py
Append to Context Stack
Commit changes

Resuming with Context

User provides passport URL or content
Acknowledge context without restating
Continue from Context Stack

Design Principles

Token-efficient: Passport under 500 words
Low-friction: 2-min end-of-session ritual max
Accountability: Git history shows evolution