golem-test-crash-recovery

Simulate crashes on durable agents and validate state recovery via operation log replay.

Updated May 17, 2026
One-click install
npx skills add https://github.com/Rust-soham/golem-claw --skill golem-test-crash-recovery-rust-soham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golem-test-crash-recovery
Source: https://github.com/Rust-soham/golem-claw/tree/main/packages/golem/.agents/skills/golem-test-crash-recovery
Command: npx skills add https://github.com/Rust-soham/golem-claw --skill golem-test-crash-recovery-rust-soham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validating that a durable agent correctly restores state and resumes work after an unexpected crash.

Core Features & Use Cases

  • Crash simulation: Interrupts an agent’s execution to reproduce failure scenarios in a controlled way.
  • Immediate recovery via oplog replay: Forces recovery to start by replaying the agent’s operation log so you can confirm durability behavior.
  • Use case: Run a typical workflow (invoke a method, simulate a crash, then invoke a getter) to verify that the post-crash state matches expectations and that recovery doesn’t lose or corrupt progress.

Quick Start

Simulate a crash and then verify recovery by running: golem agent simulate-crash <AGENT_ID>.

Frequently Asked Questions about golem-test-crash-recovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test agent crash recovery and state restoration after an unexpected failure?

To test agent crash recovery, you simulate an unexpected failure by interrupting execution, then perform state restoration by replaying the operation log until normal execution resumes. This verifies that durable agents correctly recover progress without data loss.

What is durable execution testing and how does oplog replay validate it?

Durable execution testing validates that an agent restores its state and resumes work after crashing. Oplog replay forces recovery by re-executing the operation log to confirm durability behavior and ensure post-crash state matches expectations without corruption.

How do I simulate a crash on a durable agent to verify state recovery?

You simulate a crash on a durable agent by running a command to interrupt its execution, then invoking a getter to verify state recovery. This workflow confirms the post-crash state matches expectations and that recovery does not lose progress.

Can I debug replay-based recovery behavior across agent operation logs?

Yes, you can debug replay-based recovery behavior by replaying agent operation logs after a simulated crash. This allows you to inspect state restoration step by step and verify that durable execution resumes correctly without losing or corrupting progress.

What is the best way to verify durability behavior in agent testing workflows?

The best way to verify durability behavior is to run a typical workflow that invokes a method, simulates a crash, and then checks the post-crash state. This confirms that the agent's recovery process via oplog replay matches expected outcomes.