Closes#14
- Rename `COMPILATION_CACHING` to `COMPILATION_CACHE_ENABLE_CACHING` across
all skills, scripts, references, and documentation to match the actual
Xcode build setting key.
- Change `SWIFT_COMPILATION_MODE` debug expected value from `incremental` to
`singlefile` — the actual build setting value that xcodebuild outputs.
Xcode UI labels this "Incremental", but the underlying value is `singlefile`.
- Update the `_check()` guard in generate_optimization_report.py so unset
SWIFT_COMPILATION_MODE still passes when the expected value is `singlefile`.
Standard clean builds show cache-population overhead without the
corresponding cache-hit benefit, making COMPILATION_CACHING appear
to regress performance. The new "cached clean" phase measures clean
builds with a warm compilation cache by deleting DerivedData (not
the system compilation cache) between runs. This captures the
realistic developer workflow: branch switching, pulling changes,
and Clean Build Folder.
Changes:
- benchmark_builds.py: auto-detect COMPILATION_CACHING and run
cached clean builds using a controlled DerivedData path
- Schema bumped to 1.2.0 with optional cached_clean runs/summary
- Report generator shows Cached Clean column when data is present
- All skill docs and references updated to use the cached clean
metric as the primary comparison for COMPILATION_CACHING impact
- Updated README.md to include a quick start guide for the xcode-build-orchestrator skill and detailed installation instructions.
- Added a new script, check_spm_pins.py, to scan for branch-pinned SPM dependencies and check tag availability.
- Enhanced benchmark_builds.py to support measuring real incremental builds with a new --touch-file option.
- Expanded generate_optimization_report.py to auto-generate recommendations based on audit results.
- Revised multiple SKILL.md files to clarify usage instructions and best practices for various skills, including zero-change build analysis and worktree considerations.
- Added sections on measurement caveats related to compilation caching and first-run variance in `benchmark-artifacts.md`.
- Updated `build-optimization-sources.md` with insights from Swift forums regarding slow incremental builds due to planning Swift modules.
- Improved `benchmark_builds.py` to include a warmup clean+build cycle for better cache performance measurement.
- Expanded `generate_optimization_report.py` to include general expectations for compilation caching.
- Revised multiple SKILL.md files to clarify verification processes for local packages and version pins, and to address Swift macro rebuild impacts.
- Updated orchestration report template to note limitations of measuring `COMPILATION_CACHING` improvements.
First versioned snapshot of the full skill repository including:
- Five installable agent skills under skills/
- Shared references, schemas, and helper scripts
- Plugin and marketplace metadata for Claude Code
- GitHub workflows for release and README sync
- Compilation caching as a recommended build setting
- Four deeper Swift compiler diagnostic flags for compilation analysis
- Fixed SWIFT_COMPILATION_MODE to use singlefile (actual build setting value)
Antoine van der Lee