teds-checkpoint

Create TEDS Checkpoint

Create an immediate checkpoint in the currently active TEDS task.

Usage

/teds-checkpoint [optional-task-id]

Examples

# Create checkpoint in current task context
/teds-checkpoint

# Create checkpoint for specific task
/teds-checkpoint 20250116-1430-refactor-auth

What is a Checkpoint?

A checkpoint is a safe pause point that captures:

• Current phase and progress percentage
• Summary of what has been accomplished
• What remains to be done
• Timestamp for recovery reference

Think of it as a "save game" point—you can safely stop work and resume from here later.

What This Does

The agent will:

1. Review recent work from execution_log.md
2. Assess current progress
3. Add checkpoint entry to execution_log.md:

   ### [HH:MM] - CHECKPOINT
   - Phase: [current phase]
   - Progress: [X%]
   - Summary: [accomplishments]
   - Next: [what remains]
   

4. Update last_checkpoint in status.yaml
5. Confirm: "Checkpoint created. Safe to pause here."

Automatic Checkpoints

The executor agent automatically creates checkpoints:

• Every 30+ minutes of active work
• At completion of major milestones
• When transitioning between phases

Manual checkpoints are useful when:

• You want to pause before the automatic interval
• You've reached a logical stopping point
• You're about to try something risky
• You're switching focus to another task

Checkpoint Best Practices

Good times to checkpoint:

• ✅ Just completed a significant feature
• ✅ About to refactor or make large changes
• ✅ End of work session
• ✅ Before switching context

Don't checkpoint:

• ❌ In the middle of an incomplete action
• ❌ When build/tests are failing
• ❌ When blocked and unsure how to proceed (mark as blocked instead)

Viewing Checkpoints

To see all checkpoints in a task:

# View full execution log
cat workspace/active_tasks/[task-id]/execution_log.md | grep "CHECKPOINT"

Or use:

/teds-status [task-id]

This shows the last checkpoint time.