xcode-build-orchestrator

The xcode-build-orchestrator skill provides a structured, recommendation-first workflow for optimizing Xcode build performance. It is designed to help developers reduce wall-clock build times by coordinating benchmarking, analysis, prioritization, and validation steps in a controlled process. The skill emphasizes evidence-based optimization by establishing build baselines before any changes are made and by requiring explicit developer approval prior to modifying project files, source files, packages, or build settings. It also preserves benchmark artifacts and optimization reports to maintain a clear evidence trail throughout the workflow.

The skill supports a two-phase optimization process centered around benchmarking and analysis. In the analysis phase, it gathers build target context such as workspace or project selection, scheme, configuration, and destination information. It runs benchmark workflows using xcode-build-benchmark, validates timing summaries, detects cached clean build scenarios, and evaluates benchmark variance to determine confidence in performance measurements. The orchestrator also provides guidance for diagnosing incremental build issues, including recommendations for enabling Task Backtraces in Xcode 16.4+ environments. Recommendations are prioritized based on expected impact to actual developer wait time, and approved fixes can later be delegated to specialized build-fixing workflows before re-benchmarking to measure improvements.

This skill is intended for iOS and macOS developers, build engineers, and teams managing large Xcode projects with slow clean or incremental builds. It is especially useful for developers requesting a full build audit, a recommend-first optimization pass, or coordinated analysis across compilation performance, project configuration, and package dependencies. The workflow is designed for environments where build reliability, reproducibility, and measurable performance gains are critical.