| 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
- Determine the current date for the filename (
session-YYYY-MM-DD.md)
- 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
- 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
- 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.
