checkpoints

Save and restore multi-phase CLI workflow progress via docs/checkpoints.

12|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/ovargas/virtual-team --skill checkpoints-ovargas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: checkpoints
Source: https://github.com/ovargas/virtual-team/tree/main/skills/checkpoints
Command: npx skills add https://github.com/ovargas/virtual-team --skill checkpoints-ovargas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Checkpoints provide a reliable way to preserve progress when a multi-phase command session is interrupted, enabling seamless resumption from the first incomplete phase.

Core Features & Use Cases

  • Maintains per-command progress across sessions by storing checkpoint data in docs/checkpoints/.
  • Defines phase state (pending, in_progress, done) and artifacts, decisions, and current state to resume accurately.
  • Supports fresh start, resume, and failure handling to guard against data loss in long-running workflows.

Quick Start

Create a new checkpoint for a given command and ID and begin the first phase, so the session can resume automatically after interruptions.

Frequently Asked Questions about checkpoints

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

FAQPage Schema
How do I resume a multi-phase CLI workflow after an interruption?▼

To resume a multi-phase CLI workflow, this Skill restores phase state by reading checkpoint data from docs/checkpoints, picking up accurately from the first incomplete phase to prevent data loss.

What is checkpoint persistence for long-running command sessions?▼

Checkpoint persistence is the mechanism of saving progress, artifact references, and phase state to docs/checkpoints so long-running vt commands survive interruptions and resume seamlessly.

How do I start a fresh checkpoint for a multi-phase command?▼

You start a fresh checkpoint by creating a new checkpoint entry for a given command and ID, which initializes the first phase state so the session can resume automatically if interrupted.

Does checkpoint resume require a specific version control setup?▼

Yes, checkpoint resume requires a stable git-backed workflow, consistent phase definitions in command files, and correct artifact references to reconstruct context accurately upon re-entry.

What phases are supported when saving and restoring CLI progress?▼

When saving and restoring CLI progress, supported phases include debug, epic, feature, plan, and implement, with each phase tracked as pending, in_progress, or done.

How are failure states handled during multi-phase workflow execution?▼

Failure states are handled by guarding against data loss, maintaining per-command progress across sessions, and storing decisions and current state to ensure robust resumption from the last incomplete phase.