AEC Workflow Orchestrator

Scope: Multi-technology workflow orchestration for Blender + IfcOpenShell + Bonsai Version coverage: Blender 3.x-5.x | IfcOpenShell 0.8.x | IFC2X3/IFC4/IFC4X3 | Bonsai v0.8.x Role: Agent-level skill — routes tasks, sequences operations, coordinates technology boundaries

Critical Warnings

1. ALWAYS determine the execution context FIRST: standalone Python, Blender Python, or Bonsai-loaded. The available API surface differs per context.
2. NEVER mix IfcStore.get_file() (Bonsai) with ifcopenshell.open() on the same file. Bonsai owns the in-memory IFC graph.
3. ALWAYS use ifcopenshell.api.run() for IFC mutations in ALL contexts. NEVER modify entity attributes directly.
4. ALWAYS call bpy.ops.bim.edit_object_placement() after moving Blender objects when Bonsai is active.
5. NEVER use blenderbim.* imports. Use bonsai.* (renamed in v0.8.0, 2024).
6. ALWAYS set up units and geometric contexts before creating geometry.
7. NEVER use void.add_opening() in Bonsai v0.8.0+. Use feature.add_feature().

Quick Reference: Technology Selection Decision Tree