hashgraph-online/awesome-codex-plugins / plugins/ariaxhan/kernel-claude/skills/checkpoint
checkpoint
UnverifiedSave bounded progress as kernel.checkpoint/v1 for exact resume after reset. Triggers: checkpoint, save progress, context reset, compact soon, long task.
When to fire (EXP-L21: attention efficiency decays to ~11% late-session; a reset from a checkpoint restores the flat ~50-70k load-bearing line):
- a long task crosses a natural boundary (a commit lands, a phase completes)
- context is about to compact, or the session is degrading (anchor-drift, I0.13)
- the manifest's execution.checkpoints list says so
Checkpoint vs handoff: same task + same session continuation → checkpoint. Ending the session / transferring to a future session with decisions and policy → handoff.
-
Write
_meta/checkpoints/{task}-{timestamp}.jsonper schemas/kernel.checkpoint.v1.schema.json:- task: goal + handoff_ref/contract_ref if they exist
- steps_completed: each with EVIDENCE (commit sha, test output, command result), never intent. Receipts describe intent; files describe reality.
- current_outputs: files produced so far
- provenance.dirty_tree_sha256: when dirty, sha256 of
git diff --binary HEAD - pending_steps: what remains, in order
- resume: position (exact place in the work), entrypoint (skill to re-enter), next_operation (the LITERAL first action — "retarget tests/run-tests.sh lines ~1250 registration tests", not "continue the migration")
- context (optional): required selectors + budget if the resume should be bounded
Quote every sha/commit string (all-digit shas parse as integers and fail validation).
-
Validate — MANDATORY:
"${CLAUDE_PLUGIN_ROOT:-.}/orchestration/manifest/kernel-manifest" validate _meta/checkpoints/{file}.json -
Record:
agentdb write-end '{"skill":"checkpoint","saved_to":"_meta/checkpoints/{file}.json","position":"..."}'
Resume path: /kernel:ingest discovers the newest manifest automatically
(kernel-manifest latest — checkpoints and handoffs share discovery), or accepts an
explicit path.
<hard_stops>
- steps_completed without evidence → not a checkpoint, a hope. Add evidence or move the step to pending_steps.
- unvalidated json → does not exist. Validate before reporting done. </hard_stops>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |