Diff Runner

diff-runner

Regression testing tool for Oracle of Secrets. Records gameplay scenarios and replays them on new builds to detect logic bugs or desyncs.

scawful/afs_scawful·0installs0starsProductivity & Planning

SKILL.md

Full skill instructions

Diff Runner

Scope

Regression Testing: Verify that logic changes didn't break existing behavior.
State Comparison: Compares critical game state (Link pos, Mode, Inventory) frame-by-frame (or action-by-action).

Core Capabilities

1. Record

Execute a scenario script and capture the "Golden Trace".

record scenario.json trace.json

2. Verify

Replay a trace on the current ROM and assert state matches.

verify trace.json

Workflow

Create Scenario: Write a JSON list of inputs: [{"input": "Right", "frames": 60}, ...].
Baseline: Run record on the stable ROM build.
Dev: Apply your changes/patches.
Test: Run verify on the new ROM build.
Result: "Pass" or "Divergence at Step 45".

Dependencies

Tool: ~/src/hobby/yaze/scripts/ai/diff_runner.py.
Mesen2: Running with socket server.

Example Prompts

"Record a baseline trace for the 'walk_to_dungeon' scenario."
"Verify the current build against the 'boss_fight' trace."

Troubleshooting

Desyncs: Emulator RNG or uninitialized RAM can cause non-deterministic behavior. Ensure the scenario includes a hard reset or state load at the start.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/scawful/afs_scawful --skill diff-runner

View on GitHub

skills/diff-runner/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View