Session Audit SOP
Goal
Capture what matters from a session:
- What we did - changes made, files modified
- Key decisions - choices and their rationale
- Important feedback - user corrections that shaped the work
- Patterns to remember - lessons for future sessions
Procedure
Name the file with date:
.claude/audits/YYYY-MM-DD-feature-name.md/bin/date +%Y-%m-%d # get current dateWrite audit following template: See TEMPLATE.md
Ensure feedback captures conversation flow - not just the end result, but the progression of corrections
If no feedback recorded, think carefully - most sessions have at least some course corrections worth noting
Summarize to user after writing: Report back with:
- Audit file name
- Key feedback points (quote the "Important Feedback" section)
- Patterns learned (list from "Patterns to Remember")
This ensures the user sees what was captured without having to open the file.
Note: Audit files are gitignored - don't commit them.