diff-runner

Record and replay gameplay traces to validate ROM builds against golden traces.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/scawful/afs_scawful --skill diff-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diff-runner
Source: https://github.com/scawful/afs_scawful/tree/main/skills/diff-runner
Command: npx skills add https://github.com/scawful/afs_scawful --skill diff-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Regression testing for Oracle of Secrets by recording gameplay scenarios and replaying them on new builds to detect logic bugs or desyncs.

Core Features & Use Cases

  • Record: Execute a scenario script and capture the Golden Trace.
  • Verify: Replay a trace on the current ROM and assert state matches.
  • Workflow: Baseline, patch, test, and compare results across builds.

Quick Start

Create a scenario JSON, record the golden trace, then verify it against the new ROM build.

Frequently Asked Questions about diff-runner

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

FAQPage Schema
How do I automate regression testing for game logic across new ROM builds?

To automate regression testing for game logic, you record a Golden Trace from a scenario script and replay it on new ROM builds to detect logic bugs or state desyncs. The verifier compares the replayed trace against the recorded baseline.

What is a Golden Trace in gameplay recording and replay?

A Golden Trace in gameplay recording is the baseline output captured by executing a scenario script. It serves as the reference state that a verifier compares against when replaying the same scenario on a new ROM build to detect desyncs.

How do I record and replay gameplay scenarios to detect state desyncs?

You record gameplay scenarios by running a scenario JSON script to capture a Golden Trace, then replay that trace on the current ROM build. The verifier asserts whether the replayed state matches the recorded baseline to detect desyncs.

Do I need a scenario JSON format to start regression testing gameplay traces?

Yes, you need a scenario JSON format to start regression testing. The scenario script defines the gameplay actions to execute, which the recording process captures as a Golden Trace for subsequent replay and verification.

What's the best way to validate game logic after applying a new patch?

The best way to validate game logic after patching is to replay a recorded Golden Trace on the new ROM build. The verifier compares the replayed state against the baseline trace to ensure the patch did not introduce logic bugs or desyncs.