Retro Porting Toolkit · Bring classic console games to modern hardware

When an agent cannot run the game

What AI-assisted work can and cannot prove without the game file, BIOS, display, or oracle.

Sometimes the agent cannot run the game.

That may be fine. A clean clone often lacks the user's game file, BIOS file, display access, oracle setup, or local debug tools.

The rule is simple: the agent can still do useful work, but it must not claim proof it does not have.

What may be missing

Missing itemWhat it prevents
Game fileRegeneration, launch, runtime identity checks, gameplay verification.
BIOS or firmwareBoot paths for systems that require one.
Display or capture pathVisual claims.
Oracle or reference processCorrectness comparison.
Ghidra or disassembly accessSome code-discovery and reverse-engineering work.
Compiler or SDKBuild verification.

Each missing item removes a class of claim. It does not make guessing acceptable.

What the agent can still do

Without the game, an agent may still:

  • read and explain code
  • improve docs
  • build framework-only tools
  • run unit tests that need no private files
  • check packaging scripts
  • inspect config structure
  • add or improve debug commands
  • write a handoff for a human who can run the game

That work can be valuable. It just needs honest boundaries.

What the agent cannot claim

Without a real run, do not accept claims like:

  • the bug is fixed
  • the port is playable
  • dispatch misses are empty
  • coverage is complete
  • native matches the oracle
  • timing is correct
  • the visual output is correct
  • the release works end to end

The agent can say "this builds" only if it built. It can say "this should be checked by running X" if it could not run X.

Existing artifacts are not fresh proof

A log, screenshot, trace, or dispatch-miss file already in the tree is evidence about an earlier run.

It is not evidence about the current change unless the agent produced it during this session or can prove it matches the current build.

This is a common false pass. Avoid it.

Useful partial checks

CheckWhat it proves
BuildThe compiler accepted the code.
Unit testsThe covered host logic still passes.
Static inspectionThe diff follows project structure.
Package inspectionThe archive or script excludes forbidden files.
Config validationRequired fields are present and coherent.
Tool wiringA debug command is registered, documented, and callable in principle.

Phrase the result narrowly.

What to write down

If the agent cannot finish verification, require a handoff with:

  • the exact missing resource
  • what was checked anyway
  • commands that were run
  • tests that skipped
  • the command a human should run next
  • what output would confirm the change
  • what output would refute it

This is not failure. It is an honest stop.

When to stop

Stop and hand off when:

  • the repo requires a tool the agent cannot access
  • the change touches hardware behavior and no oracle check can run
  • the change touches timing and no route can be tested
  • the framework instructions are missing
  • required private files are unavailable

Do not let the agent fill the gap with confidence.