wave8-ecb-system-group-mismatch

What problem does it solve?

This Skill helps you identify and fix one-frame-late or mis-timed structural change bugs caused by creating an EntityCommandBuffer from the wrong ECS system group for the code that enqueues commands.

Core Features & Use Cases

• Correct ECB system selection: Guides you to match the enclosing system group (e.g., FixedStep vs Simulation) with the corresponding Begin/End ECB system singleton.
• Debugging structural-change timing issues: Targets issues like components appearing/disappearing unexpectedly and structural commands executing at the wrong frame boundary.
• Avoiding common ECS ECB anti-patterns: Prevents mistakes such as always using EndSimulation ECB in FixedStep systems or mixing ECB Begin/End systems within a system.

Use case example: When a system inside FixedStepSimulationSystemGroup spawns or destroys entities using an ECB but the effects appear one rendered frame late, this Skill helps you switch to EndFixedStepSimulationEntityCommandBufferSystem so the commands play back at the correct fixed-step boundary.

Quick Start

Ask the AI to review your ECS system’s UpdateInGroup attribute and your ECBSystem singleton choice, then explain which ECB Begin/End system to use and why for the current enclosing system group.