/save-session — persist progress
Goal: a future session (or a fresh context) can pick up exactly where this left off.
File location
- Inside a git repo:
.claude/sessions/<YYYY-MM-DD>.md(append across the day). - Otherwise:
~/.claude/harness-claude/sessions/<YYYY-MM-DD>.md.
Create the directory if needed. Append to today's file; don't pollute it with old work — start a new dated file per day.
What to write (evidence-based, not aspirational)
# Session <date> — <project/feature>
## Goal / current objective
## What works (verified, with evidence: test names, commands, screenshots)
## What was tried and did NOT work (so we don't repeat it)
## Not yet attempted / remaining (the next concrete steps)
## Key decisions & files touched
## Open questions / blockers
How
- Summarize honestly: distinguish verified from assumed.
- Append (don't overwrite) under a timestamped subheading.
- Tell the user the file path so they can review/edit it.
This skill is also invoked automatically by the PreCompact and Stop hooks — keep the format stable so those writes stay consistent.