agentleFS
dongshuyandongshuyan/compass-skills/skills/pause-and-resume/SKILL.md

pause-and-resume

Skill764 starsChanged 3 months agoMITView on GitHub

Cooperatively pause unfinished work in the current session, leave a precise continuation checkpoint, and resume from it when the user later says continue. Use only when the user explicitly requests this pause workflow. Do not use for crashes, app shutdown, new-session handoffs, or ordinary task summaries.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 6 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep this workflow in the current session.

    line 13
  2. Distinctive:

    Stop expanding the task. Do not begin another subtask, retry, or optional check.

    line 18
  3. Distinctive:

    If work continues independently, record its handle, observed status, and how to reconcile it.

    line 27
  4. Distinctive:

    Keep the marker exact, omit irrelevant detail, and state explicitly when there is no known non-repeatable effect.

    line 31
  5. Distinctive:

    If there is no unfinished task, say so and stop without emitting an active checkpoint.

    line 49
  6. Distinctive:

    When the user later asks to continue the paused work:

    line 54
  7. Very specific:

    Use the newest unconsumed PAUSE_CHECKPOINT: ACTIVE in this session.

    line 56

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Pause and Resume

Keep this workflow in the current session. Store its state in the pause response; do not create files, commits, or new tasks solely to checkpoint it.

Pause

  1. Stop expanding the task. Do not begin another subtask, retry, or optional check.
  2. Let an already-started atomic action finish only when interruption would leave inconsistent state. Otherwise stop at the nearest safe boundary. Use only the smallest necessary read-only check or already-authorized cleanup to record an accurate, safe state.
  3. Preserve facts, not guesses. Distinguish completed, in progress, blocked, and unknown work. Record exact non-sensitive paths, parameters, job IDs, and receipts when they are needed to continue. Never expose secrets.
  4. If work continues independently, record its handle, observed status, and how to reconcile it. Do not cancel, restart, or dispatch it again merely to pause.
  5. End the turn with the compact checkpoint below, in the user's language. Keep the marker exact, omit irrelevant detail, and state explicitly when there is no known non-repeatable effect.
PAUSE_CHECKPOINT: ACTIVE
- Goal and done condition:
- Completed:
- Current stopping point:
- Remaining work:
- First action on resume:
- Do not repeat:
- Constraints and settled decisions:
- Live state, running work, and facts to recheck:

Finish with the equivalent of: Paused. When you return, say "continue". Then stop. Do not perform the first resume action in the pause turn.

If there is no unfinished task, say so and stop without emitting an active checkpoint.

Resume

When the user later asks to continue the paused work:

  1. Use the newest unconsumed PAUSE_CHECKPOINT: ACTIVE in this session. A checkpoint is consumed once substantive work has resumed from it. If none exists, interpret the request from the immediate conversation normally.
  2. Apply later user instructions over the checkpoint. Recheck only mutable or high-risk state that could have changed while paused, especially files, worktree state, running jobs, and external side effects.
  3. Reconcile recorded in-flight work before starting replacements. Never repeat an item under Do not repeat unless current evidence proves it did not occur and repeating it is authorized.
  4. Resume directly from First action on resume, then continue the recorded remaining work. Do not ask the user to restate known context or produce a new plan unless material drift makes a decision necessary.

This workflow cannot recover a killed process, missing conversation, or a different session; use a handoff or persistent checkpoint workflow for those cases.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.