wave7-companion-go-lifecycle

What problem does it solve?

This skill solves the lifecycle mismatch problem between ECS entity existence and the creation, transform synchronization, and destruction of paired Unity GameObjects.

Core Features & Use Cases

• Four-phase lifecycle pattern: Implements Marker → Spawn → Sync → Destroy using ECS components to control exactly when a companion GameObject should exist.
• Correct main-thread boundaries: Ensures companion GameObject instantiation and destruction happen in appropriate system groups while keeping ECS as the source of truth.
• Safe cleanup semantics: Prevents GO leaks when entities are destroyed by using lifecycle-safe destroy handling and null-guarding UnityObjectRef values.
• Use case: Create an audio/VFX/UI companion GameObject for an ECS entity when Entities Graphics alone cannot render the required presentation.

Quick Start

Tell your AI to provide the ECS marker component, spawn system, GO-to-entity reference component, and destroy system that follow the marker/spawn/sync/destroy pattern with correct system group placement.