regression-io/flush

Flush Context to Resumable Doc

Save all current session context to .claude/session-context.md for seamless continuation.

When to Use

• Ending a work session
• Switching to a different task
• Before a long break
• When context is getting complex and you want a checkpoint
• User says "save context", "flush", "checkpoint", or similar

Process

Step 1: Find or Create .claude Directory

1. If .claude/ exists in current directory: Use it
2. If no .claude/ here: Search parent directories
   • If found in parent: Ask user which to use
   • If none found: Ask to create .claude/ here
3. If creating new .claude/: Offer to run /init for full project setup

Step 2: Create Session Summary

Summarize the session:

| Section | Content | |---------|---------| | Task Summary | What the user asked for | | Current State | completed / in-progress / blocked | | Key Decisions | Important choices and rationale | | Files Modified | What was created/changed | | Pending Work | What still needs to be done | | Important Context | Critical info for continuation |

Step 3: Write to File

Write to .claude/session-context.md in the chosen directory.

Output Format

# Session Context - YYYY-MM-DD

## Task Summary
[What the user wanted to accomplish]

## Current State
**[status]**
[Brief description]

## Key Decisions
- **[Decision]**: [Rationale]

## Files Modified
- `path/to/file` - [what changed]

## Pending Work
- [ ] Task 1
- [ ] Task 2

## Important Context
[Critical information for continuation]

Notes

• Session context is automatically loaded at session start via the session-start hook
• Keep summaries concise but complete enough to resume without re-reading code
• Focus on the "why" not just the "what"