# IOS Kit

> Startup runbook for iOS projects. Establishes stack decisions, scaffolds the project, configures GitHub security, and confirms governing constraints. Use when this capability is needed.

- Skill: `tomevault-io/ios-kit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ios-kit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ios-kit/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ios-kit

---


## 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 build` succeeds with zero warnings
- `xcodebuild test` passes all tests
- `./scripts/lint.sh` reports zero violations
- `./scripts/format.sh` makes 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)**

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/edfenton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

