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