wave4-burst-compilation-contract

Guarantee Burst compilation for Unity DOTS ISystem methods by applying the [BurstCompile] attribute to relevant methods and job struct Execute paths. This audits scheduling workflows to prevent silent non-Burst fallbacks.

Unity DOTS job structs silently fall back to non-Burst execution when missing [BurstCompile] attributes or using managed APIs. Applying Burst attributes to Execute paths and avoiding SystemBase OnUpdate prevents these hidden performance regressions.

Apply [BurstCompile] correctly to IJobEntity job structs by annotating the Execute path and related ISystem methods. This covers scheduling and execution workflows, enforcing audit rules to ensure consistent Burst-native compilation across the codebase.

Avoid using Burst compilation in Unity DOTS systems when relying on managed APIs or SystemBase OnUpdate. Isolate necessary managed calls using [BurstDiscard] to safely opt out without breaking the native execution contract.

Using SystemBase OnUpdate prevents Burst compilation in Unity DOTS because it relies on managed APIs. Transitioning to ISystem implementations and applying [BurstCompile] ensures your scheduling and execution workflows compile down to native code.

The best way to audit Unity DOTS code for missing Burst attributes is using a senior checklist that targets ISystem implementations and job structs. This reviewable contract enforces audit rules to reduce compile-time surprises and catch missing annotations.