ossrules.md

cmux-dev-workflow Skill

Contributor workflow rules for cmux setup, Xcode project normalization, tagged sidebar ExtensionKit development, and dev builds. Use when setting up the cmux repo, changing Xcode project files, adding sidebar extensions, or working with tagged debug builds.

Install
npx skills add 'https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-dev-workflow'
Download bundle ↓

references/xcode-project-normalization.md

references/xcode-project-normalization.mdBrowse 5 files
View on GitHub
144 tokens

529 bytes
Token encoding: o200k_base
Snapshot 6f118af

← Back to SKILL.md

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

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

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

Referenced from SKILL.md
SKILL.mdView in source ↗
Source excerpt starting at line 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).
← All cmux skillsProject instructions →