scene-instancing-workflow

name	scene-instancing-workflow
description	Operational workflow for building reusable scenes and instancing them safely across a Godot project.
tier	operational
godot_version	4.6+
doc_anchors	["godot-docs/getting_started/step_by_step/instancing.rst","godot-docs/getting_started/step_by_step/nodes_and_scenes.rst","godot-docs/tutorials/best_practices/scene_organization.rst"]
tags	["instancing","workflow","reuse"]
depends_on	["godot-skills/godot-tertiary/scene-node-basics-contract/SKILL.md"]

Scene Instancing Workflow

Use When

• Creating reusable gameplay or UI scene prefabs.
• Replacing duplicated node setups with a shared packed scene.
• Hardening scene composition before broader feature expansion.

Outcomes

• Reusable scene instance with clear public inputs/outputs.
• Parent scene integrates child instance without direct deep coupling.
• Instance lifecycle is deterministic on load, reload, and replacement.

Required Rules

• Define a stable scene-root API before broad reuse.
• Keep instance configuration explicit via exported properties or injected dependencies.
• Do not rely on editor-only implicit state for runtime behavior.
• Validate the instance in at least one minimal integration scene.

Workflow

1. Build the smallest standalone scene that demonstrates one behavior.
2. Expose only required configuration on the scene root.
3. Instance the scene in a parent scene and wire signals at parent scope.
4. Add one change to the child scene and verify all parents still behave correctly.
5. Document integration points and constraints in the skill consumer notes.

Validation

• Run the project from a clean launch and confirm no missing scene/resource errors.
• Reload the parent scene and verify instance behavior remains consistent.
• Instantiate the scene in a second context to confirm reuse assumptions hold.

Failure Modes

• Child scene depends on parent-specific node paths.
• Configuration is hidden in per-instance editor overrides with no contract.
• Scene updates silently break parents due to undeclared API changes.

Local Doc Anchors

• godot-docs/getting_started/step_by_step/instancing.rst
• godot-docs/getting_started/step_by_step/nodes_and_scenes.rst
• godot-docs/tutorials/best_practices/scene_organization.rst