checkpoint

name	checkpoint
description	Save current session context to a markdown file for recovery after compaction or across sessions
invocation	user
user_invocation	/checkpoint

Checkpoint Context

Save a snapshot of the current working context to .claude/agentic-rig/context/.

Steps

1. Determine the current date for the filename (session-YYYY-MM-DD.md)
2. Gather context:
   • Current task description (from conversation or plan files)
   • Key decisions made during this session
   • Files modified (from git status and git diff --name-only)
   • Progress on current work (completed steps, remaining steps)
   • Current milestone being worked on (from docs/BUILD-PLAN.md)
   • Any important notes or context that should survive compaction
3. Check if a context file already exists for today
   • If yes, update it (append or replace sections as appropriate)
   • If no, create a new file
4. Write to .claude/agentic-rig/context/session-YYYY-MM-DD.md

Format

Use the standard context file format:

• ## Current Task — one-line description
• ## Milestone — current milestone ID and name
• ## Key Decisions — bulleted list of decisions with rationale
• ## Files Modified — bulleted list of changed files with brief notes
• ## Progress — checklist of steps (completed and remaining)
• ## Notes — any additional context

Keep concise — aim for under 40 lines. This is a snapshot, not a full log.