Instruction file imported from buegelbeatz/tsp-quantum (.github/instructions/fullstack-engineer/3d.instructions.md). Copyright stays with the author.

Enterprise Specification: 3D, Augmented Reality (AR), and Virtual Reality (VR) Standard

1. Purpose

This document defines the enterprise standard for planning, building, deploying, and operating 3D, AR, and VR solutions across web, mobile, and spatial-computing platforms.

The objective is to ensure:

• Consistent architecture and tooling
• Scalable and maintainable immersive applications
• Secure and governed delivery
• Cross-platform compatibility and portability

2. Scope

This specification applies to:

• 3D web applications
• Mobile AR applications
• VR and immersive applications
• Spatial computing platforms
• Product visualization and simulation systems

3. Platform Categories

The enterprise supports the following delivery categories:

• Native mobile applications (iOS, Android)
• Engine-based immersive applications
• Web-based 3D and AR/VR applications
• Spatial computing environments

4. Supported Devices

Applications MUST consider:

• Smartphones
• Tablets
• Desktop browsers
• VR headsets
• Spatial computing devices

Supported modes:

• 3D viewer
• Augmented Reality (AR)
• Virtual Reality (VR)
• Mixed / spatial computing

5. Approved Tooling

5.1 Apple Native Stack

Preferred for Apple ecosystems:

• ARKit
• RealityKit
• SwiftUI
• AR Quick Look
• USD / USDZ formats

5.2 Cross-Platform Engine

Preferred for multi-platform delivery:

• Unity
• AR Foundation

5.3 High-Fidelity Immersive

Preferred for advanced rendering and simulation:

• Unreal Engine
• OpenXR

5.4 Web-Based Delivery

Approved technologies:

• WebXR
• Babylon.js
• <model-viewer>

6. iOS Web AR Standard

• AR Quick Look MUST be used for iOS browser-based AR
• USDZ MUST be used for AR assets
• <model-viewer> SHOULD be used for cross-platform compatibility

7. Asset Standards

Approved formats:

• USD / USDZ (Apple ecosystem)
• glTF / GLB (web and cross-platform)

Assets MUST:

• Be versioned
• Be optimized for performance
• Define ownership and lifecycle

8. Architecture Standards

8.1 Layered Architecture

Rendering → Interaction → Business Logic → Backend Services

8.2 Backend Integration

• APIs MUST be used for dynamic content
• Assets SHOULD be served via CDN
• Configuration MUST be externalized

9. Best Practices

9.1 Technology Selection

• Apple-native apps → ARKit + RealityKit
• Cross-platform → Unity
• High-fidelity → Unreal
• Web-first → WebXR / model-viewer

9.2 Fallback Strategy

Applications MUST support fallback modes:

• AR → 3D viewer
• VR → desktop/web fallback
• Unsupported devices → graceful degradation

9.3 Performance

• Optimize models (polygon count, textures)
• Minimize load times
• Ensure smooth interaction

10. Security Requirements

• All communication MUST use HTTPS
• Sensitive data MUST NOT be embedded in assets
• Authentication MUST use enterprise identity systems
• Device permissions MUST be minimized

11. Testing Standards

Testing MUST include:

• Device compatibility
• Performance testing
• Interaction validation
• Fallback scenarios

12. CI/CD and Deployment

Pipelines SHOULD automate:

• Asset validation
• Build generation (web + native)
• Testing
• Deployment

Deployment targets:

• Web hosting / CDN
• App Store / Play Store
• Enterprise distribution

13. Governance

• Tooling choices MUST be documented
• Architecture MUST be reviewed
• Security compliance MUST be ensured
• Exceptions MUST be approved

14. Executive Summary

This standard defines an enterprise baseline for 3D, AR, and VR delivery across native, engine-based, and web channels.

For Apple-centric immersive applications, the preferred stack is:

• ARKit
• RealityKit
• SwiftUI

For cross-platform AR, the standard choice is:

• Unity with AR Foundation

For high-fidelity immersive experiences, the approved stack is:

• Unreal Engine with OpenXR

For browser-first delivery, the approved technologies are:

• WebXR
• Babylon.js
• <model-viewer>

On iOS, AR Quick Look is the primary supported approach for web-based AR experiences.

15. Further Reading

• Apple ARKit
• Apple RealityKit
• Unity AR Foundation
• Unreal XR Development
• WebXR API
• model-viewer

16. Summary

This standard ensures consistent, scalable, and secure development of 3D, AR, and VR applications across enterprise platforms.