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 a new skill: `xcode-build-fixer` for applying approved optimization changes.
- Introduced `xcode-build-orchestrator` to manage the optimization workflow.
- Updated existing skills to reflect new names and roles, including `xcode-compilation-analyzer` and `xcode-project-analyzer`.
- Revised documentation across multiple files to include six installable skills and their purposes.
- Enhanced contribution guidelines to align with the new skill structure.
- Updated plugin metadata to reflect the addition of new skills.
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)
github-actions[bot]