Bootstrap

Scaffold a new iOS or macOS SwiftUI app in the consumer workspace with codex-bootstrap.

Invoke $apple-development-foundation (routes to $codex-bootstrap) when starting a new iOS/macOS SwiftUI project or major feature set in the consumer workspace. You may also invoke $codex-bootstrap directly when the bootstrap skill is already selected.

When not to use

• One-off screens or copy tweaks → $swiftui-component-author (or smaller skills)
• Editing this repo’s archive/Sources/ → only if the user explicitly asks
• Planning-only requests → $apple-platform-planner without writing files
• Unclear consumer path → stop and ask which app/repo to bootstrap

Skill chain (in order; skip what does not apply)

1. $apple-platform-planner — broad multi-feature or multi-platform scope
2. $swiftui-tab-navigation — multiple persistent peer destinations
3. $apple-design-system — tokens, appearance, contrast, motion
4. $swiftui-component-author — reusable components on that system
5. $ios-macos-platform-adaptation — when platforms diverge
6. $swift-concurrency-review — after async/actor code exists
7. $apple-security-privacy-review — files, logging, permissions, imports
8. $apple-accessibility-review — shared UI components
9. $swift-testing-verification — before calling bootstrap complete

Extraction of proven app code → $reusable-code-extractor into the consumer’s shared module, not into this foundation repo.

Skeleton expectations

• Inspect root and scoped consumer AGENTS.md files before writing
• Preserve existing instructions; propose a merge and wait for explicit authorization
• If no file exists and creation is authorized, initialize from the portable assets/consumer-AGENTS.md.template skill asset, preview with ./Scripts/init-consumer-guidance.sh --target <consumer> --dry-run, or copy from AGENTS.md template
• Never modify global ~/.codex/AGENTS.md
• SwiftUI @main entry with a single root shell
• Native primary navigation only when the user listed multiple peer destinations
• Platform-appropriate layout (Xcode project or SPM + app target)
• Stub feature areas — no invented business domain unless the user supplied it
• Design system lives in the consumer repo if needed
• Do not copy or rebuild modules from this repo’s archive/Sources/

Verification (XcodeBuildMCP)

1. session_show_defaults; report project/workspace, scheme, configuration, and platform destination (then session_set_defaults if needed)
2. discover_projs only if defaults are still wrong/missing
3. iOS simulator: prefer build_run_sim; wait for same-project test runners; run test_sim without a redundant build and default to extraArgs: ["-parallel-testing-enabled", "NO"]
4. macOS: enable the macos workflow; prefer build_run_macos for launch smoke; run test_macos when tests exist (same parallel-testing default). If neither launch smoke nor tests run, require at least build_macos. Do not use test_sim or ui-automation tools — they are iOS-simulator-only
5. Optional iOS-only: screenshot / snapshot_ui

If MCP is unavailable, use the XcodeBuildMCP CLI only when active policy explicitly permits it. Use repository-native raw Apple tooling only when active policy authorizes it and obtain approval when required. Otherwise report blocked. Preserve project/workspace, scheme, configuration, exact destination, serialized test scope, commands/tools, and residual risk through every authorized fallback.

Existing consumer instructions

$codex-bootstrap treats consumer guidance as user-owned. It may inspect and summarize an existing AGENTS.md, but it does not replace, append, or merge it silently. If baseline sections are missing, the skill proposes the specific merge and waits for authorization. If guidance edits are declined, bootstrap continues under the existing contract when the rest of the requested work is still clear.

Copy-paste prompt

Structured bootstrap prompt: Copy-paste prompts. Recipe: Task recipes.