---
name: bevy-debug
description: Debug common Bevy runtime, ECS, asset, input, and scheduling problems
license: MIT
compatibility: opencode
metadata:
  stack: bevy
  mode: debug
---

## What I do

- narrow likely root causes
- map symptom to file and system
- suggest smallest probe first
- suggest smallest safe fix
- give exact verify commands

## Use when

- app opens but scene blank
- movement or input broken
- UI not updating
- panic or borrow conflict appears
- schedule/state confusion happens

## Rules

- quote exact compiler/runtime error if present
- do not jump to big refactor first
- check camera, assets, queries, states, and schedules