strategic-compact

Strategic compact preserves context by tracking tool calls and prompting manual compaction at defined thresholds rather than auto-compacting. It monitors progression through exploration, planning, and execution phases, issuing reminders every 25 calls after reaching your threshold (default 50) to clear context at logical milestones.

Compact context after exploration completes, before major execution shifts, or after milestone completion. Strategic compact tracks your tool-call count and suggests compaction at regular intervals—after 50 calls initially, then every 25 calls thereafter—ensuring clarity without losing track of progress.

Yes. Strategic compact uses a configurable COMPACT_THRESHOLD (default 50 calls) to trigger initial prompts, then issues reminders every 25 calls after that threshold. Adjust the threshold in the suggest-compact.sh script to match your workflow's complexity and context budget.

Strategic compact implements a PreToolUse hook that counts each tool call within your session. It evaluates the count against your threshold and invokes the suggest-compact.sh script to prompt manual compaction at regular intervals, preserving visibility into your progression.

Automatic compaction clears context without notice, risking loss of relevant details. Manual compaction via strategic compact gives you control—you decide when to compress, preserving task continuity and retaining context you choose to keep at defined milestones.

Strategic compact integrates via PreToolUse hooks, a standard workflow mechanism. It runs alongside existing automation without dependencies, making it compatible with any workflow that supports hook-based tool-call monitoring during exploration, planning, and execution phases.