apple-project-workflows

Maintain the Swift package, Make targets, macOS app bundle assembly, rename/icon helpers, disabled CI examples and policy, signing capabilities, and build-source contract.

Jump to install

Repository: rcarmo/swift-app-template
Last source activity: August 29, 2026 at 10:00
Detected SKILL.md language: English
Stars: 3
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/rcarmo/swift-app-template --skill apple-project-workflows

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Apple project workflows

Read Package.swift, Makefile, .github/workflows/, scripts, and references/project-contract.md. Use for targets, dependencies, deployment versions, bundle metadata, entitlements, build scripts, rename/icon changes, or CI policy.

Source-of-truth contract

Package.swift defines the AppCore library, Starter executable, deployment version, and tests.

Resources/Info.plist and Config/Starter.entitlements define macOS bundle metadata and capabilities.

scripts/build-macos-app.sh assembles and signs the SwiftPM executable as a macOS .app; release mode also preserves private symbols, strips the copied Mach-O, and verifies hardening.

Makefile is the documented front door.

No Xcode project, XcodeGen, xcodebuild, or package-manager bootstrap is part of the build contract.

Workflow

Identify which source of truth owns the requested change.

Keep reusable code in AppCore and scene/process ownership in the executable target.

Build/test with SwiftPM before assembling the app bundle.

Update metadata, entitlements, rename/icon/static-check scripts together.

Run a rename simulation in a disposable copy after template-identity changes.

Update README, AGENTS, docs, skills, and workflows together.

Run make validate, make workflow-test, SwiftPM tests/build, macOS bundle assembly, and make hardening-check as the host permits; distinguish their evidence.

Guardrails

Do not add an Xcode project or a speculative iPadOS target before that product phase exists.

Do not commit build output, profiles, certificates, keychains, or secrets.

Keep scripts compatible with macOS system Bash.

Sign the complete .app; permissions/TCC attach to bundle identity rather than the raw SwiftPM executable.

Entitlements are minimal by default; each capability needs product justification and a denied/restricted path.

GitHub Actions remain permanently disabled in this template; keep every workflow example suffixed .disabled and reject active .yml/.yaml files.

Report SwiftPM compilation, app assembly, launch, signing, and notarisation as distinct checks.