Checkpoint Protocol

Checkpoint Protocol v2

Designed by Tila ⚡️ | Approved by Chris | 2026-02-27

Full Checkpoint (session end, /new, sprint end)

Before any session close, /new, handover request, or end-of-sprint — ALL steps are required:

1. Write HANDOVER.md — Overwrite using the exact template. Must contain all 5 sections.
2. Append daily log — Add session summary to memory/daily/YYYY-MM-DD.md.
3. Update HEARTBEAT.md — Refresh Now:, Next:, Blockers: if anything changed this session.
4. Update BASS tasks — Mark completed tasks as done, add new blockers as notes:

   bass task update <ID> '{"status":"done","agent":"<YourName>"}'

5. Self-verify — Read back HANDOVER.md. Confirm.
6. Emit receipt — Output the checkpoint receipt as your final message.

Quick Checkpoint (mid-session, ~30-min mark on long runs)

1. Overwrite HANDOVER.md only (current state)
2. Append progress note to daily log
3. No receipt required

Validation Script

Path: /home/chrisr6/.openclaw/bin/verify-checkpoint.sh

Fleet Deployment Checklist

Agent	Workspace	SOUL.md
main (Tila)	/home/chrisr6/.openclaw/workspace/	SOUL.md
frankel (Frankel)	/home/chrisr6/.openclaw/agents/frankel/workspace/	SOUL.md
vinyl (Vinyl)	/home/chrisr6/.openclaw/agents/vinyl/workspace/	SOUL.md
openclaw-support (Claw)	/home/chrisr6/.openclaw/agents/openclaw-support/workspace/	SOUL.md
cc-guru (CC Guru)	/home/chrisr6/.openclaw/agents/cc-guru/workspace/	SOUL.md
coach (Coach)	/home/chrisr6/.openclaw/agents/coach/workspace/	SOUL.md
dev (Dev)	/home/chrisr6/.openclaw/agents/dev/workspace/	SOUL.md
research (Scout)	/home/chrisr6/.openclaw/agents/research/workspace/	SOUL.md

All 8 agents follow the identical checkpoint protocol. The checkpoint section text is the same across all agents.

See Also

• Claude Code SOP — Build workflow guide
• Changelog — Protocol deployment history