| name | smart-compact |
| description | Save session state to .claude/session-state.md for recovery after /clear.
Designed to be fast — required sections first, optional sections only when relevant.
Trigger: /smart-compact
|
| user-invocable | true |
Smart Compact
Save session state to file. User then runs /clear to reset.
The session-state.md is auto-read on next session start (via CLAUDE.md instruction).
Instructions
When the user runs /smart-compact:
- Write
.claude/session-state.md in the current working directory
- Tell the user it's done so they can
/clear
Speed principle: This should take ~10 seconds, not minutes. Write dense, not verbose.
Template
# Session State
> /smart-compact at [date/time]
## Tone
[One line. e.g. "Korean casual + English tech terms, concise"]
## What We Did
[Numbered list of what happened this session, chronologically. Keep each item to 1-2 lines.
Include: what was requested → what was done → outcome]
## Key Decisions
[Bullet list of decisions + WHY. Quote user's exact words for preferences.]
## Files
| File | What Changed |
|------|-------------|
| path | one-line summary with key function/variable names |
## Current Status
- [x] Done tasks
- [ ] In-progress (note current state)
- [ ] TODO
## Bugs & Fixes
[Only if any. "Problem → cause → fix" format, one line each.]
## Code Notes
[Only for tricky/non-obvious code that would be hard to reconstruct.
Paste ONLY the critical snippets, not whole files. Skip if nothing tricky.]
## Tech Context
[Key paths, model names, config values, env details. Dense bullet list.]
## Next Steps
[Priority-ordered. What to do immediately after recovery.]
Writing Guidelines
- Dense, not verbose — bullet points, not paragraphs
- Skip sections that are empty (except Tone, What We Did, Files, Current Status, Next Steps — always include these 5)
- Include specific names: variables, functions, paths, config values
- Quote user feedback verbatim when it matters
- For bugs: what didn't work is as important as what did
- Write for a new Claude that knows NOTHING about this conversation
Post-Clear Recovery
Project CLAUDE.md auto-reads .claude/session-state.md on session start. No manual action needed.
