Skip to content

[State Layer] Task Checkpoint System - Resumable Work Sessions #8

@gloomcheng

Description

@gloomcheng

Problem Statement

When developers interrupt AI mid-task:

  • 3 files modified, 2 remaining
  • Refactor half-complete
  • State is inconsistent

Coming back to continue is difficult - context is lost.

Proposed Solution

Checkpoint System

  1. Auto-checkpoint

    • Save state after each file modification
    • Track: files changed, files remaining, current approach
  2. Checkpoint Format

    {
      "task_id": "implement-auth",
      "checkpoint": "2025-01-15T10:30:00Z",
      "completed": ["src/auth.ts", "src/middleware.ts"],
      "pending": ["src/routes.ts", "tests/auth.test.ts"],
      "context": "Implementing JWT auth with refresh tokens",
      "next_step": "Add auth middleware to routes"
    }
  3. Resume Command

    • cortex resume - continue from last checkpoint
    • Restore full context and continue

Success Criteria

  • Tasks can be paused and resumed across sessions
  • No "where was I?" confusion
  • Consistent state maintained

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestlayer:stateState Layer - task checkpointspriority:highHigh priority item

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions