session-compression

# Session Compression Compress session context without losing actionable information. Use before context window fills up or when handing off between sessions. ## Why Compress | Metric | Raw Context | Compressed | |--------|------------|------------| | Token count | ~50K | ~3-5K | | Decision count | Scattered | Indexed | | File references | Buried in prose | Listed | | Error history | Verbose stack traces | Root cause + fix | | Reduction | 1x | 10-30x | ## Compression Format ### ACDE Format (Actions, Context, Decisions, Entities) ```markdown ## A: Actions Completed - [x] Refactored auth middleware (auth.ts, middleware.ts) - [x] Added rate limiting (api/limiter.ts) - [ ] Pending: Write tests for rate limiter ## C: Context - Project: my-app (Next.js 16, TypeScript) - Branch: feat/auth-refactor (3 commits ahead of main) - Blockers: None ## D: Decisions - D1: JWT over sessions (stateless, mobile-friendly) - D2: 100 req/min rate limit (based on load test) - D3: Rejected Redis session store (overkill for current scale) ## E: Entities - Files: auth.ts:42, middleware.ts:15, api/limiter.ts (new) - Deps: jsonwebtoken@9.0.0, express-rate-limit@7.0.0 - APIs: POST /auth/login, POST /auth/refresh, GET /auth/me ``` ## When to Compress 1. **Pre-compact**: Before context window compression (auto via hook) 2. **Session handoff**: When switching between sessions on same project 3. **Agent delegation**: When handing complex task to another agent 4. **Milestone reached**: After completi...