Smart context compaction with state preservation. Saves critical files, task progress, and working state before compaction, restores after. Use before manual compact or when auto-compact triggers.
git clone https://github.com/rohitg00/pro-workflow.git--- name: compact-guard description: Smart context compaction with state preservation. Saves critical files, task progress, and working state before compaction, restores after. Use before manual compact or when auto-compact triggers. user-invocable: true --- # Compact Guard Protect important context through compaction cycles. Based on Claude Code internals: compaction restores max 5 files with 5K tokens each, within a 50K total budget. ## Trigger Use before `/compact` or when auto-compact warning appears. ## Key Constants (from Claude Code source) - `POST_COMPACT_MAX_FILES_TO_RESTORE = 5` — only 5 files survive - `POST_COMPACT_TOKEN_BUDGET = 50K` — total restore budget - `POST_COMPACT_MAX_TOKENS_PER_FILE = 5K` — per-file limit - Auto-compact fires at `context_window - 13K` buffer ## Pre-Compact Checklist Before compacting, save these to memory or a scratch file: 1. **Current task** — What are you working on? One sentence. 2. **Files in progress** — Which files are being edited? (max 5 — compaction only restores 5) 3. **Decisions made** — Any architectural choices made this session 4. **Blockers** — What's preventing progress? 5. **Next steps** — What to do immediately after compact ## Strategy: Microcompact First Before full compaction, try microcompact: - Large tool results (test output, grep results) can be trimmed - File reads that are no longer relevant can be dropped - Use subagents for heavy exploration to keep main context clean ## Post-Compact Recovery After compaction, immediately: 1. Re-read the top-priority file (the one you're actively editing) 2. Check task list for current progress 3. Review any scratch notes saved pre-compact 4. Resume from next steps ## Prevention Strategies | Strategy | Token Savings | When | |----------|--------------|------| | Delegate grep/search to subagent | 30-60% per search | Always for broad searches | | Read only needed lines (`offset`/`limit`) | 50-90% per read | Large files | | Compact at task boundaries | Preserves coherence | Between logical steps | | Use `/resume` for fresh start | 100% | Unrelated new task | ## Output After running compact-guard: ```text COMPACT GUARD Files to preserve: [list top 5] Task state: [one sentence] Decisions: [key choices] Next step: [immediate action after compact] Ready to compact. Run /compact now. ``` ## Rules - Always save state before compacting — never compact blind - Prioritize the file you're actively editing as #1 to restore - If auto-compact fires unexpectedly, immediately re-read your working file - Keep CLAUDE.md under 60 lines to leave room for actual context
[{"step":"Identify critical files and tasks to preserve before compaction. Use `ls -la` or your IDE's file explorer to list files, and `git status` or task management tools to check progress.","tip":"Focus on files and tasks that are actively being worked on or are critical to the current workflow. Avoid including large or irrelevant files to keep the state compact."},{"step":"Run the compact-guard skill with the identified files, tasks, and working state. Use the prompt template to generate a ready-to-use prompt for your AI tool.","tip":"Be specific with file paths and task IDs. Include details like last modified timestamps or subtask progress to ensure accurate restoration."},{"step":"Execute the compaction process in your tool (e.g., `/compact` in Claude or `context_compact()` in other tools). Wait for the compaction to complete.","tip":"Monitor the compaction process to ensure it completes without errors. If the tool supports it, check the compaction log for warnings."},{"step":"After compaction, restore the saved state using the compact-guard skill. Verify the integrity of files, tasks, and working state.","tip":"Compare file sizes, timestamps, and task statuses before and after compaction. Check IDE tabs and terminal processes to ensure everything is restored correctly."},{"step":"If discrepancies are found, manually restore missing or corrupted elements and report the issue to the tool's support team.","tip":"Keep a backup of the pre-compaction state in case manual restoration is needed. Document any issues for future reference."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/rohitg00/pro-workflow/tree/main/skills/compact-guardCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Before compacting the context in [TOOL_NAME], run the compact-guard skill to preserve critical files, task progress, and working state. Save the following: [LIST_FILES_OR_TASKS], [WORKING_STATE_SUMMARY]. After compaction, restore the saved state and verify integrity. Report any discrepancies or missing elements.
### Compact-Guard State Preservation Report
**Pre-Compaction State Saved:**
- **Critical Files:**
- `/workspace/project/src/main.py` (last modified: 2024-05-15 14:30:00, size: 12.4 KB)
- `/workspace/project/docs/requirements.txt` (last modified: 2024-05-14 09:15:00, size: 3.2 KB)
- `/workspace/project/tests/test_integration.py` (last modified: 2024-05-13 16:45:00, size: 8.7 KB)
- **Task Progress:**
- **Task ID:** T-2024-05-15-001
- Description: Implement OAuth2 authentication flow
- Status: 85% complete (3 subtasks remaining: token validation, error handling, and refresh logic)
- Last checkpoint: Added `/auth/token` endpoint (2024-05-15 13:20:00)
- **Task ID:** T-2024-05-14-002
- Description: Optimize database query performance
- Status: 60% complete (2 subtasks remaining: index tuning and query refactoring)
- Last checkpoint: Added composite index on `user_id` and `created_at` (2024-05-14 11:10:00)
- **Working State:**
- Open tabs in IDE: `main.py`, `requirements.txt`, `test_integration.py`
- Unsaved changes in `main.py`: Added `validate_token()` function (5 lines)
- Terminal state: Running `pytest tests/test_integration.py` (PID: 12345, started at 2024-05-15 14:25:00)
**Post-Compaction Verification:**
- All critical files restored with no corruption. File sizes and timestamps match pre-compaction state.
- Task progress restored: Both tasks (T-2024-05-15-001 and T-2024-05-14-002) are in the same state as before compaction.
- Working state restored: IDE tabs reopened, unsaved changes in `main.py` preserved, terminal process restarted.
- **Discrepancies:** None detected. Compaction completed successfully with full state preservation.skills-collection
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan