Durable Recovery Protocol.

Every recovery separates verified work from inferred next steps: disk facts, changed files, confirmed decisions, failed attempts, verification status, and next action.

A packet is not a summary.

A normal summary mixes memory, guesses, and stale transcript history. The Durable Recovery Protocol keeps repository-grounded facts separate from session-derived context, so the next AI knows what it can use and what it should verify before acting.

What it carries.

  • Verified disk facts
  • Inferred next steps clearly marked for re-checking
  • Failed attempts and do-not-retry notes
  • Verification state and next action

How the labels travel.

The protocol is designed for trust-labeled recovery when a session becomes stale, deleted, rate-limited, or otherwise unsafe to continue. The packet travels through tool pickup files, clipboard handoff, or MCP. Bedrock keeps a local record behind captured events so the trust distinction is re-checkable later.

How to use the distinction.

Verified facts include the current branch, changed files, observed errors, and completed checks. Inferred next steps are useful hypotheses, but they should be re-checked before code changes continue. Keeping those categories separate prevents a confident old summary from outranking the repository.

The protocol is especially useful after a crash, context limit, or cross-tool move. It preserves the reason for a decision without presenting an unverified guess as a completed fact.

Mark the boundary between evidence and inference.

Before handing work to another tool, label a statement such as tests passed with the command and result that support it; label a proposed next step as a proposal if it has not been run.

  1. Put current branch, changed files, command output, and completed checks in the verified-facts area.
  2. Put remembered rationale, likely causes, and suggested next actions in the inferred or unverified area.
  3. When the next agent begins, ask it to re-check any fact that could have changed since capture, especially branch state and test results.

Worked example.

A useful handoff might say: verified fact: branch feature/auth, file auth/session.ts changed, and npm test -- session passed with the recorded output. Inference: the refresh-token branch may cause the observed loop. Next action: inspect the expiry path and reproduce once. That wording lets the next agent keep the hypothesis without repeating it as a proven diagnosis.

Limits and verification.

Labels reduce ambiguity but cannot make incomplete evidence complete. A fact can become stale after capture, and an inference can still be wrong. Keep the timestamp and source with important claims, and have the next session reconcile the packet with the current checkout.