ensemble

Build, launch, and capture debug logs from the iOS simulator. Use when you need to verify runtime behavior, measure timing, or diagnose issues without asking the user to manually capture logs.

Use when the user asks to visually test, touch, automate, or walk every Ensemble app surface across iOS/iPadOS and macOS, including agent-run UI sweeps, issue detection, reproduction, log inspection, fix-plan reports, platform parity checks, and repeatable screenshot/accessibility evidence runs.

Canonical Ensemble behavior policy router. Load before changing app behavior, playback, queue, offline/connectivity, downloads, sync/refresh, mutations, platform UI behavior, or verification expectations; update the relevant policy reference when implementation changes or clarifies behavior.

Plex Media Server API reference. Load when implementing or debugging Plex API integration.

Load before designing features, adding services, or touching multiple packages. Compact ownership, dependency, and subsystem rules for Ensemble.

Load when locating files, adding files, or checking package ownership. Compact map plus discovery commands; use rg for live file lists.

Load before building or modifying any SwiftUI view. Ensemble UI/UX conventions: navigation behavior, tab management, visual design specs, loading/error states, performance optimization, iOS 15 compatibility, DetailLoader pattern.

Load before writing tests, after non-trivial code changes, or when deciding verification scope. Canonical definition of done for Ensemble.

Active Ensemble limitations, watchlist items, and fragile areas. Use when investigating bugs, planning work, or touching known-risk behavior.

Load when adding a ViewModel, view, CoreData entity, hub, music source, playlist mutation, or sync trigger. Step-by-step recipes with code patterns.

Load before writing any Swift code. Contains mandatory rules that override defaults: structured Logger usage (no print), edge case handling required (active beta), memory targets, MVVM pattern, and debug logging conventions.

Use when auditing, simplifying, or removing SwiftUI/UIKit/AppKit UI workaround code that fights native platform behavior: safe-area/titlebar/nav-bar bridges, custom scroll or drag handling, representable hit-testing, GeometryReader layout correction, DispatchQueue layout delays, loading-state swaps, stale UI layers, and broad chrome/presentation overrides. Supports thorough multi-pass cleanup with optional subagents when the user explicitly asks to use agents, plus tests, simulator checks, macOS checks, documentation, and commits.

Load when a user provides an Instruments .trace bundle and wants performance, hang, lifecycle, thermal, or timeline analysis. Use the bundled script to export xctrace tables, summarize run windows, and correlate trace timestamps with session logs.