Xcode App Project Workflow

Purpose

Use this skill as the top-level entry point for Apple and Swift execution work in or around Xcode. The skill guides agent-side tool use and applies the shared simplicity-first Swift policy, while scripts/run_workflow.py enforces local policy, mutation guards, advisory cooldown behavior, and structured fallback planning. New layers and dependencies are often unnecessary and need extra review; keep this workflow focused on execution rather than broadening it back into docs-management or repo-sync responsibilities. Codex Plugin and Claude Code Plugin installs for the bundled Apple skill set are now the preferred install path going forward.

When To Use

• Use this skill for Xcode workspace inspection, read or search, diagnostics, build, test, and run tasks.
• Use this skill for Swift toolchain checks and official Apple CLI fallback.
• Use this skill when direct filesystem mutation in an Xcode-managed scope may be required.
• Use this skill after Apple or Swift docs have already been gathered through explore-apple-swift-docs and the work has shifted into execution or implementation.
• Recommend explore-apple-swift-docs when the user needs Apple or Swift documentation lookup, source selection, Dash compatibility, or docs install follow-up rather than execution work.
• Recommend swift-style-tooling-workflow when the user needs to integrate or maintain SwiftLint or SwiftFormat across CLI, Xcode, SwiftPM, Git hooks, GitHub Actions, or SwiftFormat config export rather than active Xcode execution work.
• Recommend bootstrap-swift-package when the user needs to create a brand new Swift package rather than work inside an existing Xcode or Swift project.
• Recommend sync-xcode-project-guidance when an existing Xcode app repo needs AGENTS.md or workflow-guidance alignment rather than active engineering work.
• Mention that older references to apple-xcode-workflow now map to xcode-app-project-workflow.
• Mention that Codex Plugin or Claude Code Plugin installs are the preferred install path going forward.