2.6 KiB
2.6 KiB
name, description
| name | description |
|---|---|
| strategic-compact | Systematic context compaction for AI agents — reduce conversation history while preserving critical information. Use when conversation is long, context window is tight, or before handing off to another agent. |
Strategic Compaction
Based on ECC strategic-compact skill.
When to Compact
- Conversation history exceeds 50% of context window
- Handing off to another agent (need condensed context)
- Long debugging session with many iterations
- Starting a new phase of work after long exploration
- Before spawning sub-agents (they get context via handoff)
Compaction Strategy
What to KEEP (high priority)
- User instructions and requirements
- Key decisions made and why
- Architecture/design choices
- Current state of work (what's done, what's next)
- Open questions and blockers
- File paths and code snippets that are actively being worked on
What to REMOVE (low priority)
- Intermediate debugging steps that led nowhere
- Multiple attempts that were superseded
- Raw tool output that's been summarized
- Conversational filler
- Explored alternatives that were rejected (keep only the final decision)
- Old scratch work
What to SUMMARIZE (medium priority, replace with brief summary)
- Long chain of reasoning → "Investigated X, found Y, decided Z because..."
- Multiple file reads → "Read 15 files in src/, key ones are A, B, C"
- Test output iterations → "Fixed 3 test failures: details in git log"
- API exploration → "Researched 3 libraries, chose X because..."
Compaction Output Format
## Context Summary — [date/time]
### Project: [name]
**Current goal**: [what are we working on right now]
**Status**: [where we are]
### Key decisions:
1. [Decision] because [reason]
2. [Decision] because [reason]
### Current state:
- Done: [completed items]
- In progress: [what's being worked on]
- Next: [what comes after]
- Blocked by: [if any]
### Relevant files:
- [path/to/file]: [brief description of role]
- [path/to/file]: [brief description of role]
### Open questions:
- [question]? — [status: answered/pending/needs-input]
### Code context (brief snippets if critical):
- [key function signature or interface definition]
Techniques
Before Compacting
- Write down everything important in a summary file
- Commit if possible (git provides history)
- Update any tracking files (MEMORY.md, memory/daily)
After Compacting
- Verify the summary has all key info
- Check that the next step is clear
- Ensure file paths and key names are preserved
- Test if you can continue work from the summary alone