references/xcode-project-normalization.md

144 tokens · o200k_base · 529 bytes

Xcode Project Normalization

The pin (.xcode-version, objectVersion = 60), the pre-commit hook, and the CI guard are described in ../SKILL.md.

Bumping the Xcode pin

Edit .xcode-version.
Open cmux.xcodeproj in the new Xcode so it rewrites objectVersion.
Add a case in scripts/check-pbxproj.sh mapping the new Xcode major to the objectVersion that major writes.
Run scripts/normalize-pbxproj.py.

Do not change objectVersion opportunistically as part of unrelated project edits.

Referenced from SKILL.md

36`scripts/setup.sh` installs the tracked `scripts/git-hooks/pre-commit`, which runs `scripts/normalize-pbxproj.py` on any staged `project.pbxproj` so Xcode's nondeterministic reordering never reaches a commit. The hook is idempotent. CI runs `scripts/check-pbxproj.sh` to enforce both the `objectVersion` pin and normalization, so skipping the hook gives a clear PR failure. Bumping the pin is a deliberate team decision: see [references/xcode-project-normalization.md](references/xcode-project-normalization.md).