← ClaudeAtlas

debug-web2d-gamelisted

Diagnose and fix reproducible browser-native 2D gameplay defects using fixed seeds, structured state traces, runtime diagnostics, and regression scenarios. Use for broken controls, incorrect rules, collision bugs, scene lifecycle leaks, pause/focus problems, nondeterministic failures, resource errors, or state/render divergence in Web 2D games.
44-99/Web2DKit · ★ 1 · Web & Frontend · score 74
Install: claude install-skill 44-99/Web2DKit
# Debug a Web 2D Game Reduce the report to the first incorrect state transition, fix its owning layer, and preserve the reproduction as a regression scenario. Keep visual symptoms separate from rule evidence. ## Workflow 1. Translate the report into expected initial state, minimal actions, expected result, and observed result. 2. Call `web2d_project_inspect`, start the game, then call `web2d_session_start` with a recorded seed. 3. Call `web2d_observe` before acting. Verify that the bridge exposes every state field needed to distinguish the hypotheses. 4. Reproduce with the shortest `web2d_scenario_run` possible. If reproduction depends on uncontrolled waiting, first add deterministic stepping or a domain action. 5. Classify the first failure using [references/failure-layers.md](references/failure-layers.md). Keep input, state/rules, lifecycle, rendering, assets, and performance as separate boundaries. 6. Change the smallest owner of the incorrect transition. Do not rewrite the rendering stack to repair a rule defect. 7. Re-run the exact seed and scenario, then adjacent scenarios and existing tests. When state is correct but presentation was wrong, use the host browser/capture capability to verify the repaired rendered state. 8. Keep the scenario in project test fixtures when it protects a real bug contract. 9. Run `web2d_quality_check`, stop the session, and report root cause, changed boundary, before/after evidence, and remaining uncertainty. ## Debugging rules - If str