parallel-agent-xcode-hygienelisted
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