Use when ANY iOS build fails, test crashes, Xcode misbehaves, or environment issue occurs before debugging code. Covers build failures, compilation errors, dependency conflicts, simulator problems, environment-first diagnostics.
View on GitHubSelect agents to install to:
npx add-skill https://github.com/CharlesWiltgen/Axiom/blob/main/.claude-plugin/plugins/axiom/skills/axiom-ios-build/SKILL.md -a claude-code --skill axiom-ios-buildInstallation paths:
.claude/skills/axiom-ios-build/# iOS Build & Environment Router **You MUST use this skill for ANY build, environment, or Xcode-related issue before debugging application code.** ## When to Use Use this router when you encounter: - Build failures (`BUILD FAILED`, compilation errors, linker errors) - Test crashes or hangs - Simulator issues (won't boot, device errors) - Xcode misbehavior (stale builds, zombie processes) - Dependency conflicts (CocoaPods, SPM) - Build performance issues (slow compilation) - Environment issues before debugging code ## Routing Logic This router invokes specialized skills based on the specific issue: ### 1. Environment-First Issues → **xcode-debugging** **Triggers**: - `BUILD FAILED` without obvious code cause - Tests crash in clean project - Simulator hangs or won't boot - "No such module" after SPM changes - Zombie `xcodebuild` processes - Stale builds (old code still running) - Clean build differs from incremental build **Why xcode-debugging first**: 90% of mysterious issues are environment, not code. Check this BEFORE debugging code. **Invoke**: `/skill axiom-xcode-debugging` --- ### 2. Slow Builds → **build-performance** **Triggers**: - Compilation takes too long - Type checking bottlenecks - Want to optimize build time - Build Timeline shows slow phases **Invoke**: `/skill axiom-build-performance` --- ### 3. SPM Dependency Conflicts → **spm-conflict-resolver** (Agent) **Triggers**: - SPM resolution failures - "No such module" after adding package - Duplicate symbol linker errors - Version conflicts between packages - Swift 6 package compatibility issues - Package.swift / Package.resolved conflicts **Why spm-conflict-resolver**: Specialized agent that analyzes Package.swift and Package.resolved to diagnose and resolve Swift Package Manager conflicts. **Invoke**: Launch `spm-conflict-resolver` agent --- ### 4. Security & Privacy Audit → **security-privacy-scanner** (Agent) **Triggers**: - App Store submission prep - Privacy Manifest requirements (i