← ClaudeAtlas

parallel-agent-xcode-hygienelisted

Keep AI-agent sessions that build Apple apps on one shared Mac from corrupting each other's results or filling the disk. Each session owns a simulator addressed by UDID, a per-worktree `-derivedDataPath`, `tuist generate --no-open`, load and free-disk gates before `xcodebuild`, and cleanup proved with `df`. Use when about to run `xcodebuild`, or create, boot or pick a simulator, in a git worktree or beside other agents; when deciding whether to build locally or leave it to CI; when `xcodebuild test` reports mass `XCTWaiter` crashes or one session's result contradicts another's; or when the disk fills (No space left on device, System Data growing). Checking app behaviour on the simulator → simulator-runtime-verification.
wei18/apple-dev-skills · ★ 18 · AI & Automation · score 80
Install: claude install-skill wei18/apple-dev-skills
# Parallel-Agent Xcode Hygiene Rules for an agent that builds, tests or runs an Apple app on a Mac where other agent sessions do the same at the same time. Each rule removes one way that sessions collide: a shared simulator, a shared build folder, an unbounded build, or disk that nobody frees. The rules are written for git worktrees, one per session, but apply to any shared checkout. These rules stop the agent's own default actions (build here, use the booted simulator, open the project), so no user request names them. Copy the lines in "Adopt in your project" into the project's always-loaded instructions file so they hold even when this skill is not loaded. Thresholds are parameters. The worked examples come from one 8-core Mac with a 228 GB disk; set your own numbers. ## When to invoke - You are about to run `xcodebuild build` or `xcodebuild test`, or `tuist generate`, in a git worktree or on a Mac where other agent sessions run. - You are about to create, boot, erase or pick a simulator. - You must decide whether to build or test locally or leave it to CI. - `xcodebuild test` reports hundreds of `Crash: <App> at XCTWaiter` failures, or a test result disagrees with the same test in another session. - The disk is nearly full, a build fails with `No space left on device`, or macOS shows System Data growing. - You are about to delete DerivedData, a worktree, or a simulator. ## Scope Owns: resource ownership between sessions on one Mac (simulators, DerivedData, wor