AC Context Compactor Skill

AC Context Compactor

Manage context usage and create compact summaries for session continuation.

Purpose

Monitors context usage and creates compact summaries when approaching limits, enabling seamless session continuation without losing critical information.

Quick Start

from scripts.context_compactor import ContextCompactor

compactor = ContextCompactor(project_dir)
if await compactor.should_compact():
    summary = await compactor.create_compact_summary()

Context Management

Context threshold: 85%
│
├── Below 85%: Continue normally
├── At 85%: Create compact summary
└── Above 90%: Force handoff

Compaction Strategy

Preserve: Critical state and progress
Summarize: Completed features
Extract: Key decisions and context
Compress: Verbose information

Summary Structure

{
  "session_summary": {
    "features_completed": ["auth-001", "auth-002"],
    "current_feature": "api-001",
    "progress_percentage": 45.5
  },
  "key_decisions": [
    "Using JWT for auth",
    "PostgreSQL for database"
  ],
  "active_context": {
    "current_file": "src/api/routes.py",
    "current_task": "Implementing user endpoint"
  },
  "next_actions": [
    "Complete user endpoint",
    "Add authentication middleware"
  ]
}

Integration

Used by: ac-session-manager for auto-continuation
Triggers: ac-handoff-creator when compacting

API Reference

See scripts/context_compactor.py for full implementation.

Agent Skills: AC Context Compactor

Install this agent skill to your local

Skill Files