C.W.K.
Stream
Lesson 01 of 05 · published

Checkpoint Before Compact

~26 min · checkpoint, compact, state

Level 0Window Watcher
0 XP0/50 lessons0/13 achievements
0/100 XP to next level100 XP to go0% complete

Checkpoint is explicit state capture

Compaction reduces context. A checkpoint preserves the operational truth before reduction. It names the current goal, files touched, decisions made, tests run, blockers, next action, and authority boundaries. Do this before the context is full, before switching tasks, before risky edits, and before handing to another model instance.

Verifiable beats vague

A good checkpoint contains exact paths, commit hashes, command results, and status. A vague checkpoint is just a diary with delusions of usefulness. The acid test: could a fresh instance, reading only the checkpoint and the current source, continue the work? If no, the checkpoint is incomplete.

Checkpoints accumulate, not replace

A new checkpoint does not delete the old one. Together they form an audit trail. The most recent is the operating truth; older ones are reference for how the project got here.

Code

Checkpoint template·markdown
# Checkpoint @ <timestamp>
- Goal:
- Current truth:
- Files changed (paths + last commit):
- Commands run + outcomes:
- Tests passed/failed:
- Decisions made:
- Authority boundaries (do-not list):
- Next action:
- Push/deploy status:
- Open questions:
Acid test·text
Read only the checkpoint and the current source files.
Could you, as a fresh instance:
  - know what the goal is?
  - know what is already done?
  - know what to do next?
  - know what NOT to do?
If any answer is no, the checkpoint is incomplete.

External links

Exercise

Write a checkpoint for a current or imagined coding task. Include at least two exact file paths and one authority boundary. Apply the acid test: could a fresh instance continue from it alone?
Hint
If a new instance could not continue from it, it is not a checkpoint yet.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.