checkpoint

name	checkpoint
description	Update task tracking file with current progress. Essential for preserving context across sessions.

/checkpoint

Update task tracking file with current progress. Essential for preserving context across sessions.

Usage

/checkpoint [--summary "progress summary"]

Arguments

• --summary: Optional summary of recent progress

Instructions

When this skill is invoked:

Agent Behavior (Codex-Max Pattern)

Autonomy:

• Automatically detect the current task file from prd/00_index.md
• Update all relevant sections without prompting
• Create task file if one doesn't exist for a long-running feature

Thoroughness:

• Update task completion status
• Document any decisions made
• Note any blockers or issues
• Update "Next Session Priorities"

Steps

1. Find active task file:

   • Check prd/00_index.md for "In Progress" features
   • Locate corresponding prd/tasks/{feature}_tasks.md

2. Update task file sections:

   Tasks Section:

   • Mark completed tasks as [x]
   • Update in-progress tasks with current status
   • Add any new tasks discovered

   Progress Summary:

   • Update percentage complete for each phase
   • Note overall progress

   Next Session Priorities:

   • Update with immediate next steps
   • Ensure context is recoverable after compression

   Decisions Made:

   • Document any architectural or implementation decisions
   • Include rationale

3. Commit checkpoint (if requested):

   git add prd/tasks/
   git commit -m "chore: checkpoint - {summary}"
   

Task File Format

# {Feature} Tasks

## Context
High-level overview of what's being built.

## Key Decisions
- Decision 1: Rationale
- Decision 2: Rationale

## Tasks

### Phase 1: Setup
- [x] Task 1.1
- [x] Task 1.2
- [ ] Task 1.3 (in progress)

### Phase 2: Implementation
- [ ] Task 2.1
- [ ] Task 2.2

## Progress Summary
- Phase 1: 66% complete
- Phase 2: 0% complete
- Overall: 33% complete

## Next Session Priorities
1. Complete Task 1.3
2. Start Task 2.1
3. Review design for Phase 2

## Blockers
- None currently

## Session Log
### {Date}
- Completed: Task 1.1, 1.2
- Started: Task 1.3
- Notes: {Any relevant notes}

When to Use

Use /checkpoint:

• Every 30-60 minutes during active development
• Before taking a break
• After completing a significant milestone
• When switching to a different task
• Before context might be compressed

Don't need /checkpoint:

• For quick, single-session tasks
• When no task file exists and feature is simple

Example

$ /checkpoint --summary "Completed auth endpoints, starting tests"

📝 Updating task file: prd/tasks/user_auth_tasks.md

Updated sections:
✅ Tasks: Marked 3 tasks complete
✅ Progress: Phase 1 now 80% complete
✅ Next Session: Updated priorities
✅ Session Log: Added entry for 2026-01-15

Task file saved. Context preserved for next session.