Purpose
Initialize a new iOS project with the standard stack, scaffolding, GitHub security, and constraints.
Input: <app-name> (optional, default: "App")
Startup sequence (execute in order)
1. Confirm stack decisions
Execute /ios-stack to establish platform choices, architecture, environment model, and quality posture.
2. Scaffold the project
Execute /ios-scaffold <app-name> [--github] to create a buildable baseline with offline-first storage, push plumbing (stubbed), tooling, and CI.
Verify the scaffold passes all quality gates before proceeding (build, tests, lint, format).
3. Set up local Git hooks
Execute /github-hooks --platform ios to install Git hooks for pre-commit validation (SwiftLint, SwiftFormat, secrets), commit message enforcement, and pre-push tests.
4. Configure GitHub security (if --github was used)
Execute /github-secure to apply branch protection, Dependabot, CodeQL (Swift), CODEOWNERS, SECURITY.md, PR templates, and security workflows.
5. Verify constraints are active
Confirm these always-on skills are enabled:
- •
ios-sec— security policy - •
ios-nfr— non-functional requirements - •
ios-std— coding standards - •
ios-styleguide— design/UX standards
Quality workflows (invoke as needed)
- •
/ios-unit-test— run tests, report failures, fix with approval - •
/ios-code-review— review against policies, fix with approval - •
/ios-design-review— visual review of screens, fix with approval
Additional workflows (invoke as needed)
- •
/ios-add-feature— scaffold new features - •
/ios-add-auth— add authentication - •
/ios-deps— dependency management - •
/ios-release— App Store release preparation - •
/ios-teardown— tear down project (reverse of/ios-kit)
Ready state
After completing the startup sequence, the project is ready to develop when ALL of these pass:
- •
xcodebuild buildsucceeds with zero warnings - •
xcodebuild testpasses all tests - •
./scripts/lint.shreports zero violations - •
./scripts/format.shmakes no changes - •Git hooks are installed and functional (pre-commit, commit-msg, pre-push)
- •CI passes on first push (if --github)
If any gate fails, fix before proceeding to feature development.
Output
After running this kit, confirm:
- •Stack decisions applied
- •Project scaffolded and building
- •Local Git hooks installed (pre-commit, commit-msg, pre-push)
- •GitHub security configured (if --github)
- •Governing constraints active
- •Quality workflows available
- •Ready state achieved (all gates passing)