replay-debugging

Retrieves and analyzes a single Lo rproduction turn via the tcg-replay CLI.

Updated May 14, 2026
One-click install
npx skills add https://github.com/chroniicallydiistracted/LorcanaChamp --skill replay-debugging-chroniicallydiistracted
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: replay-debugging
Source: https://github.com/chroniicallydiistracted/LorcanaChamp/tree/main/references/lorcana-simulator/.agents/skills/replay-debugging
Command: npx skills add https://github.com/chroniicallydiistracted/LorcanaChamp --skill replay-debugging-chroniicallydiistracted

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Replay debugging converts a player-reported Lorcana turn into a concrete, step-by-step evidence trail you can inspect, so you can pinpoint which card definitions, moves, logs, and state patches were involved.

Core Features & Use Cases

  • Production replay ingestion: Pulls a specific turn from a real game via the tcg-replay CLI using a provided replay id and 1-based turn number.
  • Evidence-first turn forensics: Extracts the touched cards list with on-disk file paths, then prints the reconstructed pre-turn match state plus the ordered steps (moves, engine logs, and JSON patches).
  • Bug triage workflow support: Produces the artifacts needed to reproduce the issue as a hypothesis and hand off to card-specific validation or test generation.

Quick Start

Use the replay-debugging skill to run tcg-replay for the provided gameId and turn number, then read the CARDS INVOLVED section to open only the relevant card files before forming your hypothesis.

Frequently Asked Questions about replay-debugging

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

FAQPage Schema
How do I trace a Lorcana game state from a production replay to find a bug?

To trace Lorcana game state, run the tcg-replay CLI with a provided replay id and 1-based turn number. This extracts an evidence trail containing touched card file paths, reconstructed pre-turn match state, and ordered per-step moves, engine logs, and JSON patches.

What are JSON patches in replay debugging and how do they help with game state tracing?

JSON patches in replay debugging are structured per-step state changes extracted from a Lorcana replay turn. They provide concrete evidence of state transitions alongside engine logs and moves, enabling precise identification of what occurred in-game for triaging player bug reports.

Can I use production replay ingestion to triage player bug reports tied to a specific game id?

Yes, production replay ingestion pulls a specific turn from a real game using the tcg-replay CLI. It requires a reported game id and a suspect 1-based turn number to reconstruct the match state and identify involved card files for bug triage.

How do I identify which card files were touched during a specific Lorcana turn?

You identify touched card files by running the replay-debugging process and reading the structured CARDS INVOLVED section. This output lists the specific on-disk file paths for all card definitions affected during the target replay turn.

What do I need to run tcg-replay for Lorcana production triage?

You need a real game id and a suspect 1-based turn number from a player bug report to run tcg-replay. The CLI uses these parameters to ingest the production replay and generate structured output sections including involved cards, pre-turn match state, per-step moves, logs, and JSON patches.

Are there limitations when using replay debugging for Lorcana bug triage?

Replay debugging is limited to analyzing a single specified turn per replay id, requiring you to know the exact 1-based turn number beforehand. It produces evidence for hypothesis testing rather than automatically fixing card definitions or resolving the bug directly.