RemotePS5-VisionOS

Guardrail for the dedicated 120Hz off-MainActor input thread and the onInputReady wiring between GameControllerManager and StreamingService.startStreamingV2(). Load before editing HighFrequencyInputController.swift, GameControllerManager.swift, StreamingService.swift, VirtualSteeringWheelService.swift, or any controller-input code. Severity medium — violating it regresses input latency or leaks the streaming session.

Guardrail keeping ACES Filmic as the active tonemapper and Reinhard (tonemapLuminance) as a preserved legacy fallback. Load before editing ColorSpaceConverter.swift, YUVToRGB.metal, or any shader/tonemapping code. Severity medium — violating it regresses HDR color quality on the Vision Pro EDR display.

Guardrail for the buffer-pool exhaustion path — markForRecovery() (IDR re-request) plus the 1Hz lastBufferExhaustionTime debounce. Load before editing SafeBufferPool.swift, VideoDecoder.swift, StreamingService.swift, or any chiaki video-callback failure handling. Severity medium — violating it causes visible smearing or log-spam stalls.

Guardrail for the manual ChiakiSession struct offsets (1552/1560/1568) in ChiakiCore.c. Load before editing ChiakiCore.c, ChiakiBridge.swift, ChiakiFullSession.swift, or any code that registers chiaki callbacks. Severity critical — violating it silently corrupts the video stream.

Guardrail keeping spatialAudioEnabled = false (Direct Stereo, HRTF bypass) as the default in LowLatencyAudioPlayer.swift — the PS5 Tempest Engine already outputs binaural audio. Load before editing LowLatencyAudioPlayer.swift or any audio output/spatialization code. Severity high — flipping the default causes metallic double-spatialization artifacts.

Guardrail requiring CACurrentMediaTime() (monotonic) for all streaming-pipeline time deltas — never CFAbsoluteTimeGetCurrent(), Date(), DispatchTime, or ContinuousClock. Load before editing StreamingService.swift, anything under Streaming/, or writing any new code that measures latency or time deltas in the pipeline. Severity high — wall-clock time breaks latency math under NTP drift.

Guardrail for "#define CHIAKI_LIB_ENABLE_OPUS 1" ordering — it MUST precede every chiaki header include. Load before editing ChiakiCore.c, ChiakiCore.h, the bridging header, or creating any C file that includes <chiaki/...> headers. Severity critical — violating it causes silent memory corruption (944-byte struct skew).

Guardrail for Frameworks/Chiaki.xcframework — the hand-merged libchiaki_full.a and its .orig/.backup siblings are immutable except via scripts/merge_chiaki_opus.sh. Load before touching anything under VisionRemotePS5/Frameworks/ or proposing library regeneration/cleanup. Severity critical — violating it produces a non-reproducible or non-linking build.

Ownership boundary map, cross-agent contracts, anti-deadlock rules, and the unclaimed-files list for the VisionRemotePS5 agent team (swift-visionos-engineer, streaming-pipeline-engineer, c-bridge-guardian, build-script-maintainer). Load whenever delegating work to a subagent, deciding which agent owns a file, or when a task crosses agent boundaries.

Guardrail marking chiaki-ng/, mbedtls-src/, and opus-build/opus-1.5.2/ as read-only vendored upstream sources. Load before any edit, grep-driven fix, or refactor that touches C sources — if a search hit lands inside those trees, this skill explains why you must not edit it. Severity critical — editing vendored trees breaks the supply chain.

Guardrail for the 90Hz Vision Pro display-rate gating ("#if os(visionOS)" block in StreamingService.swift). Load before editing StreamingService.swift, FramePacer.swift, AudioVideoSyncController.swift, or writing any new code that computes display latency. Severity high — violating it reintroduces the audio/video desync bug.