void-checkpoint

Writes a session checkpoint file capturing dead ends, assumptions, and the next action before stopping work.

Updated May 29, 2026
One-click install
npx skills add https://github.com/voidcorp-core/void-harness --skill void-checkpoint-voidcorp-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: void-checkpoint
Source: https://github.com/voidcorp-core/void-harness/tree/main/packages/core/skills/void-checkpoint
Command: npx skills add https://github.com/voidcorp-core/void-harness --skill void-checkpoint-voidcorp-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a coding session ends, everything held only in context — why an approach was abandoned, which results are proven versus assumed, and what to do next — evaporates. The next session wastes an hour re-deriving state and often repeats dead ends the previous session already ruled out. ## Core Features & Use Cases - Fact routing triage: Directs each fact to its authoritative home (progress tracker, program file, diff, doctrine, or ADR) so the checkpoint only holds what nothing else records. - Structured handoff format: Writes .void/machine/checkpoint.md with sections for proven state, dead ends, labelled assumptions, open loops, and exactly one executable next action. - Freshness and quality checks: Converts time-relative references to absolute dates and commits, and self-tests whether a stranger could resume without asking questions. - Use Case: Before clearing context mid-task, invoke the skill to record that pnpm verify was green on commit a1b2c3d, that the caching approach failed because of stale invalidation, and that the next step is running a specific failing test. ## Quick Start Ask the agent to write a session checkpoint before clearing the context so the next session can resume without re-deriving anything.

Frequently Asked Questions about void-checkpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve context between AI coding sessions?

Write a checkpoint file before stopping that captures what is proven, what was tried and failed, labelled assumptions, and one exact next action. The next session reads this file instead of re-deriving state from the diff and tracker.

What should a session handoff note for an AI agent contain?

It should contain the branch and uncommitted state, which command proved what against which commit, dead ends with reasons they were abandoned, unverified assumptions, open blockers, and a single executable next action such as a specific test command.

Does the checkpoint duplicate my issue tracker or git history?

No. A routing step sends execution state to the progress tracker, design decisions to ADRs, and durable rules to doctrine first. The checkpoint keeps only what no other artefact holds, such as dead ends and assumptions.

When should I not write a session checkpoint?

Skip it when the work is genuinely finished with nothing open, since there is nothing to resume and the note becomes stale. It is meant for deliberate stops: before a clear, an interruption, or the end of a day.

Why does the checkpoint record the commit hash with test results?

A passing test run is a claim about a specific tree. After a rebase or dependency change that tree no longer exists, so the checkpoint binds each proof to its commit to prevent stale results being trusted.