SKILL·10E395

checkpoint-mode

asklokesh
Updated Yesterday
1,090
206
1,090
View on GitHub
Othergeneral

About

This skill implements selective autonomy by pausing for user review after completing a configurable number of tasks. It's designed for novel projects or high-cost operations to prevent wasted resources and allow course correction. Developers should use it to maintain feedback loops within longer autonomous work sessions.

Quick Install

Claude Code

Recommended
Primary
npx skills add asklokesh/claudeskill-loki-mode -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/asklokesh/claudeskill-loki-mode
Git CloneAlternative
git clone https://github.com/asklokesh/claudeskill-loki-mode.git ~/.claude/skills/checkpoint-mode

Copy and paste this command in Claude Code to install this skill

Documentation

Checkpoint Mode Skill

Overview

Implements selective autonomy - shorter bursts of autonomous work with feedback loops.

Research Source: "Use Agents or Be Left Behind" by Tim Dettmers


Philosophy

"More than 90% of code should be written by agents, but iteratively design systems with shorter bursts of autonomy with feedback loops."

  • Tim Dettmers, 2026

Problem with Perpetual Autonomy:

  • Can waste resources on wrong approach
  • No opportunity for course correction
  • User feels disconnected from progress

Solution:

  • Pause after N tasks or M minutes
  • Generate summary of accomplishments
  • Wait for explicit approval to continue

When to Use

Use Checkpoint Mode For:

  • Novel projects where approach may need adjustment
  • High-cost operations (expensive API calls, cloud resources)
  • Learning phases where user wants to guide direction
  • Regulated environments requiring audit trail

Use Perpetual Mode For:

  • Well-defined PRDs with clear requirements
  • Established patterns with high confidence
  • Overnight builds where interruption isn't desired
  • CI/CD pipelines requiring full automation

Configuration

# Enable checkpoint mode
LOKI_AUTONOMY_MODE=checkpoint

# Pause frequency
LOKI_CHECKPOINT_FREQUENCY=10  # tasks
LOKI_CHECKPOINT_TIME=60  # minutes

# Always pause after these phases
LOKI_CHECKPOINT_PHASES="architecture,deployment"

Checkpoint Workflow

[Work on 10 tasks] → [Pause] → [Generate Summary] → [Wait for Approval]
                                                           ↓
                                              [User reviews and approves]
                                                           ↓
                                                    [Resume work]

On Checkpoint:

  1. Generate Summary

    # Checkpoint Summary
    
    ## Tasks Completed (10)
    - Implemented POST /api/todos endpoint
    - Added unit tests (95% coverage)
    - Set up CI/CD pipeline
    - ...
    
    ## Next Actions
    - Deploy to staging
    - Run integration tests
    - Security audit
    
    ## Resources Used
    - 15 minutes elapsed
    - 3 Haiku agents, 2 Sonnet agents
    - Estimated cost: $0.45
    
  2. Create Approval Signal

    # System writes:
    .loki/signals/CHECKPOINT_SUMMARY_2026-01-14-10-30.md
    
    # User reviews and creates:
    .loki/signals/CHECKPOINT_APPROVED
    
  3. Wait for Approval

    • Orchestrator pauses execution
    • Monitors for approval signal
    • Resumes when signal detected

Agent Instructions (Orchestrator)

When LOKI_AUTONOMY_MODE=checkpoint:

completed_tasks = load_completed_tasks()
tasks_since_checkpoint = completed_tasks - last_checkpoint_count

if tasks_since_checkpoint >= CHECKPOINT_FREQUENCY:
    # Pause and generate summary
    summary = generate_checkpoint_summary()
    write_signal("CHECKPOINT_SUMMARY", summary)

    # Wait for approval
    log_info("Waiting for checkpoint approval...")
    while not signal_exists("CHECKPOINT_APPROVED"):
        sleep(5)

    # Resume work
    remove_signal("CHECKPOINT_APPROVED")
    log_info("Checkpoint approved. Resuming work...")
    last_checkpoint_count = completed_tasks

Comparison with Other Modes

ModeBest ForApproval FrequencyUse Case
PerpetualOvernight buildsNeverFully automated CI/CD
CheckpointNovel projectsEvery 10 tasksLearning new domain
SupervisedCritical systemsEvery taskProduction deployments

Metrics

Track checkpoint effectiveness:

{
  "checkpoint_id": "cp-2026-01-14-001",
  "tasks_completed": 10,
  "time_elapsed_minutes": 15,
  "approval_time_seconds": 45,
  "course_corrections": 0,
  "user_satisfaction": "approved_without_changes"
}

Storage: .loki/metrics/checkpoint-mode/


References


Version: 1.0.0

GitHub Repository

asklokesh/claudeskill-loki-mode
Path: examples/agent-skills/checkpoint-mode
0
ai-agentsai-coding-agentsai-coding-toolsanthropicautonomous-agentsclaude
FAQ

Frequently asked questions

What is the checkpoint-mode skill?

checkpoint-mode is a Claude Skill by asklokesh. Skills package instructions and resources that Claude loads on demand, so Claude can perform checkpoint-mode-related tasks without extra prompting.

How do I install checkpoint-mode?

Use the install commands on this page: add checkpoint-mode to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does checkpoint-mode belong to?

checkpoint-mode is in the Other category.

Is checkpoint-mode free to use?

Yes. checkpoint-mode is listed on AIMCP and free to install.

Related Skills

sports-betting-analyzer
Other

This Claude Skill analyzes sports betting markets including spreads, over/unders, and prop bets by examining historical trends and situational statistics to identify value bets. It provides structured markdown output with actionable recommendations for educational purposes. Developers should use this for sports betting analysis tools while noting it's designed for entertainment/education only.

View skill
llamaguard
Other

LlamaGuard is Meta's 7-8B parameter model for moderating LLM inputs and outputs across six safety categories like violence and hate speech. It offers 94-95% accuracy and can be deployed using vLLM, Hugging Face, or Amazon SageMaker. Use this skill to easily integrate content filtering and safety guardrails into your AI applications.

View skill
cost-optimization
Other

This Claude Skill helps developers optimize cloud costs through resource rightsizing, tagging strategies, and spending analysis. It provides a framework for reducing cloud expenses and implementing cost governance across AWS, Azure, and GCP. Use it when you need to analyze infrastructure costs, right-size resources, or meet budget constraints.

View skill
quantizing-models-bitsandbytes
Other

This skill quantizes LLMs to 8-bit or 4-bit precision using bitsandbytes, achieving 50-75% memory reduction with minimal accuracy loss. It's ideal for running larger models on limited GPU memory or accelerating inference, supporting formats like INT8, NF4, and FP4. The skill integrates with HuggingFace Transformers and enables QLoRA training and 8-bit optimizers.

View skill