/compact

Context Compression: $ARGUMENTS

Initiating manual context optimization to preserve session continuity.

Compression Protocol

Phase 1: Archive Important Context

Before compressing, capture:

1. Recent Decisions: What's been decided so far
2. File Modifications: What's changed and why
3. Blockers: Any issues preventing progress
4. Next Steps: What work remains

Create archive in .claude/archive/:

session-YYYY-MM-DD.md
├── Decisions Made
├── Files Modified
├── Key Findings
├── Blockers
└── Next Steps

Phase 2: Analyze Context

Count tokens by category:

• Conversation history: X tokens
• Code snippets: X tokens
• Tool outputs: X tokens
• System context: X tokens
• Other: X tokens

Phase 3: Compression Strategy

Decide what to preserve/remove:

• KEEP: Recent work, active decisions, current blockers
• ARCHIVE: Completed tasks, old exploration, resolved issues
• REMOVE: Verbose tool output, intermediate steps, error messages now fixed

Phase 4: Execute Compression

1. Archive old context to file
2. Summarize key points in new session header
3. Show before/after token count
4. Verify nothing critical was lost

Output Format

╔════════════════════════════════════╗
║   CONTEXT COMPRESSION COMPLETE     ║
╚════════════════════════════════════╝

📦 Archive Created: session-2025-12-20.md

📊 Token Count:
  Before: 145,000 tokens (72%)
  After:  85,000 tokens (42%)
  Freed:  60,000 tokens (30%)

✅ Preserved:
  • Last 10 decisions
  • Current file changes
  • Active blockers
  • Next 5 tasks

📁 Archived:
  • Exploration phase (40 messages)
  • Resolved issues (8 messages)
  • Tool output history (100+ KB)

⏱️  Archive duration: [time saved by compression]

Options

• /compact full - Complete aggressive compression
• /compact safe - Conservative compression (minimum removals)
• /compact list - Show what would be removed without executing
• /compact restore - Restore previous session from archive