---
title: Strategic Compact Skill for Claude Code
canonical: https://skillselion.com/skills/affaan-m/everything-claude-code/strategic-compact
content_type: text/markdown
description: strategic-compact is an agent skill for Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary.
---

# Strategic Compact Skill

Title: Strategic Compact Skill for Claude Code

> strategic-compact is an agent skill for Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary.

Canonical: https://skillselion.com/skills/affaan-m/everything-claude-code/strategic-compact

strategic-compact is an agent skill for Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction name strategic-compact description Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction Strategic Compact Skill Suggests manual compact at strategic points in your workflow rather than relying on arbitrary auto-compaction When to Activate Running long sessions that approach context limits 200K tokens Working on multi-phase tasks research plan implement test Switching between unrelated tasks within the same session After completing a major milestone and starting new work When responses slow down or become less coherent context pressure Why Strategic Compaction Auto-compaction triggers at arbitrary points Often mid-task losing important context No awareness of logical task boundaries Can interrupt complex multi-step operations Strategic compaction at logical boundaries After exploration before execution Compact research context keep implementation plan After completing a milestone Fresh start for next phase Before major context shifts Clear exploration context before diff.

## Key facts

- Installs: 6,861
- GitHub stars: 304,699
- Author: affaan-m
- Repository: affaan-m/ECC
- Install command: `npx skills add https://github.com/affaan-m/ECC --skill strategic-compact`
- Last updated: November 17, 2026

## What Strategic Compact does

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

When should developers use strategic-compact and what problem does it solve?

Grounded guidance and workflows from SKILL.md for strategic-compact.

Best for: Developers working with strategic-compact patterns described in the skill documentation.

Not for: Skip when cached docs are empty or the task is outside the skill's documented scope.

- Strategic Compact Skill
- Running long sessions that approach context limits (200K+ tokens)
- Working on multi-phase tasks (research → plan → implement → test)
- Switching between unrelated tasks within the same session
- After completing a major milestone and starting new work

## SKILL.md

## Strategic Compact Skill

Suggests manual `/compact` at strategic points in your workflow rather than relying on arbitrary auto-compaction.

### When to Activate

- Running long sessions that approach context limits (200K+ tokens)
- Working on multi-phase tasks (research → plan → implement → test)
- Switching between unrelated tasks within the same session
- After completing a major milestone and starting new work
- When responses slow down or become less coherent (context pressure)

### Why Strategic Compaction?

Auto-compaction triggers at arbitrary points:
- Often mid-task, losing important context
- No awareness of logical task boundaries
- Can interrupt complex multi-step operations

Strategic compaction at logical boundaries:
- **After exploration, before execution**  -  Compact research context, keep implementation plan
- **After completing a milestone**  -  Fresh start for next phase
- **Before major context shifts**  -  Clear exploration context before different task

### How It Works

The `suggest-compact.js` script runs on PreToolUse (Edit/Write) and combines two signals:

1. **Context size (primary)**  -  Reads the latest `usage` record from the session transcript (`transcript_path` in the hook payload) and sums `input_tokens + cache_read_input_tokens + cache_creation_input_tokens` (the true context size of the turn). Suggests `/compact` at a window-scaled threshold  -  160k tokens on a 200k window, 250k on a 1M window (detected from a `[1m]` model marker, or inferred when observed tokens already exceed 200k)  -  and re-reminds after every additional 60k tokens of context growth
2. **Tool-call count (secondary)**  -  Counts tool invocations in session; suggests at a configurable threshold (default: 50 calls), then every 25 calls after

### Hook Setup

Add to your `~/.claude/settings.json`:

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
      },
      {
        "matcher": "Write",
        "hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
      }
    ]
  }
}
```

### Configuration

Environment variables:
- `COMPACT_THRESHOLD`  -  Tool calls before first suggestion (default: 50)
- `COMPACT_CONTEXT_THRESHOLD`  -  Context tokens before the context-size suggestion (default: 160000 on a 200k window, 250000 on a 1M window; `0` disables the context signal)
- `COMPACT_CONTEXT_INTERVAL`  -  Additional context tokens before the suggestion repeats (default: 60000)

### Compaction Decision Guide

Use this table to decide when to compact:

| Phase Transition | Compact? | Why |
|-----------------|----------|-----|
| Research → Planning | Yes | Research context is bulky; plan is the distilled output |
| Planning → Implementation | Yes | Plan is in TodoWrite or a file; free up context for code |
| Implementation → Testing | Maybe | Keep if tests reference recent code; compact if switching focus |
| Debugging → Next feature | Yes | Debug traces pollute context for unrelated work |
| Mid-implementation | No | Losing variable names, file paths, and partial state is costly |
| After a failed approach | Yes | Clear the dead-end reasoning before trying a new approach |

### What Survives Compaction

Understanding what persists helps you compact with confidence:

| Persists | Lost |
|----------|------|
| CLAUDE.md instructions | Intermediate reasoning and analysis |
| TodoWrite task list | File contents you previously read |
| Memory files (`~/.claude/memory/`) | Multi-step conversation context |
| Git state (commits, branches) | Tool call history and counts |
| Files on disk | Nuanced user preferences stated verbally |

### Best Practices

1. **Compact after planning**  -  Once plan is finalized in TodoWrite, compact to start fresh
2. **Compact after debugging**  -  Clear error-resolution context before continuing
3. **Don't compact mid-implementation**  -  Preserve context for related changes
4. **Read the suggestion**  -  The hook tells you *when*, you decide *if*
5. **Write before compacting**  -  Save important context to files or memory before compacting
6. **Use `/compact` with a summary**  -  Add a custom message: `/compact Focus on implementing auth middleware next`

### Related

- [The Longform Guide](https://x.com/affaanmustafa/status/2014040193557471352)  -  Token optimization section
- Memory persistence hooks  -  For state that survives compaction
- `continuous-learning` skill  -  Extracts patterns before session ends

## Strategic Compact FAQ

### What does strategic-compact do?

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

### When should I invoke strategic-compact?

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

### Where is the source documentation?

Ground claims in SKILL.md excerpts and linked reference files from the cached docs.

### Is Strategic Compact safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

## Machine access

- [Sitemap](https://skillselion.com/sitemap.xml)
- [llms.txt](https://skillselion.com/llms.txt)
- [llms-full.txt](https://skillselion.com/llms-full.txt)
- [Developer resources](https://skillselion.com/developers)
- [OpenAPI spec](https://skillselion.com/openapi.json)
- [MCP handshake](https://skillselion.com/.well-known/mcp)
- [API catalog](https://skillselion.com/.well-known/api-catalog)
- [AI catalog](https://skillselion.com/.well-known/ai-catalog.json)
- [Pricing](https://skillselion.com/pricing.md)
- [Auth](https://skillselion.com/auth.md)
- [AGENTS.md](https://skillselion.com/AGENTS.md)
- [Contact](https://skillselion.com/contact)
- [Home](https://skillselion.com/)
