checkpoint

Checkpoint - Save Session Progress

Create a checkpoint of the current session: commit, push, PR, memory persistence, and feature archival.

Arguments: $ARGUMENTS

Session ID: ${CLAUDE_SESSION_ID} — session state lives in .claude-harness/sessions/${CLAUDE_SESSION_ID}/.

Phase 0: Set Paths

1. Set path variables:
   • FEATURES_FILE=".claude-harness/features/active.json"
   • ARCHIVE_FILE=".claude-harness/features/archive.json"
   • MEMORY_DIR=".claude-harness/memory/"
   • PROGRESS_FILE=".claude-harness/claude-progress.json"
   • SESSION_DIR=".claude-harness/sessions/${CLAUDE_SESSION_ID}/"

Phase 1: Update Progress

1. Update ${PROGRESS_FILE} with:
   • Summary of what was accomplished this session
   • Any blockers encountered
   • Recommended next steps
   • Update lastUpdated timestamp

Phase 1.6: Persist to Memory Layers (OKF bundle)

Memory layers are an OKF v0.1 bundle at ${MEMORY_DIR}: one markdown concept file per entry with YAML frontmatter (required type field), plus an index.md listing per directory. See schemas/okf-memory.md for the format.

1.6. Persist session decisions to ${MEMORY_DIR}/decisions/:

• For each key decision made during this session:
  • Write a concept file dec-{NNN}-{slug}.md (next NNN from existing files; slug = lowercased decision, non-alphanumerics as hyphens, <=48 chars):

    ---
    type: Decision
    id: dec-{NNN}
    title: "{what was decided, <=80 chars}"
    timestamp: {ISO timestamp}
    feature: {feature-id}
    ---
    
    # {full decision text}
    
    ## Rationale
    {why this decision was made}
    
    ## Alternatives
    - {other options considered}
    
    ## Impact
    {files or areas affected}
    

  • Append * [{id}: {title}](/decisions/{filename}) - {short description} to ${MEMORY_DIR}/decisions/index.md
• Rolling window: if more than 50 decision concepts exist, delete the oldest files and their index lines (FIFO)
• Report: "Recorded {N} decisions to episodic memory"