dev-checkpoint

Original：🇺🇸 English
Translated

Save progress and generate a continuation prompt. Updates PRD status markers, captures git state, and writes checkpoint.md for the next session.

4installs
Sourceandreaserradev-gbj/dev-workflow
Added on

NPX Install

npx skill4agent add andreaserradev-gbj/dev-workflow dev-checkpoint

Tags

Translated version includes tags in frontmatter
checkpoint-managementprd-updatesgit-state-capturesession-continuationdev-workflow

SKILL.md Content

View Translation Comparison →

Checkpoint Current Session

Review the current session and create a continuation prompt for the next session.

SAVE-ONLY MODE

This skill analyzes and saves. It does NOT fix, investigate, or implement anything.
  • Do NOT investigate bugs or errors mentioned during the session
  • Do NOT start implementing fixes or next steps
  • Do NOT move to the next phase or task
  • If the user mentions bugs during confirmation (Step 6), note them in 
    <blockers>
    or 
    <notes>
    but do NOT attempt to fix them

Step 0: Determine Project Root

Before proceeding, determine the project root directory:
  1. If this is a git repository, use: 
    git rev-parse --show-toplevel
  2. If not a git repository, use the initial working directory from the session context (shown in the environment info at session start)
Store this as 
$PROJECT_ROOT
and use it for all 
.dev/
path references throughout this skill.

Step 1: Identify the Active Feature

First, check if a 
$PROJECT_ROOT/.dev/
directory exists. If it does not exist, ask the user to specify the feature name and create the 
$PROJECT_ROOT/.dev/<feature-name>/
directory before proceeding.
If 
$PROJECT_ROOT/.dev/
exists, find all available features:
bash
find "$PROJECT_ROOT/.dev" -maxdepth 1 -type d ! -name .dev
If an argument was provided (
$ARGUMENTS
):
  • Filter the feature list to those whose name contains the argument (case-insensitive match)
  • If exactly one match: use that feature
  • If multiple matches: ask which of the matching features to checkpoint
  • If no matches: inform the user that no features match "$ARGUMENTS" and list all available features
If no argument was provided:
  • If multiple features exist: ask "Which feature would you like to checkpoint?" and list the available features
  • If only one feature exists: use that one
  • If no features exist: ask the user to specify the feature name
The checkpoint will be saved to 
$PROJECT_ROOT/.dev/<feature-name>/checkpoint.md
.

Step 2: Analyze Session with Agent

Launch the checkpoint-analyzer agent to scan PRD files and the current session:
"Analyze the PRD files in $PROJECT_ROOT/.dev/<feature-name>/ and the current session.
Find: completed items (⬜ → ✅), pending items, decisions made, blockers encountered.
Determine current phase and next step."
Use 
subagent_type=dev-workflow:checkpoint-analyzer
and 
model=haiku
.

Step 3: Review Agent Findings

After the agent returns:
  1. Verify accuracy — Check that completed/pending items match what happened
  2. Add missing context — Include any decisions or blockers the agent missed

Step 4: Update PRD Status Markers (REQUIRED)

For each PRD file in 
.dev/<feature-name>/
:
  1. Read the file
  2. Change 
    ⬜
    to 
    ✅
    for completed items; update "Status" fields
  3. Save changes
Track what was updated (file + markers changed) — reported in Step 9.
If nothing was completed, state: "No PRD updates needed."

Step 5: Capture Git State

If git repo, run 
git branch --show-current
, 
git log --oneline -1
, and 
git status --short
. Store for checkpoint frontmatter.
If not a git repo, skip and omit 
branch
, 
last_commit
, 
uncommitted_changes
from frontmatter.

Step 6: Confirm Session Context

Present the agent's findings (decisions, blockers, notes) and ask: "I captured these from our session—correct me if I missed anything or got something wrong."
If a category is empty, omit it.
STOP. Wait for explicit confirmation before proceeding to Step 7. If the user mentions new bugs or issues during this step, add them to the checkpoint notes — do NOT investigate or fix them.

Step 7: Generate Continuation Prompt

Rules:
  • Always include 
    <context>
    , 
    <current_state>
    , 
    <next_action>
    , 
    <key_files>
    . Omit 
    <decisions>
    , 
    <blockers>
    , 
    <notes>
    if empty.
  • No absolute paths with usernames → use relative paths. No secrets/credentials → use placeholders.
Create a continuation prompt following the template in checkpoint-template.md.

Step 8: Save Checkpoint

Write the continuation prompt to 
$PROJECT_ROOT/.dev/<feature-name>/checkpoint.md
. Create the file if it doesn't exist, or overwrite it completely if it does.

Step 9: Summary

Report:
  • Which feature was checkpointed
  • PRD updates made (list each file and what was changed, or state "No updates needed")
  • What the next steps are
  • Confirm the checkpoint location