Apple Development Foundation
Agent playbook for reusable Codex skills, XcodeBuildMCP, Maestro, and verification on Apple platforms.
For coding agents and Apple developers. This site is the playbook for reusable Codex skills, XcodeBuildMCP, Maestro, and verification on iOS 17+ and macOS 14+. Use it to install skills, route work, bootstrap consumer apps, and verify changes — not to expand this repository’s archived Swift package.
I want to…
| Goal | Start here |
|---|---|
| Install skills and open a first verified session | Quickstart |
| Bootstrap a new iOS/macOS SwiftUI app | Bootstrap · $apple-development-foundation → $codex-bootstrap |
| Add agent rules to my Swift app | AGENTS.md template |
| Follow the full agent session loop | Session workflow |
| Choose the right skill for a task | Skill routing · $apple-development-foundation |
| Run a common scenario end-to-end | Task recipes |
| Tabs, design tokens, or reusable components | Task recipes — reusable UI · Skills inventory |
| Shared SPM module or extract proven code | Task recipes — modules |
| Review concurrency, a11y, or security | Reviews and quality |
| Unit-test or UI-regression an app | Testing · Maestro |
| Author or update skills in this repo | Authoring skills |
| Unblock install, MCP, simulator, or Maestro failures | Troubleshooting |
| Paste a structured session prompt | Copy-paste prompts |
Core rules (do not skip)
- Skills apply to the consumer workspace (the app the user is building), not this repo’s archived modules — Consumer workspace.
- Ordinary skill routing is not an audit, installer run, or full-repo scan — Skill routing.
- Keep skills neutral: no business models, branding, secrets, user-specific paths, or hidden network behavior.
- Prefer Swift 6, SwiftUI, structured concurrency, focused views; no view model without a state-ownership or testability reason.
- Shared SwiftUI must support Dynamic Type, VoiceOver, keyboard, contrast, Reduce Motion, Differentiate Without Color, and labels for icon-only controls.
- Never log credentials, tokens, private content, raw imports, complete sensitive paths, or security-scoped URLs.
Always-on rules for work in this repository: root AGENTS.md.
What lives where
| Path | Status | Purpose |
|---|---|---|
.agents/skills/ |
Live | Source-controlled Codex skills (the product) |
MCP.md |
Live | XcodeBuildMCP and command reference |
AGENTS.md |
Live | Always-on agent rules for this repo |
docs/ (this site) |
Live | Agent playbook (Blume) |
Scripts/, Templates/ |
Live | Framework tooling plus skill and consumer templates |
archive/ |
Archived | Exploratory Swift package, demos, old website, historical package docs, and their tooling |
Site map
| Section | Contents |
|---|---|
| Quickstart | Install, MCP, first session |
| Workflow | Loop, routing, consumer workspace, AGENTS.md template, recipes |
| Skills | Inventory and major flows |
| Tools | XcodeBuildMCP, Maestro, scripts |
| Reference | Prompts, verification matrix, troubleshooting, external skills |