Paste this at the end of an AI coding session to generate a narrative summary of what happened.
Works in Claude Code, OpenCode, Cursor, Windsurf, or any AI coding terminal that can write files.
Review this entire session and write a narrative summary of what happened.
Save it as a markdown file in session-logs/ with this format:
Filename: YYYY-MM-DD_HHMM_brief_description.md
Structure:
# [Descriptive title of the session]
**Date:** YYYY-MM-DD HH:MM
## What happened
[Write 300-600 words of narrative prose — not bullet points. Tell the story of
the session: what we set out to do, what we ran into, how we worked through it,
where we ended up. Include specifics: file names, error messages, tool names,
anything that helps someone pick up where we left off.
Capture the flow, not just the outputs. What did we try first? What didn't work?
What was the key insight? What trade-offs did we make and why?]
## Decisions made
- Decision and the reasoning behind it
- Another decision and why we chose it
## What's still open
- Thing that needs to happen next
- Thing we punted on and why
- Loose thread worth remembering
## Artifacts
- Files created or significantly modified (with paths)
- Config changes, deployments, anything that changed state
Guidelines:
- Be specific. Names, paths, versions, error messages. Vague logs are useless.
- The "What happened" section is the most important part.
- "Decisions made" should always include the WHY, not just the WHAT.
- Create the session-logs/ directory if it doesn't exist.