Context Window Optimizer

Manage context strategically to prevent token waste and keep conversations effective.

Core Principle

Context is a shared resource. Keep it lean so there's room for actual work.

When to Optimize

• - Conversation exceeds ~50 messages
• Context feels heavy before a new task
• Starting a complex multi-step task
• After significant decisions or completions
• Explicit request to optimize/compact

Optimization Workflow

Step 1: Assess Context State

Run the analyzer to get context metrics:
CODEBLOCK0

This reports:

• - Message count and approximate token count
• Age of oldest message
• Density score (signal vs noise)

Step 2: Identify Optimization Targets

Look for:

• - Old已完成 tasks with verbose logs
• Repeated explanations of same concept
• Off-topic tangents
• Raw tool outputs that could be summarized
• Decisions that should move to permanent memory

Step 3: Extract to Memory

Decisions → MEMORY.md or relevant project file:
CODEBLOCK1

Key facts → appropriate domain/project file:
CODEBLOCK2

Patterns → ~/self-improving/memory.md:
CODEBLOCK3

Step 4: Summarize Dense Segments

For long work sessions, create a summary instead of keeping all details:

CODEBLOCK4

Step 5: Archive, Don't Delete

Never delete context — archive it:

• - Move summaries to INLINECODE2
• Keep pointers in session for recovery
• Use [[archived:filename.md]] notation

Context Density Rules

Quick Commands

Files

• - scripts/analyze_context.py — Context metrics and optimization suggestions
• INLINECODE8 — Create session summary
• INLINECODE9 — Pull out decisions and key facts
• INLINECODE10 — Common summarization patterns