wave8-handle-complete-sync-point-antipattern

What problem does it solve?

This Skill identifies unintended main-thread stalls caused by calling handle.Complete() in Unity DOTS systems and replaces that sync point with proper dependency chaining.

Core Features & Use Cases

• Detects sync-point anti-patterns: Flags inline handle.Complete() usage that forces a WaitForJobGroupID stall and destroys frame parallelism.
• Recommends ECS-correct scheduling: Guides replacement with state.Dependency propagation and job chaining so downstream systems consume results without explicit completion.
• Chooses the right lifetime model: Encourages WorldUpdateAllocator for per-frame NativeArrays and reserves Allocator.Persistent for cross-frame data with correct disposal patterns.
• Supports managed cross-boundary handoff: Advises writing results to IComponentData and reading next frame when output must reach non-Burst/managed code.

Quick Start

Ask your AI assistant to refactor the DOTS system by removing any inline handle.Complete() calls, switching per-frame NativeArray allocations to state.WorldUpdateAllocator, and chaining the producer job to the consumer job through state.Dependency without explicit completion.