recording-diary
Records session learnings and decisions before context compaction. Use before ending a long session or when the user asks to save session notes.
When & Why to Use This Skill
The recording-diary Claude skill is a specialized memory management tool designed to capture and persist critical session insights, technical decisions, and project-specific 'gotchas' before context compaction occurs. By systematically documenting learnings into structured markdown files, it ensures long-term continuity and prevents the loss of high-signal information during extended AI interactions, effectively bridging the gap between separate chat sessions.
Use Cases
- Preserving project context during long-form development sessions to prevent the AI from repeating past mistakes or forgetting specific architectural decisions after context window resets.
- Documenting technical workarounds, 'dead ends', and project-specific quirks encountered during complex debugging tasks to build a persistent local knowledge base.
- Facilitating seamless project handovers or session restarts by consolidating multiple diary entries into a high-signal summary of progress and open questions.
- Automating the recording of 'useful commands' and environment setup steps discovered during a session for future reproducibility.
| name | recording-diary |
|---|---|
| description | Records session learnings and decisions before context compaction. Use before ending a long session or when the user asks to save session notes. |
- Before compaction or session end, write `diary_{YYYY-MM-DD_HH-MM}.md` to `./.{AGENT_NAME}/skills/memories/` via `$writing-memories`.
Gotchas:
-
Workarounds:
-
Useful commands:
-
Dead ends:
-
Project quirks:
-
Open questions:
-
If more than 5 diary entries exist, merge them into `diary-consolidated.md`, keeping only high-signal items. Delete the older entries after consolidation.
- Nothing new learned -> skip the diary.
- Many related notes -> consolidate immediately.
- Time format unclear: use local time or `date` output.
- Memory dir missing: create it before writing.