| name | checkpoint |
| description | Save session state before context gets full or before ending. Writes current task state, branch, and loaded docs to brain/tasks/todo.md so the next session can resume cleanly. |
Checkpoint Skill
Save session state for clean handoff to the next session.
When to use
- Context window is getting full (preemptively)
- Before ending a session with work in progress
- Before a long-running operation that might reset context
Protocol
1. Record current state in brain/tasks/todo.md
# Task: <current task title>
_Checkpointed: {{DATE}}_
**Goal:** <what done looks like>
**Branch:** <output of: git branch --show-current>
**Loaded docs:** brain/architecture.md, brain/rules.md, [others read this session]
## Completed Steps
- [x] 1. <step>
- [x] 2. <step>
## Remaining Steps
- [ ] 3. <next action — be specific>
- [ ] 4. <step>
## Next Action
> <Single most important thing to do when resuming>
## Uncommitted Files
<output of: git status --short | head -20>
## Notes
<Any constraints, blockers, or decisions made this session>
2. Update brain/tasks/lessons.md
If any corrections or new patterns were discovered this session, add them NOW.
3. Confirm to user
"Session state saved to brain/tasks/todo.md. To resume: use $resume."
Rules
- NEVER checkpoint without writing the Next Action explicitly
- NEVER skip lessons.md update if corrections were made
- Checkpoint early — better to checkpoint too often than to lose context
