checkpoint

Checkpoint

Run this checklist at a clean breakpoint to hold continuity across sessions and compactions. Perform each step — do not just print the checklist. Create one todo per step (1–4) and work them in order.

Seat configuration (auto-loaded)

!`cat .checkpoint.config 2>/dev/null || cat .claude/checkpoint.config 2>/dev/null || echo "NO_CONFIG"`

Resolve these keys from the block above (fall back to the defaults, and tell the user which you used):

Key	Default	Meaning
LIVING_DOC	docs/DESIGN.md	The source-verified "how" doc you keep non-stale.
MEMORY_DIR	.claude/memory	Where durable memories live (one fact per file + MEMORY.md index).
COMMIT_MODE	offer	offer = propose the commit and wait for OK. auto = commit without asking.
COMMIT_CONVENTION	infer	infer from git log, or a freeform note overriding it.

If NO_CONFIG: use the defaults, name them to the user, and mention they can run the worked example in the plugin README to create .checkpoint.config once per seat.

Current state (auto-collected)

Outstanding work:

!`git status --short 2>/dev/null || echo "not a git repo"`

Recent commits — infer author, message style, and co-author policy from these (do not impose your own):

!`git log -8 --pretty='format:%an <%ae> | %s' 2>/dev/null || echo "no git history"`

The checklist

1. Commit outstanding work

• If there is nothing to commit, say so and skip.
• Match the repo's existing convention inferred from the log above: author, message style (imperative vs. scoped vs. conventional-commits), and co-author trailer policy. If the log shows no co-author trailers, do not add one; if it shows them, match the form.
• COMMIT_MODE=offer (default): stage the relevant changes, show the exact message you propose, and wait for approval. Do not commit until the user authorizes commits for this repo (in this session or via COMMIT_MODE=auto).
• COMMIT_MODE=auto: commit directly using the inferred convention.
• Never git push unless the user explicitly asks.