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.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 27, 2025

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.
namerecording-diary
descriptionRecords 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.