vibe-session-context-flush

name	vibe-session-context-flush
description	Performs smart context summarization when the context window is approaching capacity. Identifies what to keep, what to summarize, and creates a compact resume state.
user-invocable	true

vibe-session-context-flush

Context windows have limits. This skill manages the transition gracefully instead of letting context degrade silently.

When to Use This Skill

• You notice responses getting less coherent or losing track of earlier context
• You've been working for a long session with many file reads
• The system indicates context compression is occurring
• Before starting a new major subtask in a long session

When NOT to Use This Skill

• Short sessions with plenty of context room
• When the user wants to continue without interruption
• When you just started the session

Steps

1. Assess current context — What's consuming context?

   • Large file reads that are no longer relevant
   • Completed subtask details that can be summarized
   • Exploration results that led to dead ends
   • Verbose tool outputs

2. Triage into:

   • Keep — Still actively needed (current task state, open files, error messages)
   • Summarize — Completed work (compress to 2-3 sentences each)
   • Drop — No longer relevant (old file contents, superseded plans)

3. Create compact state:

   ## Session State (Flushed)
   **Current task**: [what we're doing]
   **Branch**: [current branch]
   **Modified files**: [list]
   **Completed**: [summary of done work]
   **Key decisions**: [1-liner each]
   **Next step**: [immediate next action]
   **Important context**: [anything that must be preserved]
   

4. Offer to the user — "Context is getting large. Here's a compact state. Want me to continue with this summary, or start a new session with the handover doc?"

Output Format

Context Flush Summary

Context pressure: High / Medium Items summarized: X Items dropped: Y

[Compact state block as above]

Recommendation: Continue with summary / Start new session with /vibe-handover-doc