Prompt file imported from klu-dev/porting-ecc-to-vscode (
.github/prompts/save-session.prompt.md). Copyright stays with the author.
Capture everything that happened in this session and save it so the next session can pick up where this one left off.
Process
Step 1: Gather context
- Review files modified during this session (use git diff or recall from conversation)
- Review what was discussed, attempted, and decided
- Note errors encountered and how they were resolved (or not)
- Check current test/build status if relevant
Step 2: Write the session file
Save to .github/session-data/YYYY-MM-DD-<short-description>.md (create directory if needed).
Step 3: Populate all sections below
Write every section honestly. Do not skip — write "N/A" if empty. An incomplete file is worse than an honest empty section.
Session File Format
# Session: YYYY-MM-DD
**Project:** [project name or path]
**Topic:** [one-line summary]
## What We Are Building
[1-3 paragraphs with enough context for zero-memory resumption]
## What WORKED (with evidence)
- **[thing]** — confirmed by: [specific evidence]
## What Did NOT Work (and why)
- **[approach]** — failed because: [exact reason / error message]
## What Has NOT Been Tried Yet
- [approach / idea]
## Current State of Files
| File | Status | Notes |
|------|--------|-------|
| `path/to/file` | Complete / In Progress / Broken / Not Started | [details] |
## Decisions Made
- **[decision]** — reason: [why]
## Blockers & Open Questions
- [blocker or question]
## Exact Next Step
[The single most important thing to do when resuming]
Step 4: Show the file to the user
After writing, display contents and ask: "Does this look accurate? Anything to correct?"
Rules
- Each session gets its own file — never append to previous
- "What Did NOT Work" is the most critical section — prevents retrying failed approaches
- The file is meant to be read at the start of the next session via
/resume-session