session-save

/session-save — Save Session State

Save current session state before closing or when context gets heavy (>150K tokens).

Arguments

• [name] — optional checkpoint name. Auto-generated if not provided.

Steps

1. Analyze this session as a self-improvement signal: before summarizing, walk back through this session and read it as friction data (like /reflect Step 1b, but over the CURRENT dialogue): how the user responded (tone, corrections, what they valued, what frustrated them), and where the agent missed, substituted, failed to orient, or added noise. → new anti-pattern / learned / identity refinements, tagged with a source-tier. Don't bulk-load the transcript — reflect over what is already in context.

2. Summarize what was done — scope = ALL un-persisted work since the last commit, NOT just the current salient task:

   • First scan for orphans: git log --oneline -5 vs. substantive work that exists only in the transcript/compaction-summary. Anything analyzed-but-never-written-to-a-file → fixate it in this save. Work done before a /compact is the most likely orphan — explicitly verify it got persisted.
   • Key decisions made
   • Files created/modified
   • Insights discovered
   • What remains to be done

3. Extract knowledge — if any new entities, facts, or connections were discovered:

   • Create or update files in knowledge/{type}/ with [[wikilinks]]
   • Only for genuinely new, reusable knowledge — not session-specific noise

4. Update shared state:

   • Update state/current.md with session results
   • Append to daily/{today}.md with session summary (2-3 lines)

5. Track learnings:

   • If any anti-patterns were triggered → append to context/anti-patterns.md
   • If any new lessons learned → append to context/learned.md

6. Save checkpoint to state/sessions/{name}.md:

   ---
   type: session-checkpoint
   date: {today}
   ---
   # {name}
   
   ## Done
   {what was accomplished}
   
   ## Remaining
   {what still needs to be done}
   
   ## Key Files
   {files that were created or modified}
   
   ## Continue With
   {prompt to resume this work in a new session}