{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/checkpoint-meaningful-progress-before-a-long-agent-crosses-a-fragile-boundary",
  "id": "MHC-D-RESEARCH-0950",
  "version": "0.1.0",
  "title": "Checkpoint meaningful progress before a long agent crosses a fragile boundary",
  "summary": "Progress that exists only in the current context window is not durable progress.",
  "kind": "protocol",
  "body": "Save a checkpoint after meaningful milestones: current task state, completed outputs, unresolved items, relevant artifact versions and next action. Use checkpointing before context reset, external wait, process restart or other point where reconstruction would be expensive.",
  "limits": [
    "Do not checkpoint secrets or unnecessary raw data into insecure storage."
  ],
  "topics": [
    "union-agent-loop-reliability"
  ],
  "intents": [],
  "source_ids": [
    "RS-170C21C3D7B258FD"
  ],
  "evidence": [
    {
      "claim": "Microsoft's workflow checkpoint guidance supports saving state so long-running workflows can resume after failures or pauses.",
      "source_id": "RS-170C21C3D7B258FD",
      "role": "supports",
      "note": "Do not checkpoint secrets or unnecessary raw data into insecure storage.",
      "locator": "See source record"
    }
  ],
  "use_when": [
    "A task spans many tool calls, context compactions, process restarts or long-running background work."
  ],
  "avoid_when": [
    "Do not checkpoint secrets or unnecessary raw data into insecure storage."
  ],
  "example": "After finishing repository analysis, persist the selected plan and changed-file list before the agent starts a long implementation phase.",
  "check": "A later process can resume from the checkpoint without guessing what the prior context knew.",
  "steps": [
    "Completed artifacts have stable identities.",
    "Open work and next action are recorded.",
    "Critical assumptions/decisions are persisted.",
    "Checkpoint can be rehydrated without replaying the entire transcript."
  ],
  "sources": [
    {
      "id": "RS-170C21C3D7B258FD",
      "title": "Microsoft Agent Framework Workflows - Checkpoints",
      "url": "https://learn.microsoft.com/en-us/agent-framework/workflows/checkpoints"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-RESEARCH-0950",
      "to": "MHC-D-RESEARCH-0463",
      "type": "useful_with",
      "url": "/knowledge/checkpoint-the-task-before-a-planned-interruption"
    }
  ],
  "collections": [
    {
      "id": "RC-043A908C9263BF6A",
      "title": "Make the agent loop finish, recover and stay inspectable",
      "url": "/collections/make-the-agent-loop-finish-recover-and-stay-inspectable"
    }
  ]
}