swift-package-build-run-workflow

To build and run a Swift package, invoke this workflow to validate `Package.swift` and plan the appropriate `swift build` or `swift run` commands. It enforces a SwiftPM-first policy, ensuring execution stays within the Swift Package Manager ecosystem.

SwiftPM handles resources and Metal packaging by providing guidance for utilizing `Bundle.module` and structuring Metal artifacts within the package manifest. This workflow integrates reference documentation to ensure accurate implementation of these resource components.

SwiftPM execution works in mixed-root repositories containing Xcode markers by automatically handing off to Xcode-aware workflows. This default behavior can be overridden by explicitly opting in to SwiftPM-first execution via configuration flags.

Your Swift package build triggers Xcode-managed behavior because the workflow detects Xcode project markers in the repository root and automatically hands off execution. To prevent this and maintain SwiftPM-first execution, you must explicitly opt-in using mixed-root flags.

You can use a lightweight YAML configuration file to customize per-skill build policies. This configuration allows specific overrides while preserving the fixed SwiftPM-first execution policy for validating and running your Swift package.