ossrules.md

cmux-dev-workflow

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

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.

skills/cmux-dev-workflow/SKILL.md

Download bundle ↓
main · 6f118af ↗5 bundle filesScanned 2026-09-15

references/xcode-project-normalization.md

144 tokens · o200k_base · 529 bytes

ReadGitHub ↗
Source excerpt starting at line 1.
# Xcode Project Normalization The pin (`.xcode-version`, `objectVersion = 60`), the pre-commit hook, and the CI guard are described in [../SKILL.md](../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
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 →