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.